AbstractPreferences (Платформа Java SE 8 b92)

java.lang. Объект
- java.util.prefs. Предпочтение
- - java.util.prefs. AbstractPreferences

```
public abstract class AbstractPreferences
extends Preferences
```
Этот class обеспечивает скелетную реализацию Preferences class, значительно ослабляя задачу реализации этого.
Этот class для разработчиков Preferences только. У нормальных пользователей средства Preferences не должно быть никакой потребности консультироваться с этой документацией. Preferences документация должна быть достаточной.
Конструкторы должны переопределить девять абстрактных интерфейсов поставщика услуг (SPI) методы: getSpi(String), putSpi(String,String), removeSpi(String), childSpi(String), removeNodeSpi(), keysSpi(), childrenNamesSpi(), syncSpi() и flushSpi(). Все конкретные методы определяют точно, как они реализуются на этих методах SPI. Конструктор, по его усмотрению, может переопределить один или больше конкретных методов, если реализация по умолчанию является неудовлетворительной по какой-либо причине, такой как производительность.
Методы SPI попадают в три группы относительно поведения исключения. Метод getSpi никогда не должен выдавать исключения, но он действительно не имеет значения, поскольку любое исключение, выданное этим методом, будет прервано get(String,String), который возвратит указанное значение по умолчанию вызывающей стороне. Методы removeNodeSpi, keysSpi, childrenNamesSpi, syncSpi И flushSpi определяются, чтобы бросить BackingStoreException, и реализация обязана выдавать это проверенное исключение, если это неспособно выполнить работу. Исключение распространяет исходящий, заставляя соответствующий метод API перестать работать.
Остающиеся методы SPI putSpi(String,String), removeSpi(String) и childSpi(String) более усложнили поведение исключения. Они не определяются, чтобы бросить BackingStoreException, поскольку они могут обычно повиноваться своим контрактам, даже если запоминающее устройство недоступно. Это - истина, потому что они не возвращают информации, и их эффекты не обязаны становиться постоянными до последующего звонка Preferences.flush() или Preferences.sync(). Вообще говоря, эти методы SPI не должны выдать исключения. В некоторых реализациях могут быть обстоятельства, при которых эти вызовы не могут даже ставить в очередь требуемую работу для дальнейшей обработки. Даже при этих обстоятельствах обычно лучше просто проигнорировать вызов и возврат, вместо того, чтобы выдать исключение. При этих обстоятельствах, однако, все последующие вызовы flush() и sync должны возвратить false, поскольку возврат true подразумевал бы, что все предыдущие операции были успешно сделаны постоянными.
Есть одно обстоятельство, при котором putSpi, removeSpi and childSpi должен выдать исключение: если вызывающая сторона испытывает недостаток в достаточных полномочиях на базовой операционной системе, чтобы выполнить требуемую работу. Это, например, произойдет на большинстве систем, если непривилегированный пользователь попытается изменить установки системы. (Необходимые полномочия изменятся от реализации до реализации. На некоторых реализациях они - право изменить содержание некоторого каталога в файловой системе; на других они - право изменить содержание некоторого ключа в реестре.) При любом из этих обстоятельств, это обычно был бы нежелательный, чтобы позволить программе продолжать выполняться, как будто эти операции стали бы постоянными в более позднее время. В то время как реализации не обязаны выдавать исключение при этих обстоятельствах, они поощряются сделать так. A SecurityException было бы соответствующим.
Большинство методов SPI требует, чтобы реализация считала или записала информацию в привилегированном узле. Конструктор должен остерегаться факта, что другой VM, возможно, одновременно удалил этот узел из запоминающего устройства. Это - обязанность реализации воссоздать узел, если это было удалено.
Примечание реализации: В значении по умолчанию Sun реализации Preferences идентификационные данные пользователя наследованы от базовой операционной системы и не изменяются для времени жизни виртуальной машины. Это распознается, что у стороны сервера реализации Preferences может быть пользовательское изменение идентификационных данных от запроса до запроса, который неявно передают к методам Preferences через использование помех ThreadLocal экземпляр. Авторы таких реализаций строго поощряются определить пользователя в то время, когда к предпочтению получают доступ (например get(String,String) или put(String,String) метод) вместо того, чтобы постоянно связать пользователя с каждым экземпляром Preferences. Последние конфликты поведения с нормальным использованием Preferences и привели бы к большому беспорядку.

С тех пор:

1.4

См. Также:

Preferences

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected Object`	`блокировка` Объект, монитор которого используется, чтобы заблокировать этот узел.
`protected boolean`	`newNode` Этим полем должен быть `true`, если бы этот узел не существовал в запоминающем устройстве до создания этого объекта.

Поля, наследованные от class java.util.prefs. Предпочтение
MAX_KEY_LENGTH, MAX_NAME_LENGTH, MAX_VALUE_LENGTH

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`AbstractPreferences(AbstractPreferences parent, String name)` Создает привилегированный узел с указанным родителем и указанным именем относительно его родителя.

Сводка метода

Все Методы Методы экземпляра Абстрактные Методы Конкретные Методы
Модификатор и Тип	Метод и Описание
`Строка`	`absolutePath()` Реализует метод `absolutePath` согласно спецификации в `Preferences.absolutePath()`.
`void`	`addNodeChangeListener(NodeChangeListener ncl)` Регистрирует указанного слушателя, чтобы получить события изменения узла для этого узла.
`void`	`addPreferenceChangeListener(PreferenceChangeListener pcl)` Регистрирует указанного слушателя, чтобы получить привилегированные события изменения для этого привилегированного узла.
`protected AbstractPreferences[]`	`cachedChildren()` Возвраты все известные неудаленные дочерние элементы этого узла.
`Строка[]`	`childrenNames()` Реализует метод `children` согласно спецификации в `Preferences.childrenNames()`.
`protected abstract String[]`	`childrenNamesSpi()` Возвращает имена дочерних элементов этого привилегированного узла.
`protected abstract AbstractPreferences`	`childSpi(String name)` Возвращает именованный дочерний элемент этого привилегированного узла, создавая это, если это уже не существует.
`void`	`clear()` Реализует метод `clear` согласно спецификации в `Preferences.clear()`.
`void`	`exportNode(OutputStream os)` Реализует метод `exportNode` согласно спецификации в `Preferences.exportNode(OutputStream)`.
`void`	`exportSubtree(OutputStream os)` Реализует метод `exportSubtree` согласно спецификации в `Preferences.exportSubtree(OutputStream)`.
`void`	`flush()` Реализует метод `flush` согласно спецификации в `Preferences.flush()`.
`protected abstract void`	`flushSpi()` Этот метод вызывается с этим заблокированным узлом.
`Строка`	`get(String key, String def)` Реализует метод `get` согласно спецификации в `Preferences.get(String,String)`.
`boolean`	`getBoolean(String key, boolean def)` Реализует метод `getBoolean` согласно спецификации в `Preferences.getBoolean(String,boolean)`.
`byte[]`	`getByteArray(String key, byte[] def)` Реализует метод `getByteArray` согласно спецификации в `Preferences.getByteArray(String,byte[])`.
`protected AbstractPreferences`	`getChild(String nodeName)` Возвращает именованный дочерний элемент, если это существует, или `null`, если это не делает.
`double`	`getDouble(String key, double def)` Реализует метод `getDouble` согласно спецификации в `Preferences.getDouble(String,double)`.
`float`	`getFloat(String key, float def)` Реализует метод `getFloat` согласно спецификации в `Preferences.getFloat(String,float)`.
`int`	`getInt(String key, int def)` Реализует метод `getInt` согласно спецификации в `Preferences.getInt(String,int)`.
`long`	`getLong(String key, long def)` Реализует метод `getLong` согласно спецификации в `Preferences.getLong(String,long)`.
`protected abstract String`	`getSpi(String key)` Возвратите значение, связанное с указанным ключом в этом привилегированном узле, или `null`, если нет никакой ассоциации для этого ключа, или ассоциация не может быть определена в это время.
`protected boolean`	`isRemoved()` Возвраты эквивалентность `true` этот узел (или предок) были удалены с `removeNode()` метод.
`boolean`	`isUserNode()` Реализует метод `isUserNode` согласно спецификации в `Preferences.isUserNode()`.
`Строка[]`	`keys()` Реализует метод `keys` согласно спецификации в `Preferences.keys()`.
`protected abstract String[]`	`keysSpi()` Возвраты все ключи, у которых есть присваиваемое значение в этом привилегированном узле.
`Строка`	`name()` Реализует метод `name` согласно спецификации в `Preferences.name()`.
`Предпочтение`	`node(String path)` Реализует метод `node` согласно спецификации в `Preferences.node(String)`.
`boolean`	`nodeExists(String path)` Реализует метод `nodeExists` согласно спецификации в `Preferences.nodeExists(String)`.
`Предпочтение`	`parent()` Реализует метод `parent` согласно спецификации в `Preferences.parent()`.
`void`	`put(String key, String value)` Реализует метод `put` согласно спецификации в `Preferences.put(String,String)`.
`void`	`putBoolean(String key, boolean value)` Реализует метод `putBoolean` согласно спецификации в `Preferences.putBoolean(String,boolean)`.
`void`	`putByteArray(String key, byte[] value)` Реализует метод `putByteArray` согласно спецификации в `Preferences.putByteArray(String,byte[])`.
`void`	`putDouble(String key, double value)` Реализует метод `putDouble` согласно спецификации в `Preferences.putDouble(String,double)`.
`void`	`putFloat(String key, float value)` Реализует метод `putFloat` согласно спецификации в `Preferences.putFloat(String,float)`.
`void`	`putInt(String key, int value)` Реализует метод `putInt` согласно спецификации в `Preferences.putInt(String,int)`.
`void`	`putLong(String key, long value)` Реализует метод `putLong` согласно спецификации в `Preferences.putLong(String,long)`.
`protected abstract void`	`putSpi(String key, String value)` Поместите данную ассоциацию значения ключа в этот привилегированный узел.
`void`	`remove(String key)` Реализует метод `remove(String)` согласно спецификации в `Preferences.remove(String)`.
`void`	`removeNode()` Реализует метод `removeNode()` согласно спецификации в `Preferences.removeNode()`.
`void`	`removeNodeChangeListener(NodeChangeListener ncl)` Удаляет указанный `NodeChangeListener`, таким образом, он больше не получает события изменения.
`protected abstract void`	`removeNodeSpi()` Удаляет этот привилегированный узел, лишая законной силы это и любое предпочтение, которое это содержит.
`void`	`removePreferenceChangeListener(PreferenceChangeListener pcl)` Удаляет указанного привилегированного слушателя изменения, таким образом, это больше не получает привилегированные события изменения.
`protected abstract void`	`removeSpi(String key)` Удалите ассоциацию (если любой) для указанного ключа в этом привилегированном узле.
`void`	`sync()` Реализует метод `sync` согласно спецификации в `Preferences.sync()`.
`protected abstract void`	`syncSpi()` Этот метод вызывается с этим заблокированным узлом.
`Строка`	`toString()` Возвращает абсолютный путь этого привилегированного узла.

Методы, наследованные от class java.util.prefs. Предпочтение
importPreferences, systemNodeForPackage, systemRoot, userNodeForPackage, userRoot

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - newNode
```
protected boolean newNode
```
    Этим полем должен быть true, если бы этот узел не существовал в запоминающем устройстве до создания этого объекта. Поле инициализируется ко лжи, но может быть установлено в истину конструктором подкласса (и не должен быть изменен после того). Это поле указывает, должно ли событие изменения узла быть запущено, когда создание полно.
  - блокировка
```
protected final Object lock
```
    Объект, монитор которого используется, чтобы заблокировать этот узел. Этот объект используется в предпочтении к узлу непосредственно, чтобы уменьшить вероятность намеренного или неумышленного отказа службы из-за заблокированного узла. Чтобы избежать мертвой блокировки, узел никогда не блокируется потоком, который содержит блокировку на потомке того узла.
- Деталь конструктора
  - AbstractPreferences
```
protected AbstractPreferences(AbstractPreferences parent,
                              String name)
```
    Создает привилегированный узел с указанным родителем и указанным именем относительно его родителя.
    
    Параметры:
    
    parent - родитель этого привилегированного узла, или нуль, если это - корень.
    
    name - имя этого привилегированного узла, относительно его родителя, или "", если это - корень.
    
    Броски:
    
    IllegalArgumentException - если name содержит наклонную черту ('/'), или parent является null, и именем не является "".
- Деталь метода
  - поместить
```
public void put(String key,
                String value)
```
    Реализует метод put согласно спецификации в Preferences.put(String,String).
    Эта реализация проверяет, что ключ и значение являются законными, получает эту привилегированную блокировку узла, проверки, что узел не был удален, вызывают putSpi(String,String), и если есть какие-либо привилегированные слушатели изменения, ставит в очередь событие уведомления для того, чтобы обработать событием, диспетчеризируют поток.
    
    Определенный:
    
    put в class Preferences
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение.
    
    value - значение, которое будет связано с указанным ключом.
    
    Броски:
    
    NullPointerException - если ключом или значением является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH или если value.length превышает MAX_VALUE_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - добраться
```
public String get(String key,
                  String def)
```
    Реализует метод get согласно спецификации в Preferences.get(String,String).
    Эта реализация сначала проверяет, чтобы видеть, является ли key null, бросающий NullPointerException, если это верно. Затем это получает эту привилегированную блокировку узла, проверки, что узел не был удален, вызывают getSpi(String), и возвращает результат, если вызов getSpi не возвращает null или выдает исключение, когда этот вызов возвращает def.
    
    Определенный:
    
    get в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key.
    
    Возвраты:
    
    значение, связанное с key, или def, если никакое значение не связывается с key.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если ключом является null. (Значение по умолчанию null разрешается.)
  - удалить
```
public void remove(String key)
```
    Реализует метод remove(String) согласно спецификации в Preferences.remove(String).
    Эта реализация получает эту привилегированную блокировку узла, проверки, что узел не был удален, вызывают removeSpi(String) и если есть какие-либо привилегированные слушатели изменения, ставит в очередь событие уведомления для того, чтобы обработать событием, диспетчеризируют поток.
    
    Определенный:
    
    remove в class Preferences
    
    Параметры:
    
    key - ключ, отображение которого должно быть удалено из привилегированного узла.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null..
  - очистить
```
public void clear()
           throws BackingStoreException
```
    Реализует метод clear согласно спецификации в Preferences.clear().
    Эта реализация получает эту привилегированную блокировку узла, вызывает keys() получить массив ключей, и выполняет итерации по вызову массива remove(String) на каждом ключе.
    
    Определенный:
    
    clear в class Preferences
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.removeNode()
  - putInt
```
public void putInt(String key,
                   int value)
```
    Реализует метод putInt согласно спецификации в Preferences.putInt(String,int).
    Эта реализация преобразовывает value в строку с Integer.toString(int) и вызывает put(String,String) на результате.
    
    Определенный:
    
    putInt в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getInt(String,int)
  - getInt
```
public int getInt(String key,
                  int def)
```
    Реализует метод getInt согласно спецификации в Preferences.getInt(String,int).
    Эта реализация вызывает get(key, null). Если возвращаемое значение является ненулем, реализация пытается преобразовать это в int с Integer.parseInt(String). Если попытка успешно выполняется, возвращаемое значение возвращается этим методом. Иначе, def возвращается.
    
    Определенный:
    
    getInt в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как интервал.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как интервал.
    
    Возвраты:
    
    международное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как интервал.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    
    См. Также:
    
    Preferences.putInt(String,int), Preferences.get(String,String)
  - putLong
```
public void putLong(String key,
                    long value)
```
    Реализует метод putLong согласно спецификации в Preferences.putLong(String,long).
    Эта реализация преобразовывает value в строку с Long.toString(long) и вызывает put(String,String) на результате.
    
    Определенный:
    
    putLong в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getLong(String,long)
  - getLong
```
public long getLong(String key,
                    long def)
```
    Реализует метод getLong согласно спецификации в Preferences.getLong(String,long).
    Эта реализация вызывает get(key, null). Если возвращаемое значение является ненулем, реализация пытается преобразовать это в long с Long.parseLong(String). Если попытка успешно выполняется, возвращаемое значение возвращается этим методом. Иначе, def возвращается.
    
    Определенный:
    
    getLong в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как длинное.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как длинное.
    
    Возвраты:
    
    длинное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как длинное.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    
    См. Также:
    
    Preferences.putLong(String,long), Preferences.get(String,String)
  - putBoolean
```
public void putBoolean(String key,
                       boolean value)
```
    Реализует метод putBoolean согласно спецификации в Preferences.putBoolean(String,boolean).
    Эта реализация преобразовывает value в строку с String.valueOf(boolean) и вызывает put(String,String) на результате.
    
    Определенный:
    
    putBoolean в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getBoolean(String,boolean), Preferences.get(String,String)
  - getBoolean
```
public boolean getBoolean(String key,
                          boolean def)
```
    Реализует метод getBoolean согласно спецификации в Preferences.getBoolean(String,boolean).
    Эта реализация вызывает get(key, null). Если возвращаемое значение является ненулем, это по сравнению с использованием "true" String.equalsIgnoreCase(String). Если сравнение возвращает true, этот вызов возвращает true. Иначе, исходное возвращаемое значение по сравнению с "false", снова используя String.equalsIgnoreCase(String). Если сравнение возвращает true, этот вызов возвращает false. Иначе, этот вызов возвращает def.
    
    Определенный:
    
    getBoolean в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как булево.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как булево.
    
    Возвраты:
    
    булево значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как булево.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    
    См. Также:
    
    Preferences.get(String,String), Preferences.putBoolean(String,boolean)
  - putFloat
```
public void putFloat(String key,
                     float value)
```
    Реализует метод putFloat согласно спецификации в Preferences.putFloat(String,float).
    Эта реализация преобразовывает value в строку с Float.toString(float) и вызывает put(String,String) на результате.
    
    Определенный:
    
    putFloat в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getFloat(String,float)
  - getFloat
```
public float getFloat(String key,
                      float def)
```
    Реализует метод getFloat согласно спецификации в Preferences.getFloat(String,float).
    Эта реализация вызывает get(key, null). Если возвращаемое значение является ненулем, реализация пытается преобразовать это в float с Float.parseFloat(String). Если попытка успешно выполняется, возвращаемое значение возвращается этим методом. Иначе, def возвращается.
    
    Определенный:
    
    getFloat в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как плавание.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как плавание.
    
    Возвраты:
    
    значение плавающее, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как плавание.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    
    См. Также:
    
    Preferences.putFloat(String,float), Preferences.get(String,String)
  - putDouble
```
public void putDouble(String key,
                      double value)
```
    Реализует метод putDouble согласно спецификации в Preferences.putDouble(String,double).
    Эта реализация преобразовывает value в строку с Double.toString(double) и вызывает put(String,String) на результате.
    
    Определенный:
    
    putDouble в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getDouble(String,double)
  - getDouble
```
public double getDouble(String key,
                        double def)
```
    Реализует метод getDouble согласно спецификации в Preferences.getDouble(String,double).
    Эта реализация вызывает get(key, null). Если возвращаемое значение является ненулем, реализация пытается преобразовать это в double с Double.parseDouble(String). Если попытка успешно выполняется, возвращаемое значение возвращается этим методом. Иначе, def возвращается.
    
    Определенный:
    
    getDouble в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как двойное.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как двойное.
    
    Возвраты:
    
    двойное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как двойное.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    
    См. Также:
    
    Preferences.putDouble(String,double), Preferences.get(String,String)
  - putByteArray
```
public void putByteArray(String key,
                         byte[] value)
```
    Реализует метод putByteArray согласно спецификации в Preferences.putByteArray(String,byte[]).
    
    Определенный:
    
    putByteArray в class Preferences
    
    Параметры:
    
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом или значением является null.
    
    IllegalArgumentException - если key.length () превышает MAX_KEY_LENGTH или если value.length превышает MAX_VALUE_LENGTH*3/4.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.getByteArray(String,byte[]), Preferences.get(String,String)
  - getByteArray
```
public byte[] getByteArray(String key,
                           byte[] def)
```
    Реализует метод getByteArray согласно спецификации в Preferences.getByteArray(String,byte[]).
    
    Определенный:
    
    getByteArray в class Preferences
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено как байтовый массив.
    
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как байтовый массив.
    
    Возвраты:
    
    значение байтового массива, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как байтовый массив.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null. (Значение null для def разрешается.)
    
    См. Также:
    
    Preferences.get(String,String), Preferences.putByteArray(String,byte[])
  - ключи
```
public String[] keys()
              throws BackingStoreException
```
    Реализует метод keys согласно спецификации в Preferences.keys().
    Эта реализация получает эту привилегированную блокировку узла, проверки, что узел не был удален и вызывает keysSpi().
    
    Определенный:
    
    keys в class Preferences
    
    Возвраты:
    
    массив ключей, у которых есть присваиваемое значение в этом привилегированном узле.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - childrenNames
```
public String[] childrenNames()
                       throws BackingStoreException
```
    Реализует метод children согласно спецификации в Preferences.childrenNames().
    Эта реализация получает эту привилегированную блокировку узла, проверки, что узел не был удален, создают TreeSet, инициализированный к именам дочерних элементов, уже кэшируемых (дочерние элементы в "дочернем кэше" этого узла), вызывают childrenNamesSpi(), и добавляет все возвращенные дочерние имена в набор. Элементы древовидного набора выводятся в массив String, использующий метод toArray, и этот массив возвращается.
    
    Определенный:
    
    childrenNames в class Preferences
    
    Возвраты:
    
    имена дочерних элементов этого привилегированного узла.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    cachedChildren()
  - cachedChildren
```
protected final AbstractPreferences[] cachedChildren()
```
    Возвраты все известные неудаленные дочерние элементы этого узла.
    
    Возвраты:
    
    все известные неудаленные дочерние элементы этого узла.
  - родитель
```
public Preferences parent()
```
    Реализует метод parent согласно спецификации в Preferences.parent().
    Эта реализация получает эту привилегированную блокировку узла, проверки, что узел не был удален и возвращает родительское значение, которое передали конструктору этого узла.
    
    Определенный:
    
    parent в class Preferences
    
    Возвраты:
    
    родитель этого привилегированного узла.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - узел
```
public Preferences node(String path)
```
    Реализует метод node согласно спецификации в Preferences.node(String).
    Эта реализация получает эту привилегированную блокировку узла и проверяет, что узел не был удален. Если path является "", этот узел возвращается; если path является "/", корень этого узла возвращается. Если первым символом в path не является '/', реализация повреждает path в маркеры и рекурсивно пересекает путь от этого узла до именованного узла, "используя" имя и наклонную черту с path в каждом шаге обхода. В каждом шаге блокируется текущий узел, и дочерний кэш узла проверяется на именованный узел. Если это не находится, имя проверяется, чтобы удостовериться, что его длина не превышает MAX_NAME_LENGTH. Затем childSpi(String) метод вызывается, и результат, сохраненный в дочернем кэше этого узла. Если недавно создаваемый объект Preferences newNode полем является true и есть любые слушатели изменения узла, событие уведомления ставится в очередь для того, чтобы обработать событием, диспетчеризируют поток.
    То, когда нет больше маркеров, последнее значение, найденное в дочернем кэше, или возвратилось childSpi, возвращается этим методом. Если во время обхода, два маркера "/" происходят последовательно, или заключительным маркером является "/" (а не имя), соответствующий IllegalArgumentException бросается.
    Если первым символом path является '/' (указание на абсолютный путь), эта привилегированная блокировка узла отбрасывается до повреждения path в маркеры, и этот метод рекурсивно пересекает путь, запускающийся с корня (вместо того, чтобы запуститься с этого узла). Обход иначе идентичен тому, описанному для относительных путей. Отбрасывание блокировки на этом узле до открытия обхода в корневом узле важно, чтобы избежать возможности мертвой блокировки, согласно locking invariant.
    
    Определенный:
    
    node в class Preferences
    
    Параметры:
    
    path - путь привилегированного узла, чтобы возвратиться.
    
    Возвраты:
    
    указанный привилегированный узел.
    
    Броски:
    
    IllegalArgumentException - если путь недопустим (то есть, он содержит многократные последовательные символы наклонной черты, или заканчивается символом наклонной черты и является больше чем одним символом долго).
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    Preferences.flush()
  - nodeExists
```
public boolean nodeExists(String path)
                   throws BackingStoreException
```
    Реализует метод nodeExists согласно спецификации в Preferences.nodeExists(String).
    Эта реализация очень подобна node(String), за исключением того, что getChild(String) используется вместо childSpi(String).
    
    Определенный:
    
    nodeExists в class Preferences
    
    Параметры:
    
    path - путь узла, существование которого должно быть проверено.
    
    Возвраты:
    
    истина, если указанный узел существует.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    IllegalArgumentException - если путь недопустим (то есть, он содержит многократные последовательные символы наклонной черты, или заканчивается символом наклонной черты и является больше чем одним символом долго).
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод и pathname не являются пустой строкой ("").
  - removeNode
```
public void removeNode()
                throws BackingStoreException
```
    Реализует метод removeNode() согласно спецификации в Preferences.removeNode().
    Эти проверки реализации, чтобы видеть, что этот узел является корнем; если так, это выдает соответствующее исключение. Затем, это блокирует родителя этого узла, и вызывает рекурсивный метод помощника, который пересекает поддерево, базированное в этом узле. Рекурсивный метод блокирует узел, на котором его вызвали, проверки, что он не был уже удален, и затем гарантирует, что все его дочерние элементы кэшируются: childrenNamesSpi() метод вызывается, и каждое возвращенное дочернее имя проверяется на включение в дочернем кэше. Если дочерний элемент уже не кэшируется, childSpi(String) метод вызывается, чтобы создать экземпляр Preferences для этого, и этот экземпляр помещается в дочерний кэш. Затем вызовы метода помощника самостоятельно рекурсивно на каждом узле содержатся в его дочернем кэше. Затем, это вызывает removeNodeSpi(), отмечает себя как удалено, и удаляет себя из дочернего кэша его родителя. Наконец, если есть какие-либо слушатели изменения узла, это ставит в очередь событие уведомления для того, чтобы обработать событием, диспетчеризируют поток.
    Отметьте, что метод помощника всегда вызывается со всеми предками до "самого близкого неудаленного предка", заблокированного.
    
    Определенный:
    
    removeNode в class Preferences
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был уже удален с removeNode() метод.
    
    UnsupportedOperationException - если этот метод вызывается на корневой узел.
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    См. Также:
    
    Preferences.flush()
  - имя
```
public String name()
```
    Реализует метод name согласно спецификации в Preferences.name().
    Эта реализация просто возвращает имя, которое передали конструктору этого узла.
    
    Определенный:
    
    name в class Preferences
    
    Возвраты:
    
    это привилегированное имя узла, относительно его родителя.
  - absolutePath
```
public String absolutePath()
```
    Реализует метод absolutePath согласно спецификации в Preferences.absolutePath().
    Эта реализация просто возвращает абсолютный путь, который был вычислен в то время, когда этот узел был создан (основанный на имени, которое передали конструктору этого узла, и именам, которые передали конструкторам предков этого узла).
    
    Определенный:
    
    absolutePath в class Preferences
    
    Возвраты:
    
    этот привилегированный абсолютный путь узла.
  - isUserNode
```
public boolean isUserNode()
```
    Реализует метод isUserNode согласно спецификации в Preferences.isUserNode().
    Эта реализация сравнивает корневой узел этого узла (который сохранен в частном поле) со значением, возвращенным Preferences.userRoot(). Если эти две ссылки на объект идентичны, этот метод возвращает true.
    
    Определенный:
    
    isUserNode в class Preferences
    
    Возвраты:
    
    true, если этот привилегированный узел находится в дереве пользовательской настройки, false, если это находится в системном привилегированном дереве.
  - addPreferenceChangeListener
```
public void addPreferenceChangeListener(PreferenceChangeListener pcl)
```
    Описание скопировало с class: Preferences
    
    Регистрирует указанного слушателя, чтобы получить привилегированные события изменения для этого привилегированного узла. Привилегированное событие изменения сгенерировано, когда предпочтение добавляется к этому узлу, удаленному из этого узла, или когда значение, связанное с предпочтением, изменяется. (Привилегированные события изменения не сгенерированы Preferences.removeNode() метод, который генерирует событие изменения узла. Привилегированные события изменения сгенерированы методом clear.)
    События только гарантируются для изменений, произведенных в пределах той же самой JVM как зарегистрированный слушатель, хотя некоторые реализации могут генерировать события для изменений, произведенных вне этой JVM. События могут быть сгенерированы прежде, чем изменения делались персистентными. События не сгенерированы, когда предпочтение изменяется в потомках этого узла; вызывающая сторона, требуя таких событий должна зарегистрироваться в каждом потомке.
    
    Определенный:
    
    addPreferenceChangeListener в class Preferences
    
    Параметры:
    
    pcl - Привилегированный слушатель изменения, чтобы добавить.
    
    См. Также:
    
    Preferences.removePreferenceChangeListener(PreferenceChangeListener), Preferences.addNodeChangeListener(NodeChangeListener)
  - removePreferenceChangeListener
```
public void removePreferenceChangeListener(PreferenceChangeListener pcl)
```
    Описание скопировало с class: Preferences
    
    Удаляет указанного привилегированного слушателя изменения, таким образом, это больше не получает привилегированные события изменения.
    
    Определенный:
    
    removePreferenceChangeListener в class Preferences
    
    Параметры:
    
    pcl - Привилегированный слушатель изменения, чтобы удалить.
    
    См. Также:
    
    Preferences.addPreferenceChangeListener(PreferenceChangeListener)
  - addNodeChangeListener
```
public void addNodeChangeListener(NodeChangeListener ncl)
```
    Описание скопировало с class: Preferences
    
    Регистрирует указанного слушателя, чтобы получить события изменения узла для этого узла. Событие изменения узла сгенерировано, когда дочерний узел добавляется к или удаляется из этого узла. (Сингл Preferences.removeNode() результаты вызова в многократных событиях изменения узла, один для каждого узла в поддереве базировались в удаленном узле.)
    События только гарантируются для изменений, произведенных в пределах той же самой JVM как зарегистрированный слушатель, хотя некоторые реализации могут генерировать события для изменений, произведенных вне этой JVM. События могут быть сгенерированы прежде, чем изменения стали постоянными. События не сгенерированы, когда косвенные потомки этого узла добавляются или удаляются; вызывающая сторона, требуя таких событий должна зарегистрироваться в каждом потомке.
    Немного гарантий могут быть сделаны относительно создания узла. Поскольку узлы создаются неявно на доступ, возможно, не выполнимо для реализации определить, существовал ли дочерний узел в запоминающем устройстве до доступа (например, потому что запоминающее устройство недостижимо, или кэшируемая информация является устаревшей). При этих обстоятельствах реализации ни не требуются генерировать события изменения узла, ни мешаются делать так.
    
    Определенный:
    
    addNodeChangeListener в class Preferences
    
    Параметры:
    
    ncl - NodeChangeListener, чтобы добавить.
    
    См. Также:
    
    Preferences.removeNodeChangeListener(NodeChangeListener), Preferences.addPreferenceChangeListener(PreferenceChangeListener)
  - removeNodeChangeListener
```
public void removeNodeChangeListener(NodeChangeListener ncl)
```
    Описание скопировало с class: Preferences
    
    Удаляет указанный NodeChangeListener, таким образом, он больше не получает события изменения.
    
    Определенный:
    
    removeNodeChangeListener в class Preferences
    
    Параметры:
    
    ncl - NodeChangeListener, чтобы удалить.
    
    См. Также:
    
    Preferences.addNodeChangeListener(NodeChangeListener)
  - putSpi
```
protected abstract void putSpi(String key,
                               String value)
```
    Поместите данную ассоциацию значения ключа в этот привилегированный узел. Гарантируется, что key и value являются ненулем и юридической длины. Кроме того, гарантируется, что этот узел не был удален. (Конструктор не должен проверить ни на одну из этих вещей.)
    Этот метод вызывается с блокировкой на этом сохраненном узле.
  - getSpi
```
protected abstract String getSpi(String key)
```
    Возвратите значение, связанное с указанным ключом в этом привилегированном узле, или null, если нет никакой ассоциации для этого ключа, или ассоциация не может быть определена в это время. Гарантируется, что key является ненулем. Кроме того, гарантируется, что этот узел не был удален. (Конструктор не должен проверить ни на одну из этих вещей.)
    Вообще говоря, этот метод не должен выдать исключение при любых обстоятельствах. Если, однако, если это действительно выдает исключение, исключение будет прервано и обработано как возвращаемое значение null.
    Этот метод вызывается с блокировкой на этом сохраненном узле.
    
    Возвраты:
    
    значение, связанное с указанным ключом в этом привилегированном узле, или null, если нет никакой ассоциации для этого ключа, или ассоциации, не может быть определено в это время.
  - removeSpi
```
protected abstract void removeSpi(String key)
```
    Удалите ассоциацию (если любой) для указанного ключа в этом привилегированном узле. Гарантируется, что key является ненулем. Кроме того, гарантируется, что этот узел не был удален. (Конструктор не должен проверить ни на одну из этих вещей.)
    Этот метод вызывается с блокировкой на этом сохраненном узле.
  - removeNodeSpi
```
protected abstract void removeNodeSpi()
                               throws BackingStoreException
```
    Удаляет этот привилегированный узел, лишая законной силы это и любое предпочтение, которое это содержит. У именованного дочернего элемента не будет никаких потомков в то время, когда этот вызов делается (то есть, Preferences.removeNode() метод неоднократно вызывает этот метод восходящим способом, удаляя каждого из потомков узла прежде, чем удалить узел непосредственно).
    Этот метод вызывается с блокировкой, держался этот узел и его родитель (и все предки, которые удаляются в результате единственного вызова к Preferences.removeNode()).
    Удаление узла не должно стать персистентным, пока метод flush не вызывается на этот узел (или предок).
    Если этот узел бросит BackingStoreException, то исключение распространит вне включения removeNode() вызов.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - keysSpi
```
protected abstract String[] keysSpi()
                             throws BackingStoreException
```
    Возвраты все ключи, у которых есть присваиваемое значение в этом привилегированном узле. (Возвращенный массив будет иметь нулевой размер, если у этого узла не будет никакого предпочтения.) Гарантируется, что этот узел не был удален.
    Этот метод вызывается с блокировкой на этом сохраненном узле.
    Если этот узел бросит BackingStoreException, то исключение распространит вне включения keys() вызов.
    
    Возвраты:
    
    массив ключей, у которых есть присваиваемое значение в этом привилегированном узле.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - childrenNamesSpi
```
protected abstract String[] childrenNamesSpi()
                                      throws BackingStoreException
```
    Возвращает имена дочерних элементов этого привилегированного узла. (Возвращенный массив будет иметь нулевой размер, если у этого узла не будет никаких дочерних элементов.) Этот метод не должен возвратить имена любых узлов, уже кэшируемых, но может сделать так без вреда.
    Этот метод вызывается с блокировкой на этом сохраненном узле.
    Если этот узел бросит BackingStoreException, то исключение распространит вне включения childrenNames() вызов.
    
    Возвраты:
    
    массив, содержащий имена дочерних элементов этого привилегированного узла.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - getChild
```
protected AbstractPreferences getChild(String nodeName)
                                throws BackingStoreException
```
    Возвращает именованный дочерний элемент, если это существует, или null, если это не делает. Гарантируется, что nodeName является ненулем, непустым, не содержит символ наклонной черты (' / '), и больше не чем Preferences.MAX_NAME_LENGTH символы. Кроме того, гарантируется, что этот узел не был удален. (Конструктор не должен проверить ни на одну из этих вещей, если он хочет переопределять этот метод.)
    Наконец, гарантируется, что именованный узел не был возвращен предыдущим вызовом этого метода или childSpi(java.lang.String) после в прошлый раз, когда это было удалено. Другими словами кэшируемое значение будет всегда использоваться в предпочтении к вызову этого метода. (Конструктор не должен поддержать свой собственный кэш ранее возвращенных дочерних элементов, если он хочет переопределять этот метод.)
    Эта реализация получает эту привилегированную блокировку узла, вызывает childrenNames() получить массив имен дочерних элементов этого узла, и выполняет итерации по массиву, сравнивающему имя каждого дочернего элемента с указанным именем узла. Если у дочернего узла есть корректное имя, childSpi(String) метод вызывается, и получающийся узел возвращается. Если итерация завершается, не находя указанное имя, null возвращается.
    
    Параметры:
    
    nodeName - имя дочернего элемента, который будет разыскиваться.
    
    Возвраты:
    
    именованный дочерний элемент, если это существует, или нуль, если это не делает.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - childSpi
```
protected abstract AbstractPreferences childSpi(String name)
```
    Возвращает именованный дочерний элемент этого привилегированного узла, создавая это, если это уже не существует. Гарантируется, что name является ненулем, непустым, не содержит символ наклонной черты (' / '), и больше не чем Preferences.MAX_NAME_LENGTH символы. Кроме того, гарантируется, что этот узел не был удален. (Конструктор не должен проверить ни на одну из этих вещей.)
    Наконец, гарантируется, что именованный узел не был возвращен предыдущим вызовом этого метода или getChild(String) после в прошлый раз, когда это было удалено. Другими словами кэшируемое значение будет всегда использоваться в предпочтении к вызову этого метода. Подклассы не должны поддержать свой собственный кэш ранее возвращенных дочерних элементов.
    Разработчик должен гарантировать, что возвращенный узел не был удален. Если бы подобно-именованный дочерний элемент этого узла был ранее удален, то разработчик должен возвратить недавно созданный узел AbstractPreferences; после того, как удаленный, узел AbstractPreferences не может быть "реанимирован".
    Если этот метод заставит узел создаваться, то этот узел, как гарантируют, не будет персистентным, пока метод flush не будет вызван на этот узел или одного из его предков (или потомки).
    Этот метод вызывается с блокировкой на этом сохраненном узле.
    
    Параметры:
    
    name - Имя дочернего узла, чтобы возвратиться, относительно этого привилегированного узла.
    
    Возвраты:
    
    Именованный дочерний узел.
  - toString
```
public String toString()
```
    Возвращает абсолютный путь этого привилегированного узла.
    
    Определенный:
    
    toString в class Preferences
    
    Возвраты:
    
    строковое представление объекта.
  - синхронизация
```
public void sync()
          throws BackingStoreException
```
    Реализует метод sync согласно спецификации в Preferences.sync().
    Эта реализация вызывает рекурсивный метод помощника, который блокирует этот узел, вызывает syncSpi () на ней, разблокировал этот узел, и рекурсивно вызывает этот метод на каждый "кэшируемый дочерний элемент." Кэшируемый дочерний элемент является дочерним элементом этого узла, который был создан в этом VM и не впоследствии удален. В действительности этот метод делает глубину, первый обход "кэшируемого поддерева" базировался в этом узле, вызывая syncSpi () на каждом узле в поддереве, в то время как только, что узел блокируется. Отметьте, что syncSpi () вызывается сверху вниз.
    
    Определенный:
    
    sync в class Preferences
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    См. Также:
    
    flush()
  - syncSpi
```
protected abstract void syncSpi()
                         throws BackingStoreException
```
    Этот метод вызывается с этим заблокированным узлом. Контракт этого метода должен синхронизировать любое кэшируемое предпочтение, сохраненное в этом узле любым сохраненным в запоминающем устройстве. (Совершенно возможно, что этот узел не существует на запоминающем устройстве, или потому что это было удалено другим VM, или потому что это еще не было создано.) Отмечают, что этот метод не должен синхронизировать предпочтение в любых подузлах этого узла. Если запоминающее устройство естественно синхронизирует все поддерево сразу, разработчик поощряется переопределить синхронизацию (), вместо того, чтобы просто переопределить этот метод.
    Если этот узел бросит BackingStoreException, то исключение распространит вне включения sync() вызов.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - сброс
```
public void flush()
           throws BackingStoreException
```
    Реализует метод flush согласно спецификации в Preferences.flush().
    Эта реализация вызывает рекурсивный метод помощника, который блокирует этот узел, вызывает flushSpi () на ней, разблокировал этот узел, и рекурсивно вызывает этот метод на каждый "кэшируемый дочерний элемент." Кэшируемый дочерний элемент является дочерним элементом этого узла, который был создан в этом VM и не впоследствии удален. В действительности этот метод делает глубину, первый обход "кэшируемого поддерева" базировался в этом узле, вызывая flushSpi () на каждом узле в поддереве, в то время как только, что узел блокируется. Отметьте, что flushSpi () вызывается сверху вниз.
    Если этот метод вызывается на узел, который был удален с removeNode() метод, flushSpi () вызывается на этот узел, но не на других.
    
    Определенный:
    
    flush в class Preferences
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
    
    См. Также:
    
    flush()
  - flushSpi
```
protected abstract void flushSpi()
                          throws BackingStoreException
```
    Этот метод вызывается с этим заблокированным узлом. Контракт этого метода должен вызвать любые кэшируемые изменения в содержании этого привилегированного узла к запоминающему устройству, гарантируя их персистентность. (Совершенно возможно, что этот узел не существует на запоминающем устройстве, или потому что это было удалено другим VM, или потому что это еще не было создано.) Отмечают, что этот метод не должен сбросить предпочтение в любых подузлах этого узла. Если запоминающее устройство естественно сбрасывает все поддерево сразу, разработчик поощряется переопределить сброс (), вместо того, чтобы просто переопределить этот метод.
    Если этот узел бросит BackingStoreException, то исключение распространит вне включения flush() вызов.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа в запоминающем устройстве, или неспособности связаться с этим.
  - isRemoved
```
protected boolean isRemoved()
```
    Возвраты эквивалентность true этот узел (или предок) были удалены с removeNode() метод. Этот метод блокирует этот узел до возврата содержания частного поля, используемого, чтобы отследить это состояние.
    
    Возвраты:
    
    Эквивалентность true этот узел (или предок) была удалена с removeNode() метод.
  - exportNode
```
public void exportNode(OutputStream os)
                throws IOException,
                       BackingStoreException
```
    Реализует метод exportNode согласно спецификации в Preferences.exportNode(OutputStream).
    
    Определенный:
    
    exportNode в class Preferences
    
    Параметры:
    
    os - поток вывода, о котором можно испустить XML-документ.
    
    Броски:
    
    IOException - если запись в указанный поток вывода приводит к IOException.
    
    BackingStoreException - если привилегированные данные не могут быть считаны из запоминающего устройства.
    
    См. Также:
    
    Preferences.importPreferences(InputStream)
  - exportSubtree
```
public void exportSubtree(OutputStream os)
                   throws IOException,
                          BackingStoreException
```
    Реализует метод exportSubtree согласно спецификации в Preferences.exportSubtree(OutputStream).
    
    Определенный:
    
    exportSubtree в class Preferences
    
    Параметры:
    
    os - поток вывода, о котором можно испустить XML-документ.
    
    Броски:
    
    IOException - если запись в указанный поток вывода приводит к IOException.
    
    BackingStoreException - если привилегированные данные не могут быть считаны из запоминающего устройства.
    
    См. Также:
    
    Preferences.importPreferences(InputStream), Preferences.exportNode(OutputStream)

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс AbstractPreferences

Полевая Сводка

Поля, наследованные от class java.util.prefs. Предпочтение

Сводка конструктора

Сводка метода

Методы, наследованные от class java.util.prefs. Предпочтение

Методы, наследованные от class java.lang. Объект

Полевая Деталь

newNode

блокировка

Деталь конструктора

AbstractPreferences

Деталь метода

поместить

добраться

удалить

очистить

putInt

getInt

putLong

getLong

putBoolean

getBoolean

putFloat

getFloat

putDouble

getDouble

putByteArray

getByteArray

ключи

childrenNames

cachedChildren

родитель

узел

nodeExists

removeNode

имя

absolutePath

isUserNode

addPreferenceChangeListener

removePreferenceChangeListener

addNodeChangeListener

removeNodeChangeListener

putSpi

getSpi

removeSpi

removeNodeSpi

keysSpi

childrenNamesSpi

getChild

childSpi

toString

синхронизация

syncSpi

сброс

flushSpi

isRemoved

exportNode

exportSubtree