AbstractPreferences

lock

Object lock

其监视器用于锁定此节点的对象。 此对象优先于节点本身使用，以减少由于锁定的节点而导致有意或无意拒绝服务的可能性。 为避免死锁，一个节点永远不会被一个在该节点的后代拥有一个锁的线程锁定。

newNode

boolean newNode

如果此节点在创建此对象之前不存在于后备存储中，则此字段应为true 。 该字段初始化为false，但可以通过子类构造函数将其设置为true（并且此后不应修改）。 该字段指示创建完成时是否应激发节点更改事件。

AbstractPreferences

AbstractPreferences (AbstractPreferences parent, 
                String name)

使用指定的父项和指定的名称相对于其父项创建首选项节点。

absolutePath

String absolutePath ()

实现 absolutePath方法按照在本说明书中 absolutePath() 。

该实现仅返回在构造此节点时计算的绝对路径名（基于传递给此节点的构造函数的名称以及传递给此节点的祖先构造函数的名称）。

addNodeChangeListener

void addNodeChangeListener (NodeChangeListener ncl)

注册指定的侦听器以接收此节点的节点更改事件 。 将子节点添加到此节点或从中删除时，会生成节点更改事件。 （单个removeNode()调用会导致多个节点更改事件 ，其中一个用于以已除去节点为根的子树中的每个节点。）

事件只能保证在与注册监听器相同的JVM中进行的更改，尽管某些实现可能会生成事件以便在此JVM之外进行更改。 事件可能会在更改变为永久之前生成。 当添加或删除此节点的间接后代时，不会生成事件; 希望发生此类事件的来电者必须向每个后代登记。

几乎没有关于节点创建的保证。 由于节点是在访问时隐式创建的，因此实现可能无法确定子节点在访问之前是否存在于后备存储中（例如，因为后备存储无法访问或缓存的信息已过期）。 在这些情况下，实现既不需要生成节点更改事件也不被禁止。

addPreferenceChangeListener

void addPreferenceChangeListener (PreferenceChangeListener pcl)

注册指定的侦听器以接收此首选项节点的首选项更改事件 。 当首选项添加到此节点，从此节点中删除或与首选项关联的值发生更改时，会生成首选项更改事件。 （偏好改变事件不会由所产生的removeNode()方法，该方法生成事件 。优选变化事件是由clear方法生成的节点的变化 。）

事件只能保证在与注册监听器相同的JVM中进行的更改，尽管某些实现可能会生成事件以便在此JVM之外进行更改。 事件可能在变更持续之前生成。 在此节点的后代中修改首选项时不会生成事件; 希望发生此类事件的来电者必须向每个后代登记。

childrenNames

String[] childrenNames ()

实现 children方法按照在本说明书中 childrenNames() 。

此实现获取此首选项节点的锁，检查该节点已不被删除，构造一个初始化为已缓存的孩子（在此节点的“子缓存”的孩子）的名称的TreeSet，调用childrenNamesSpi() ，并将所有返回的子集名称。 使用toArray方法将树集的元素转储到String数组中，并返回该数组。

clear

void clear ()

实现 clear方法按照在本说明书中 clear() 。

这个实现获得了这个首选节点的锁，调用 keys()来获得一个键数组，并遍历每个键调用 remove(String)的数组。

exportNode

void exportNode (OutputStream os)

实现 exportNode方法按照在本说明书中 exportNode(OutputStream) 。

exportSubtree

void exportSubtree (OutputStream os)

实现 exportSubtree方法按照在本说明书中 exportSubtree(OutputStream) 。

flush

void flush ()

实现 flush方法按照在本说明书中 flush() 。

这个实现调用一个递归辅助方法来锁定这个节点，在其上调用flushSpi（），解锁这个节点，并递归地在每个“缓存的孩子”上调用这个方法。 高速缓存的子项是此虚拟机中创建的此节点的子项，随后不会被删除。 实际上，此方法首先对以此节点为根的“缓存子树”进行深度优先遍历，并在子树中的每个节点上调用flushSpi（），同时仅锁定该节点。 请注意，flushSpi（）是自顶向下调用的。

如果在使用 removeNode()方法删除的节点上调用此方法，则会在此节点上调用flushSpi（），但在其他节点上调用flushSpi（）。

get

String get (String key, 
                String def)

实现 get方法按照在本说明书中 get(String, String) 。

此实现首先检查是否key是null扔NullPointerException，如果是这种情况。 然后它获得这个首选节点的锁，检查节点没有被移除，调用getSpi(String) ，并返回结果，除非getSpi调用返回null或引发异常，在这种情况下，此调用返回def 。

getBoolean

boolean getBoolean (String key, 
                boolean def)

实现 getBoolean方法按照在本说明书中 getBoolean(String, boolean) 。

该实现调用get(key, null) 。 如果返回值非空，则使用equalsIgnoreCase(String)将其与"true"进行equalsIgnoreCase(String) 。 如果比较返回true ，则此调用返回true 。 否则，将原始返回值与"false"进行比较，再次使用equalsIgnoreCase(String) 。 如果比较返回true ，则此调用返回false 。 否则，该调用返回def 。

getByteArray

byte[] getByteArray (String key, 
                byte[] def)

实现 getByteArray方法按照在本说明书中 getByteArray(String, byte[]) 。

getDouble

double getDouble (String key, 
                double def)

实现 getDouble方法按照在本说明书中 getDouble(String, double) 。

该实现调用get(key, null) 。 如果返回值非空，则实现尝试将其转换为101728179137877 ， parseDouble(String)其转换为parseDouble(String) 。 如果尝试成功，则返回值由此方法返回。 否则，返回def 。

getFloat

float getFloat (String key, 
                float def)

实现 getFloat方法按照在本说明书中 getFloat(String, float) 。

该实现调用get(key, null) 。 如果返回值非空，则实现尝试将其转换为float ， parseFloat(String)其转换为parseFloat(String) 。 如果尝试成功，则返回值由此方法返回。 否则，返回def 。

getInt

int getInt (String key, 
                int def)

实现 getInt方法按照在本说明书中 getInt(String, int) 。

该实现调用get(key, null) 。 如果返回值非空，则实现将尝试将其转换为int和parseInt(String) 。 如果尝试成功，则返回值由此方法返回。 否则，返回def 。

getLong

long getLong (String key, 
                long def)

实现 getLong方法按照在本说明书中 getLong(String, long) 。

该实现调用get(key, null) 。 如果返回值非空，则实现尝试将其转换为long ， parseLong(String)其转换为parseLong(String) 。 如果尝试成功，则返回值由此方法返回。 否则，返回def 。

isUserNode

boolean isUserNode ()

实现 isUserNode方法按照在本说明书中 isUserNode() 。

此实现将此节点的根节点（存储在专用字段中）与由userRoot()返回的值进行userRoot() 。 如果两个对象引用是相同的，则此方法返回true。

keys

String[] keys ()

实现 keys方法按照在本说明书中 keys() 。

此实现获取此首选项节点的锁定，检查该节点是否未被删除并调用 keysSpi() 。

name

String name ()

实现 name方法按照在本说明书中 name() 。

该实现仅返回传递给此节点构造函数的名称。

node

Preferences node (String path)

实现 node方法按照在本说明书中 node(String) 。

此实现获取此首选节点的锁并检查该节点是否未被删除。 如果path是"" ，则返回此节点; 如果path是"/" ，则返回此节点的根。 如果path中的第一个字符不是'/' ，则实现将path分解为令牌，并递归遍历从此节点到命名节点的路径，在遍历的每一步中“消耗”来自path的名称和斜杠。 在每个步骤中，当前节点被锁定，并检查节点的子缓存中的指定节点。 如果未找到，则检查名称以确保其长度不超过MAX_NAME_LENGTH 。 然后调用childSpi(String)方法，并将结果存储在此节点的子缓存中。 如果新创建的Preferences对象的newNode字段为true，并且存在任何节点更改侦听器，则通知事件将被排队以供事件分派线程处理。

当没有更多的标记时，通过此方法返回在子缓存中找到的或由childSpi返回的最后一个值。 如果在遍历期间，两个"/"令牌连续出现，或者最后的令牌是"/" （而不是名称），则会引发相应的IllegalArgumentException 。

如果path的第一个字符是'/' （表示绝对路径名），则在将path分解为令牌之前先删除此首选节点的锁，并且此方法递归遍历从根开始的路径（而不是从此节点开始）。 否则，遍历与相对路径名描述的相同。 根据locking invariant ，在根节点开始遍历之前丢弃此节点上的锁对于避免死锁的可能性locking invariant 。

nodeExists

boolean nodeExists (String path)

实现 nodeExists方法按照在本说明书中 nodeExists(String) 。

该实现与 node(String)非常相似，不同之 getChild(String)在于使用 childSpi(String)而不是 childSpi(String) 。

parent

Preferences parent ()

实现 parent方法按照在本说明书中 parent() 。

此实现获取此首选项节点的锁定，检查该节点是否未被删除并返回传递给此节点构造函数的父值。

put

void put (String key, 
                String value)

实现 put方法按照在本说明书中 put(String, String) 。

此实现将检查键和值是否合法，获取此首选项节点的锁定，检查节点是否未被删除，调用 putSpi(String, String) ，如果有任何首选项更改侦听器，则将事件分派线程处理的通知事件排入队列。

putBoolean

void putBoolean (String key, 
                boolean value)

实现 putBoolean方法按照在本说明书中 putBoolean(String, boolean) 。

该实现将 value转换为包含 valueOf(boolean)的字符串， valueOf(boolean)结果调用 put(String, String) 。

putByteArray

void putByteArray (String key, 
                byte[] value)

实现 putByteArray方法按照在本说明书中 putByteArray(String, byte[]) 。

putDouble

void putDouble (String key, 
                double value)

实现 putDouble方法按照在本说明书中 putDouble(String, double) 。

该实现将 value转换为 toString(double)的字符串， toString(double)结果调用 put(String, String) 。

putFloat

void putFloat (String key, 
                float value)

实现 putFloat方法按照在本说明书中 putFloat(String, float) 。

该实现将 value转换为包含 toString(float)的字符串， toString(float)结果调用 put(String, String) 。

putInt

void putInt (String key, 
                int value)

实现 putInt方法按照在本说明书中 putInt(String, int) 。

该实现将 value转换为一个包含 toString(int)的字符串， toString(int)结果调用 put(String, String) 。

putLong

void putLong (String key, 
                long value)

实现 putLong方法按照在本说明书中 putLong(String, long) 。

该实现将 value转换为 toString(long)的字符串， toString(long)结果调用 put(String, String) 。

remove

void remove (String key)

实现 remove(String)方法按照在本说明书中 remove(String) 。

此实现获取此首选项节点的锁定，检查该节点是否未被删除，调用 removeSpi(String)并且是否有任何首选项更改侦听器将事件分派线程处理的通知事件排入队列。

removeNode

void removeNode ()

实现 removeNode()方法按照在本说明书中 removeNode() 。

该实现检查以查看该节点是根节点; 如果是这样，它会抛出一个适当的异常。 然后，它锁定该节点的父节点，并调用遍历以此节点为根的子树的递归辅助方法。 递归方法锁定被调用的节点，检查它是否已被删除，然后确保其所有子childrenNamesSpi()都被缓存：调用childrenNamesSpi()方法，并检查每个返回的子childrenNamesSpi()名称是否包含在子childrenNamesSpi()中，缓存。 如果孩子尚未被缓存，则会调用childSpi(String)方法为其创建一个Preferences实例，并将此实例放入子缓存中。 然后，辅助方法在包含在其子缓存中的每个节点上递归地调用它自己。 接下来，它调用removeNodeSpi() ，将自己标记为已删除，并将其本身从其父级的子级高速缓存中移除。 最后，如果有任何节点更改侦听器，它会排队通知事件以供事件分派线程处理。

请注意，辅助方法始终在所有祖先锁定为“最近的未删除祖先”的情况下调用。

removeNodeChangeListener

void removeNodeChangeListener (NodeChangeListener ncl)

删除指定的 NodeChangeListener ，因此它不再收到更改事件。

removePreferenceChangeListener

void removePreferenceChangeListener (PreferenceChangeListener pcl)

删除指定的首选项更改侦听器，使其不再接收首选项更改事件。

sync

void sync ()

实现 sync方法按照在本说明书中 sync() 。

这个实现调用一个递归辅助方法来锁定这个节点，在其上调用syncSpi（），解锁这个节点，并递归地在每个“缓存的孩子”上调用这个方法。 高速缓存的子项是此虚拟机中创建的此节点的子项，随后不会被删除。 实际上，此方法首先对以此节点为根的“缓存子树”进行深度优先遍历，并在子树中的每个节点上调用syncSpi（），而只锁定该节点。 请注意，syncSpi（）是自顶向下调用的。

toString

String toString ()

返回此首选项节点的绝对路径名称。

cachedChildren

AbstractPreferences[] cachedChildren ()

返回此节点的所有已知未清除的子节点。

childSpi

AbstractPreferences childSpi (String name)

返回此首选项节点的命名子节点，如果它尚不存在，则创建它。 确保name非空，非空，不包含斜杠字符（'/'），并且不超过MAX_NAME_LENGTH字符。 另外，保证这个节点还没有被移除。 （实现者不需要检查任何这些东西。）

最后，保证指定节点在上次调用此方法或getChild(String)后最后一次调用时未被返回。 换句话说，缓存的值将始终用于优先于调用此方法。 子类不需要维护它们自己的先前返回的子项的缓存。

实施者必须确保返回的节点没有被移除。 如果之前删除了此节点的相似名称的子节点，那么实施者必须返回一个新构建的节点AbstractPreferences ; 一旦移除， AbstractPreferences节点不能“复苏”。

如果此方法导致创建节点，则在该节点或其祖先（或后代）之一调用 flush方法之前，该节点不能保证持久性。

该方法通过保持该节点上的锁来调用。

childrenNamesSpi

String[] childrenNamesSpi ()

返回此首选项节点的子项名称。 （如果此节点没有子节点，则返回的数组的大小为零）。此方法不需要返回已缓存的任何节点的名称，但可以毫无损坏地返回。

该方法通过保持该节点上的锁来调用。

如果此节点抛出 BackingStoreException ，则该异常将传出超出封闭的 childrenNames()调用。

flushSpi

void flushSpi ()

此方法在此节点被锁定时调用。 此方法的契约是强制将此首选项节点的内容中的任何缓存更改强制到后备存储，以确保其持久性。 （这是完全可能的是，该节点上不后备存储器中存在，或者是因为它已被另一个VM删除，或因为它尚未被创建）。注意，在此任何子节点此方法不应冲洗喜好节点。 如果后备存储自然地一次刷新整个子树，则鼓励实施者重写flush（），而不是仅仅重写此方法。

如果此节点引发 BackingStoreException ，则该异常将传出超出封闭的 flush()调用。

getChild

AbstractPreferences getChild (String nodeName)

返回指定的子项（如果存在）;如果不存在，则返回null 。 保证nodeName非空，非空，不包含斜杠字符（'/'），并且不超过MAX_NAME_LENGTH字符。 另外，保证这个节点还没有被移除。 （如果执行者选择重写此方法，则不需要检查这些事情。）

最后，保证命名节点在上次调用此方法或childSpi(String)后最后一次调用时未被返回。 换句话说，缓存的值将始终用于优先于调用此方法。 （如果实现者选择覆盖此方法，则无需维护自己的先前返回的子项的缓存。）

此实现获取此首选节点的锁，调用childrenNames()以获取此节点的子节点的名称数组，并遍历数组，将每个子节点的名称与指定的节点名称进行比较。 如果子节点具有正确的名称，则会调用childSpi(String)方法，并返回结果节点。 如果迭代完成而没有找到指定名称，则返回null 。

getSpi

String getSpi (String key)

返回与此首选项节点上指定键相关联的值，如果此键不存在关联，则返回null ，否则此关联无法确定。 保证key非空。 另外，保证这个节点还没有被移除。 （实现者不需要检查这些事情。）

一般来说，这种方法在任何情况下都不应该抛出异常。 但是，如果它确实抛出了异常，则该异常将被拦截并视为返回值null 。

该方法通过保持该节点上的锁来调用。

isRemoved

boolean isRemoved ()

返回true如果此节点（或其祖先）已经被除去的removeNode()方法。 此方法在返回用于跟踪此状态的专用字段的内容之前锁定此节点。

keysSpi

String[] keysSpi ()

返回此首选项节点中具有关联值的所有键。 （如果此节点没有首选项，则返回的数组大小为零）。保证此节点未被删除。

该方法通过保持该节点上的锁来调用。

如果此节点引发 BackingStoreException ，则该异常将传出超出封闭的 keys()调用。

putSpi

void putSpi (String key, 
                String value)

将给定的键值关联放入此首选项节点中。 保证key和value非空和法定长度。 另外，保证这个节点还没有被移除。 （实现者不需要检查任何这些东西。）

该方法通过保持该节点上的锁来调用。

removeNodeSpi

void removeNodeSpi ()

删除此首选项节点，使其无效并包含它的任何首选项。 removeNode()此调用时，命名的子项将没有后代（即， removeNode()方法以自下而上的方式重复调用此方法，在删除节点本身之前删除每个节点的后代）。

此方法通过在此节点及其父节点（以及由于一次调用 removeNode()而被删除的所有祖先）上的锁来调用。

除非在此节点（或祖先）上调用 flush方法， 否则删除节点不需要持久化。

如果此节点引发 BackingStoreException ，则该异常将传播到封闭的 removeNode()调用之外。

removeSpi

void removeSpi (String key)

删除此首选项节点上指定键的关联（如果有）。 保证key非空。 另外，保证这个节点还没有被移除。 （实现者不需要检查这些事情。）

该方法通过保持该节点上的锁来调用。

syncSpi

void syncSpi ()

此方法在此节点被锁定时调用。 该方法的契约是将存储在此节点的所有缓存首选项与存储在后备存储中的任何缓存首选项同步。 （这是完全可能的，这点上不支持存储存在，可能是因为它已被其他虚拟机删除，或者因为它尚未创建）。注意，在这个任意子节点，此方法不应同步偏好节点。 如果后备存储自然地同步整个子树，鼓励实现者重写sync（），而不是仅仅覆盖此方法。

如果此节点引发 BackingStoreException ，则该异常将传播到封闭的 sync()调用之外。