Предпочтение (Платформа Java SE 7)

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

Прямые Известные Подклассы:

AbstractPreferences
```
public abstract class Preferences
extends Object
```
Узел в иерархическом наборе привилегированных данных. Этот класс позволяет приложениям хранить и получать пользователя и системное предпочтение и данные конфигурации. Эти данные постоянно хранятся в зависящей от реализации внешней памяти. Типичные реализации включают плоские файлы, специфичные для ОС реестры, серверы каталогов и базы данных SQL. Пользователь этого класса не должен быть обеспокоен деталями внешней памяти.
Есть два отдельных дерева привилегированных узлов, один для пользовательских настроек и один для установок системы. У каждого пользователя есть отдельное дерево пользовательской настройки, и все пользователи в данной системе совместно используют то же самое системное привилегированное дерево. Точное описание "пользователя" и "системы" изменится от реализации до реализации. Типичная информация, хранившая в дереве пользовательской настройки, могла бы включать выбор шрифта, цветной выбор, или предпочла расположение окна и размер для определенного приложения. Типичная информация, хранившая в системном привилегированном дереве, могла бы включать данные конфигурации установки для приложения.
Узлы в привилегированном дереве называют подобным способом к каталогам в иерархической файловой системе. У каждого узла в привилегированном дереве есть имя узла (который не обязательно уникален), уникальный абсолютный путь, и путь относительно каждого предка включая себя.
У корневого узла есть имя узла пустой строки (""). У любого узла есть произвольное имя узла, определенное в то время, когда он создается. Единственные ограничения на это имя - то, что это не может быть пустая строка, и это не может содержать символ наклонной черты (' / ').
У корневого узла есть абсолютный путь "/". У дочерних элементов корневого узла есть абсолютные пути "/" + <имя узла>. У всех других узлов есть абсолютные пути <абсолютный путь родителя> + "/" + <имя узла>. Отметьте, что все абсолютные пути начинаются с символа наклонной черты.
Путь n's узла относительно его предка просто строка, которая должна быть добавлена к абсолютному пути a, чтобы сформировать абсолютный путь n с начальным символом наклонной черты, (если есть) удаленным. Отметьте что:
- Никакие относительные пути не начинаются с символа наклонной черты.
- Путь каждого узла относительно себя является пустой строкой.
- Путь каждого узла относительно его родителя является своим именем узла (за исключением корневого узла, у которого нет родителя).
- Путь каждого узла относительно корня является своим абсолютным путем с начальным удаленным символом наклонной черты.
Отметьте наконец что:
- Никакой путь не содержит многократные последовательные символы наклонной черты.
- Никакой путь за исключением абсолютного пути корня не заканчивается в символе наклонной черты.
- Любая строка, которая соответствует этим двум правилам, является допустимым путем.
Всем методам, которые изменяют привилегированные данные, разрешают работать асинхронно; они могут сразу возвратиться, и изменения в конечном счете распространят к персистентной внешней памяти с зависящей от реализации задержкой. Метод flush может использоваться, чтобы синхронно вызвать обновления к внешней памяти. Нормальное завершение виртуальной машины Java не будет приводить к потере обновлений на ожидании - явный вызов flush не требуется после завершения гарантировать, что обновления на ожидании делаются персистентными.
Все методы, которые читают предпочтение из объекта Preferences, требуют, чтобы invoker обеспечил значение по умолчанию. Значение по умолчанию возвращается, если никакое значение не было ранее установлено или если внешняя память недоступна. Намерение состоит в том, чтобы позволить приложениям работать, хотя с немного ухудшенной функциональностью, даже если внешняя память становится недоступной. У нескольких методов, как flush, есть семантика, которые препятствуют тому, чтобы они работали, если внешняя память недоступна. У обычных приложений не должно быть никакой потребности вызвать любой из этих методов, которые могут быть идентифицированы фактом, что они, как объявляют, бросают BackingStoreException.
Методы в этом классе могут быть вызваны одновременно многократными потоками в единственной JVM без потребности во внешней синхронизации, и результаты будут эквивалентны некоторому последовательному выполнению. Если этот класс будет использоваться одновременно многократными JVM, которые хранят их привилегированные данные в той же самой внешней памяти, то хранилище данных не будет повреждено, но никакие другие гарантии не делаются относительно непротиворечивости привилегированных данных.
Этот класс содержит средство экспорта/импорта, позволяя предпочтение быть "экспортированным" в XML-документ, и XML-документы, представляющие предпочтение, которое будет "импортировано" назад в систему. Это средство может использоваться, чтобы поддержать все или часть привилегированного дерева, и впоследствии восстановить от резервного копирования.
У XML-документа есть следующее объявление DOCTYPE:
```
 <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
 
```
Отметьте, что к системному URI (http://java.sun.com/dtd/preferences.dtd) не получают доступ, экспортируя или импортируя предпочтение; это просто служит строкой, чтобы однозначно определить DTD, который является:
```
    <?xml version="1.0" encoding="UTF-8"?>

    

    
    <!ELEMENT preferences (root)>

    
    <!ATTLIST preferences EXTERNAL_XML_VERSION CDATA "0.0" >

    
    <!ELEMENT root (map, node*) >

    
    <!ATTLIST root
              type (system|user) #REQUIRED >

    
    <!ELEMENT node (map, node*) >

    
    <!ATTLIST node
              name CDATA #REQUIRED >

    
    <!ELEMENT map (entry*) >

    
    <!ELEMENT entry EMPTY >
    <!ATTLIST entry
              key   CDATA #REQUIRED
              value CDATA #REQUIRED >
 
```
У каждой реализации Preferences должно быть связанное PreferencesFactory реализация. Каждый Java (ТМ), реализация SE должна обеспечить некоторые средства определения, какая реализация PreferencesFactory используется, чтобы генерировать корневые привилегированные узлы. Это позволяет администратору заменять привилегированную реализацию по умолчанию альтернативной реализацией.
Примечание реализации: В JRE Sun реализация PreferencesFactory располагается следующим образом:
1. Если системное свойство java.util.prefs.PreferencesFactory определяется, то оно берется, чтобы быть полностью определенным именем класса, реализовывая интерфейс PreferencesFactory. Класс загружается и инстанцируется; если этот процесс перестал работать тогда, неустановленная ошибка бросается.
2. Если файл класса реализации PreferencesFactory был установлен в файле фляги, который видим к system class loader, и тот файл фляги содержит конфигурационный файл провайдера под названием java.util.prefs.PreferencesFactory в каталоге META-INF/services ресурса, тогда имя первого класса, определенное в том файле, берется. Если больше чем один такой файл фляги будет обеспечен, то первый найденный будет использоваться. Класс загружается и инстанцируется; если этот процесс перестал работать тогда, неустановленная ошибка бросается.
3. Наконец, если ни вышеупомянутое системное свойство, ни файл фляги расширения не обеспечиваются, то реализация PreferencesFactory по умолчанию в масштабе всей системы для базовой платформы загружается и инстанцируется.
С тех пор:

1.4

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

Поля
Модификатор и Тип	Поле и Описание
`static int`	`MAX_KEY_LENGTH` Максимальная длина строки, позволенной как ключ (80 символов).
`static int`	`MAX_NAME_LENGTH` Максимальная длина имени узла (80 символов).
`static int`	`MAX_VALUE_LENGTH` Максимальная длина строки, позволенной как значение (8192 символа).

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

Конструкторы
Модификатор Конструктор и Описание

protected Preferences()
Единственный конструктор.

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`Preferences()` Единственный конструктор.

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

Методы
Модификатор и Тип	Метод и Описание
`abstract String`	`absolutePath()` Возвраты этот привилегированный абсолютный путь узла.
`abstract void`	`addNodeChangeListener(NodeChangeListener ncl)` Регистрирует указанного слушателя, чтобы получить события изменения узла для этого узла.
`abstract void`	`addPreferenceChangeListener(PreferenceChangeListener pcl)` Регистрирует указанного слушателя, чтобы получить привилегированные события изменения для этого привилегированного узла.
`abstract String[]`	`childrenNames()` Возвращает имена дочерних элементов этого привилегированного узла, относительно этого узла.
`abstract void`	`clear()` Удаляет все предпочтение (ассоциации значения ключа) в этом привилегированном узле.
`abstract void`	`exportNode(OutputStream os)` Испускает на указанном потоке вывода XML-документ, представляющий все предпочтение, содержавшееся в этом узле (но не его потомки).
`abstract void`	`exportSubtree(OutputStream os)` Испускает XML-документ, представляющий все предпочтение, содержавшееся в этом узле и всех его потомках.
`abstract void`	`flush()` Силы любые изменения в содержании этого привилегированного узла и его потомков к персистентному хранилищу.
`abstract String`	`get(String key, String def)` Возвращает значение, связанное с указанным ключом в этом привилегированном узле.
`abstract boolean`	`getBoolean(String key, boolean def)` Возвращает булево значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`abstract byte[]`	`getByteArray(String key, byte[] def)` Возвращает значение байтового массива, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`abstract double`	`getDouble(String key, double def)` Возвращает двойное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`abstract float`	`getFloat(String key, float def)` Возвращает значение плавающее, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`abstract int`	`getInt(String key, int def)` Возвращает международное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`abstract long`	`getLong(String key, long def)` Возвращает длинное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле.
`static void`	`importPreferences(InputStream is)` Импорт все предпочтение представляется XML-документом об указанном входном потоке.
`abstract boolean`	`isUserNode()` `true` возвратов, если этот привилегированный узел находится в дереве пользовательской настройки, `false`, если это находится в системном привилегированном дереве.
`abstract String[]`	`keys()` Возвраты все ключи, у которых есть присваиваемое значение в этом привилегированном узле.
`abstract String`	`name()` Возвраты это привилегированное имя узла, относительно его родителя.
`abstract Preferences`	`node(String pathName)` Возвращает именованный привилегированный узел в том же самом дереве как этот узел, создавая это и любой из его предков, если они уже не существуют.
`abstract boolean`	`nodeExists(String pathName)` Возвращает true, если именованный привилегированный узел существует в том же самом дереве как этот узел.
`abstract Preferences`	`parent()` Возвращает родителя этого привилегированного узла, или `null`, если это - корень.
`abstract void`	`put(String key, String value)` Связывает указанное значение с указанным ключом в этом привилегированном узле.
`abstract void`	`putBoolean(String key, boolean value)` Связывает строку, представляющую указанное булево значение с указанным ключом в этом привилегированном узле.
`abstract void`	`putByteArray(String key, byte[] value)` Связывает строку, представляющую указанный байтовый массив с указанным ключом в этом привилегированном узле.
`abstract void`	`putDouble(String key, double value)` Связывает строку, представляющую указанное двойное значение с указанным ключом в этом привилегированном узле.
`abstract void`	`putFloat(String key, float value)` Связывает строку, представляющую указанное значение плавающее с указанным ключом в этом привилегированном узле.
`abstract void`	`putInt(String key, int value)` Связывает строку, представляющую указанное международное значение с указанным ключом в этом привилегированном узле.
`abstract void`	`putLong(String key, long value)` Связывает строку, представляющую указанное длинное значение с указанным ключом в этом привилегированном узле.
`abstract void`	`remove(String key)` Удаляет значение, связанное с указанным ключом в этом привилегированном узле, если любой.
`abstract void`	`removeNode()` Удаляет этот привилегированный узел и всех его потомков, лишая законной силы любое предпочтение, содержавшееся в удаленных узлах.
`abstract void`	`removeNodeChangeListener(NodeChangeListener ncl)` Удаляет указанный `NodeChangeListener`, таким образом, он больше не получает события изменения.
`abstract void`	`removePreferenceChangeListener(PreferenceChangeListener pcl)` Удаляет указанного привилегированного слушателя изменения, таким образом, это больше не получает привилегированные события изменения.
`abstract void`	`sync()` Гарантирует, что будущие чтения от этого привилегированного узла и его потомков отражают любые изменения, которые посвящали себя персистентному хранилищу (от любого VM) до вызова `sync`.
`static Preferences`	`systemNodeForPackage(Class<?> c)` Возвращает привилегированный узел из системного привилегированного дерева, которое связывается (условно) с пакетом указанного класса.
`static Preferences`	`systemRoot()` Возвращает корневой привилегированный узел для системы.
`abstract String`	`toString()` Возвращает строковое представление этого привилегированного узла, как будто вычисленный expression:`(this.isUserNode() ? "User" : "System") + " Preference Node: " + this.absolutePath()`.
`static Preferences`	`userNodeForPackage(Class<?> c)` Возвращает привилегированный узел из пользовательского привилегированного дерева вызова, которое связывается (условно) с пакетом указанного класса.
`static Preferences`	`userRoot()` Возвращает корневой привилегированный узел для пользователя вызова.

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

- Полевая Деталь
  - MAX_KEY_LENGTH
```
public static final int MAX_KEY_LENGTH
```
    Максимальная длина строки, позволенной как ключ (80 символов).
    
    См. Также:
    Постоянные Значения полей
  - MAX_VALUE_LENGTH
```
public static final int MAX_VALUE_LENGTH
```
    Максимальная длина строки, позволенной как значение (8192 символа).
    
    См. Также:
    Постоянные Значения полей
  - MAX_NAME_LENGTH
```
public static final int MAX_NAME_LENGTH
```
    Максимальная длина имени узла (80 символов).
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - Предпочтение
```
protected Preferences()
```
    Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)
- Деталь метода
  - userNodeForPackage
```
public static Preferences userNodeForPackage(Class<?> c)
```
    Возвращает привилегированный узел из пользовательского привилегированного дерева вызова, которое связывается (условно) с пакетом указанного класса. Соглашение следующие: абсолютный путь узла является полностью определенным именем пакета, которому предшествует наклонная черта ('/'), и с каждым периодом ('.'), замененный наклонной чертой. Например абсолютным путем узла, связанного с классом com.acme.widget.Foo, является /com/acme/widget.
    Это соглашение не применяется к неназванному пакету, связанным привилегированным узлом которого является <unnamed>. Этот узел не предназначается для долгосрочного использования, но для удобства в ранней разработке программ, которые еще не принадлежат пакету, и для "холостых" программ. Ценные данные не должны храниться в этом узле, поскольку это совместно используется всеми программами, которые используют это.
    Класс Foo, желающий получить доступ к предпочтению, имеющему отношение к его пакету, может получить привилегированный узел следующим образом:
```
    static Preferences prefs = Preferences.userNodeForPackage(Foo.class);
 
```
    Эта идиома устраняет потребность в использовании строки, чтобы описать привилегированный узел и уменьшает вероятность отказа времени выполнения. (Если имя класса будет написано c орфографическими ошибками, то оно будет обычно приводить к ошибке времени компиляции.)
    Вызов этого метода приведет к созданию возвращенного узла и его предков, если они не будут уже существовать. Если возвращенный узел не существовал до этого вызова, этот узел и любые предки, которые создавались этим вызовом, как гарантируют, не станут постоянными, пока метод flush не вызовут на возвращенном узле (или один из его предков или потомков).
    Параметры:
    c - класс, для пакета которого требуется узел пользовательской настройки.
    
    Возвраты:
    узел пользовательской настройки, связанный с пакетом, которого c является элементом.
    
    Броски:
    
    NullPointerException - если c является null.
    
    SecurityException - если менеджер безопасности присутствует, и он отрицает RuntimePermission("preferences").
    См. Также:
    RuntimePermission
  - systemNodeForPackage
```
public static Preferences systemNodeForPackage(Class<?> c)
```
    Возвращает привилегированный узел из системного привилегированного дерева, которое связывается (условно) с пакетом указанного класса. Соглашение следующие: абсолютный путь узла является полностью определенным именем пакета, которому предшествует наклонная черта ('/'), и с каждым периодом ('.'), замененный наклонной чертой. Например абсолютным путем узла, связанного с классом com.acme.widget.Foo, является /com/acme/widget.
    Это соглашение не применяется к неназванному пакету, связанным привилегированным узлом которого является <unnamed>. Этот узел не предназначается для долгосрочного использования, но для удобства в ранней разработке программ, которые еще не принадлежат пакету, и для "холостых" программ. Ценные данные не должны храниться в этом узле, поскольку это совместно используется всеми программами, которые используют это.
    Класс Foo, желающий получить доступ к предпочтению, имеющему отношение к его пакету, может получить привилегированный узел следующим образом:
```
  static Preferences prefs = Preferences.systemNodeForPackage(Foo.class);
 
```
    Эта идиома устраняет потребность в использовании строки, чтобы описать привилегированный узел и уменьшает вероятность отказа времени выполнения. (Если имя класса будет написано c орфографическими ошибками, то оно будет обычно приводить к ошибке времени компиляции.)
    Вызов этого метода приведет к созданию возвращенного узла и его предков, если они не будут уже существовать. Если возвращенный узел не существовал до этого вызова, этот узел и любые предки, которые создавались этим вызовом, как гарантируют, не станут постоянными, пока метод flush не вызовут на возвращенном узле (или один из его предков или потомков).
    Параметры:
    c - класс, для пакета которого требуется системный привилегированный узел.
    
    Возвраты:
    системный привилегированный узел, связанный с пакетом, которого c является элементом.
    
    Броски:
    
    NullPointerException - если c является null.
    
    SecurityException - если менеджер безопасности присутствует, и он отрицает RuntimePermission("preferences").
    См. Также:
    RuntimePermission
  - userRoot
```
public static Preferences userRoot()
```
    Возвращает корневой привилегированный узел для пользователя вызова.
    
    Возвраты:
    корневой привилегированный узел для пользователя вызова.
    
    Броски:
    
    SecurityException - Если менеджер безопасности присутствует, и он отрицает RuntimePermission("preferences").
    См. Также:
    RuntimePermission
  - корневой каталог
```
public static Preferences systemRoot()
```
    Возвращает корневой привилегированный узел для системы.
    
    Возвраты:
    корневой привилегированный узел для системы.
    
    Броски:
    
    SecurityException - Если менеджер безопасности присутствует, и он отрицает RuntimePermission("preferences").
    См. Также:
    RuntimePermission
  - поместить
```
public abstract void put(String key,
       String value)
```
    Связывает указанное значение с указанным ключом в этом привилегированном узле.
    
    Параметры:
    key - ключ, с которым должно быть связано указанное значение.
    value - значение, которое будет связано с указанным ключом.
    
    Броски:
    
    NullPointerException - если ключом или значением является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH или если value.length превышает MAX_VALUE_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - добраться
```
public abstract String get(String key,
         String def)
```
    Возвращает значение, связанное с указанным ключом в этом привилегированном узле. Возвращает указанное значение по умолчанию, если нет никакого значения, связанного с ключом, или внешняя память недоступна.
    Некоторые реализации могут сохранить значения по умолчанию в своих хранилищах поддержки. Если нет никакого значения, связанного с указанным ключом, но есть такое сохраненное значение по умолчанию, он возвращается в предпочтении к указанному значению по умолчанию.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key.
    
    Возвраты:
    значение, связанное с key, или def, если никакое значение не связывается с key, или внешней памятью, недоступно.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null. (Значение null для def разрешается.)
  - удалить
```
public abstract void remove(String key)
```
    Удаляет значение, связанное с указанным ключом в этом привилегированном узле, если любой.
    Если эта реализация будет поддерживать сохраненные значения по умолчанию, и есть такое значение по умолчанию для указанного предпочтения, то сохраненное значение по умолчанию будет "представлено" этим вызовом, в том смысле, что это будет возвращено последующим звонком в get.
    
    Параметры:
    key - манипулируйте, чье отображение должно быть удалено из привилегированного узла.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - очистить
```
public abstract void clear()
                    throws BackingStoreException
```
    Удаляет все предпочтение (ассоциации значения ключа) в этом привилегированном узле. Этот вызов не имеет никакого эффекта на любых потомков этого узла.
    Если эта реализация будет поддерживать сохраненные значения по умолчанию, и этот узел в привилегированной иерархии содержит любые такие значения по умолчанию, то сохраненные значения по умолчанию будут "представлены" этим вызовом, в том смысле, что они будут возвращены, следуя за звонками в get.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    removeNode()
  - putInt
```
public abstract void putInt(String key,
          int value)
```
    Связывает строку, представляющую указанное международное значение с указанным ключом в этом привилегированном узле. Связанная строка является той, которая была бы возвращена, если бы к международному значению передали Integer.toString(int). Этот метод предназначается для использования в соединении с getInt(java.lang.String, int).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getInt(String,int)
  - getInt
```
public abstract int getInt(String key,
         int def)
```
    Возвращает международное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Строка преобразовывается в целое число как Integer.parseInt(String). Возвращает указанное значение по умолчанию, если бы нет никакого значения, связанного с ключом, внешняя память недоступна, или если Integer.parseInt(String) бросил бы a NumberFormatException если присваиваемое значение передали. Этот метод предназначается для использования в соединении с putInt(java.lang.String, int).
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует, доступно, и могло бы быть преобразовано в интервал с Integer.parseInt, этот интервал возвращается в предпочтении к указанному значению по умолчанию.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как интервал.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как интервал, или внешняя память недоступна.
    
    Возвраты:
    международное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как интервал.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    См. Также:
    putInt(String,int), get(String,String)
  - putLong
```
public abstract void putLong(String key,
           long value)
```
    Связывает строку, представляющую указанное длинное значение с указанным ключом в этом привилегированном узле. Связанная строка является той, которая была бы возвращена, если бы к длинному значению передали Long.toString(long). Этот метод предназначается для использования в соединении с getLong(java.lang.String, long).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getLong(String,long)
  - getLong
```
public abstract long getLong(String key,
           long def)
```
    Возвращает длинное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Строка преобразовывается в длинное как Long.parseLong(String). Возвращает указанное значение по умолчанию, если бы нет никакого значения, связанного с ключом, внешняя память недоступна, или если Long.parseLong(String) бросил бы a NumberFormatException если присваиваемое значение передали. Этот метод предназначается для использования в соединении с putLong(java.lang.String, long).
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует, доступно, и могло бы быть преобразовано в длинное с Long.parseLong, это долго возвращается в предпочтении к указанному значению по умолчанию.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как длинное.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как длинное, или внешняя память недоступна.
    
    Возвраты:
    длинное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как длинное.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    См. Также:
    putLong(String,long), get(String,String)
  - putBoolean
```
public abstract void putBoolean(String key,
              boolean value)
```
    Связывает строку, представляющую указанное булево значение с указанным ключом в этом привилегированном узле. Связанной строкой является "true", если значение является истиной, и "false", если это - ложь. Этот метод предназначается для использования в соединении с getBoolean(java.lang.String, boolean).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getBoolean(String,boolean), get(String,String)
  - getBoolean
```
public abstract boolean getBoolean(String key,
                 boolean def)
```
    Возвращает булево значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Допустимыми строками является "true", который представляет истину, и "false", который представляет ложь. Регистр игнорируется, таким образом, например, "TRUE" и "False" также допустимы. Этот метод предназначается для использования в соединении с putBoolean(java.lang.String, boolean).
    Возвращает указанное значение по умолчанию, если нет никакого значения, связанного с ключом, внешняя память недоступна, или если присваиваемое значение - что-то другое чем "true" или "false", игнорируя регистр.
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует и доступно, это используется в предпочтении к указанному значению по умолчанию, если сохраненное значение по умолчанию не что-то другое чем "true" или "false", игнорируя регистр, когда указанное значение по умолчанию используется.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как булевская переменная.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как булевская переменная, или внешняя память недоступна.
    
    Возвраты:
    булево значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как булевская переменная.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    См. Также:
    get(String,String), putBoolean(String,boolean)
  - putFloat
```
public abstract void putFloat(String key,
            float value)
```
    Связывает строку, представляющую указанное значение плавающее с указанным ключом в этом привилегированном узле. Связанная строка является той, которая была бы возвращена, если бы к значению плавающему передали Float.toString(float). Этот метод предназначается для использования в соединении с getFloat(java.lang.String, float).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getFloat(String,float)
  - getFloat
```
public abstract float getFloat(String key,
             float def)
```
    Возвращает значение плавающее, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Строка преобразовывается в целое число как Float.parseFloat(String). Возвращает указанное значение по умолчанию, если бы нет никакого значения, связанного с ключом, внешняя память недоступна, или если Float.parseFloat(String) бросил бы a NumberFormatException если присваиваемое значение передали. Этот метод предназначается для использования в соединении с putFloat(java.lang.String, float).
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует, доступно, и могло бы быть преобразовано в плавание с Float.parseFloat, это плавание возвращается в предпочтении к указанному значению по умолчанию.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как плавание.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как плавание, или внешняя память недоступна.
    
    Возвраты:
    значение плавающее, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как плавание.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    См. Также:
    putFloat(String,float), get(String,String)
  - putDouble
```
public abstract void putDouble(String key,
             double value)
```
    Связывает строку, представляющую указанное двойное значение с указанным ключом в этом привилегированном узле. Связанная строка является той, которая была бы возвращена, если бы к двойному значению передали Double.toString(double). Этот метод предназначается для использования в соединении с getDouble(java.lang.String, double).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если key является null.
    
    IllegalArgumentException - если key.length() превышает MAX_KEY_LENGTH.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getDouble(String,double)
  - getDouble
```
public abstract double getDouble(String key,
               double def)
```
    Возвращает двойное значение, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Строка преобразовывается в целое число как Double.parseDouble(String). Возвращает указанное значение по умолчанию, если бы нет никакого значения, связанного с ключом, внешняя память недоступна, или если Double.parseDouble(String) бросил бы a NumberFormatException если присваиваемое значение передали. Этот метод предназначается для использования в соединении с putDouble(java.lang.String, double).
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует, доступно, и могло бы быть преобразовано в двойное с Double.parseDouble, это удваивается, возвращается в предпочтении к указанному значению по умолчанию.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как двойное.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как двойное, или внешняя память недоступна.
    
    Возвраты:
    двойное значение, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как двойное.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null.
    См. Также:
    putDouble(String,double), get(String,String)
  - putByteArray
```
public abstract void putByteArray(String key,
                byte[] value)
```
    Связывает строку, представляющую указанный байтовый массив с указанным ключом в этом привилегированном узле. Связанная строка является кодированием Base64 байтового массива, как определено в RFC 2045, Раздел 6.8, с одним незначительным изменением: строка будет состоять исключительно из символов от Алфавита Base64; это не будет содержать символов новой строки. Отметьте, что максимальная длина байтового массива ограничивается тремя четвертями MAX_VALUE_LENGTH так, чтобы длина Base64 закодированная Строка не превысила MAX_VALUE_LENGTH. Этот метод предназначается для использования в соединении с getByteArray(java.lang.String, byte[]).
    
    Параметры:
    key - ключ, с которым должна быть связана строковая форма имеющая значение.
    value - оцените, чья строковая форма должна быть связана с ключом.
    
    Броски:
    
    NullPointerException - если ключом или значением является null.
    
    IllegalArgumentException - если key.length () превышает MAX_KEY_LENGTH или если value.length превышает MAX_VALUE_LENGTH*3/4.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    getByteArray(String,byte[]), get(String,String)
  - getByteArray
```
public abstract byte[] getByteArray(String key,
                  byte[] def)
```
    Возвращает значение байтового массива, представленное строкой, связанной с указанным ключом в этом привилегированном узле. Допустимые строки являются Base64 закодированные двоичные данные, как определено в RFC 2045, Раздел 6.8, с одним незначительным изменением: строка должна состоять исключительно из символов от Алфавита Base64; никакие символы новой строки или посторонние символы не разрешаются. Этот метод предназначается для использования в соединении с putByteArray(java.lang.String, byte[]).
    Возвращает указанное значение по умолчанию, если нет никакого значения, связанного с ключом, внешняя память недоступна, или если присваиваемое значение не является допустимым Base64 закодированный байтовый массив (как определено выше).
    Если реализация поддерживает сохраненные значения по умолчанию, и такое значение по умолчанию существует и доступно, это используется в предпочтении к указанному значению по умолчанию, если сохраненное значение по умолчанию не является допустимым Base64 закодированный байтовый массив (как определено выше), когда указанное значение по умолчанию используется.
    
    Параметры:
    key - манипулируйте, чье присваиваемое значение должно быть возвращено как байтовый массив.
    def - значение, которое будет возвращено, когда у этого привилегированного узла нет никакого значения, связанного с key или присваиваемым значением, не может быть интерпретировано как байтовый массив, или внешняя память недоступна.
    
    Возвраты:
    значение байтового массива, представленное строкой, связанной с key в этом привилегированном узле, или def, если присваиваемое значение не существует или не может быть интерпретировано как байтовый массив.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    
    NullPointerException - если key является null. (Значение null для def разрешается.)
    См. Также:
    get(String,String), putByteArray(String,byte[])
  - ключи
```
public abstract String[] keys()
                       throws BackingStoreException
```
    Возвраты все ключи, у которых есть присваиваемое значение в этом привилегированном узле. (Возвращенный массив будет иметь нулевой размер, если у этого узла не будет никакого предпочтения.)
    Если реализация поддерживает сохраненные значения по умолчанию и есть любые такие значения по умолчанию в этом узле, которые не были переопределены явным предпочтением, значения по умолчанию возвращаются в массиве в дополнение к любому явному предпочтению.
    
    Возвраты:
    массив ключей, у которых есть присваиваемое значение в этом привилегированном узле.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - childrenNames
```
public abstract String[] childrenNames()
                                throws BackingStoreException
```
    Возвращает имена дочерних элементов этого привилегированного узла, относительно этого узла. (Возвращенный массив будет иметь нулевой размер, если у этого узла не будет никаких дочерних элементов.)
    
    Возвраты:
    имена дочерних элементов этого привилегированного узла.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - родитель
```
public abstract Preferences parent()
```
    Возвращает родителя этого привилегированного узла, или null, если это - корень.
    
    Возвраты:
    родитель этого привилегированного узла.
    
    Броски:
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
  - узел
```
public abstract Preferences node(String pathName)
```
    Возвращает именованный привилегированный узел в том же самом дереве как этот узел, создавая это и любой из его предков, если они уже не существуют. Принимает относительный или абсолютный путь. Относительные пути (которые не начинаются с символа наклонной черты ('/')) интерпретируются относительно этого привилегированного узла.
    Если возвращенный узел не существовал до этого вызова, этот узел и любые предки, которые создавались этим вызовом, как гарантируют, не станут постоянными, пока метод flush не вызовут на возвращенном узле (или один из его предков или потомков).
    
    Параметры:
    pathName - путь привилегированного узла, чтобы возвратиться.
    
    Возвраты:
    указанный привилегированный узел.
    
    Броски:
    
    IllegalArgumentException - если путь недопустим (то есть, он содержит многократные последовательные символы наклонной черты, или заканчивается символом наклонной черты и является больше чем одним символом долго).
    
    NullPointerException - если путем является null.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    flush()
  - nodeExists
```
public abstract boolean nodeExists(String pathName)
                            throws BackingStoreException
```
    Возвращает true, если именованный привилегированный узел существует в том же самом дереве как этот узел. Относительные пути (которые не начинаются с символа наклонной черты ('/')) интерпретируются относительно этого привилегированного узла.
    Если этот узел (или предок) был уже удален с removeNode() метод, законно вызвать этот метод, но только с путем ""; вызов возвратит false. Таким образом, идиома, которую p.nodeExists("") может использоваться, чтобы протестировать, был ли p удален.
    
    Параметры:
    pathName - путь узла, существование которого должно быть проверено.
    
    Возвраты:
    истина, если указанный узел существует.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalArgumentException - если путь недопустим (то есть, он содержит многократные последовательные символы наклонной черты, или заканчивается символом наклонной черты и является больше чем одним символом долго).
    
    NullPointerException - если путем является null.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод и pathName не являются пустой строкой ("").
  - removeNode
```
public abstract void removeNode()
                         throws BackingStoreException
```
    Удаляет этот привилегированный узел и всех его потомков, лишая законной силы любое предпочтение, содержавшееся в удаленных узлах. Как только узел был удален, делая попытку любого метода кроме name(), absolutePath(), isUserNode(), flush() или nodeExists("") на соответствующем Preferences экземпляр перестанет работать с IllegalStateException. (Методы, определенные на Object может все еще быть вызван на узел после того, как он был удален; они не будут бросать IllegalStateException.)
    Удаление, как гарантируют, не будет персистентным, пока метод flush не вызовут на этом узле (или предок).
    Если эта реализация поддерживает сохраненные значения по умолчанию, удаляя узел представляет любые сохраненные значения по умолчанию в или ниже этого узла. Таким образом последующий звонок в nodeExists на пути этого узла может возвратить true, и последующий звонок в node на этом пути может возвратить (различный) экземпляр Preferences, представляющий непустой набор предпочтения и/или дочерних элементов.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был уже удален с removeNode() метод.
    
    UnsupportedOperationException - если этот метод вызывается на корневой узел.
    См. Также:
    flush()
  - имя
```
public abstract String name()
```
    Возвраты это привилегированное имя узла, относительно его родителя.
    
    Возвраты:
    это привилегированное имя узла, относительно его родителя.
  - absolutePath
```
public abstract String absolutePath()
```
    Возвраты этот привилегированный абсолютный путь узла.
    
    Возвраты:
    этот привилегированный абсолютный путь узла.
  - isUserNode
```
public abstract boolean isUserNode()
```
    true возвратов, если этот привилегированный узел находится в дереве пользовательской настройки, false, если это находится в системном привилегированном дереве.
    
    Возвраты:
    true, если этот привилегированный узел находится в дереве пользовательской настройки, false, если это находится в системном привилегированном дереве.
  - toString
```
public abstract String toString()
```
    Возвращает строковое представление этого привилегированного узла, как будто вычисленный expression:(this.isUserNode() ? "User" : "System") + " Preference Node: " + this.absolutePath().
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление объекта.
  - сброс
```
public abstract void flush()
                    throws BackingStoreException
```
    Силы любые изменения в содержании этого привилегированного узла и его потомков к персистентному хранилищу. Как только этот метод возвращается успешно, безопасно предположить, что все изменения, произведенные в поддереве, базированном в этом узле до вызова метода, стали постоянными.
    Реализации свободны сбросить изменения в персистентное хранилище в любое время. Они не должны ожидать этого метода, который вызовут.
    Когда сброс происходит на недавно создаваемом узле, это делается персистентным, как любые предки (и потомки), которые должны все же быть сделаны персистентными. Отметьте однако, что любые привилегированные изменения значения в предках, как гарантируют, не будут делаться персистентными.
    Если этот метод вызывается на узел, который был удален с removeNode() метод, flushSpi () вызывается на этот узел, но не на других.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    См. Также:
    sync()
  - синхронизация
```
public abstract void sync()
                   throws BackingStoreException
```
    Гарантирует, что будущие чтения от этого привилегированного узла и его потомков отражают любые изменения, которые посвящали себя персистентному хранилищу (от любого VM) до вызова sync. Как побочный эффект, вызывает любые изменения в содержании этого привилегированного узла и его потомков к персистентному хранилищу, как будто метод flush был вызван на этот узел.
    
    Броски:
    
    BackingStoreException - если эта работа не может быть завершена из-за отказа во внешней памяти, или неспособности связаться с этим.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    flush()
  - addPreferenceChangeListener
```
public abstract void addPreferenceChangeListener(PreferenceChangeListener pcl)
```
    Регистрирует указанного слушателя, чтобы получить привилегированные события изменения для этого привилегированного узла. Привилегированное событие изменения сгенерировано, когда предпочтение добавляется к этому узлу, удаленному из этого узла, или когда значение, связанное с предпочтением, изменяется. (Привилегированные события изменения не сгенерированы removeNode() метод, который генерирует событие изменения узла. Привилегированные события изменения сгенерированы методом clear.)
    События только гарантируются для изменений, произведенных в пределах той же самой JVM как зарегистрированный слушатель, хотя некоторые реализации могут генерировать события для изменений, произведенных вне этой JVM. События могут быть сгенерированы прежде, чем изменения делались персистентными. События не сгенерированы, когда предпочтение изменяется в потомках этого узла; вызывающая сторона, требуя таких событий должна зарегистрироваться в каждом потомке.
    
    Параметры:
    pcl - Привилегированный слушатель изменения, чтобы добавить.
    
    Броски:
    
    NullPointerException - если pcl является нулем.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    removePreferenceChangeListener(PreferenceChangeListener), addNodeChangeListener(NodeChangeListener)
  - removePreferenceChangeListener
```
public abstract void removePreferenceChangeListener(PreferenceChangeListener pcl)
```
    Удаляет указанного привилегированного слушателя изменения, таким образом, это больше не получает привилегированные события изменения.
    
    Параметры:
    pcl - Привилегированный слушатель изменения, чтобы удалить.
    
    Броски:
    
    IllegalArgumentException - если pcl не был зарегистрированным привилегированным слушателем изменения на этом узле.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    addPreferenceChangeListener(PreferenceChangeListener)
  - addNodeChangeListener
```
public abstract void addNodeChangeListener(NodeChangeListener ncl)
```
    Регистрирует указанного слушателя, чтобы получить события изменения узла для этого узла. Событие изменения узла сгенерировано, когда дочерний узел добавляется к или удаляется из этого узла. (Сингл removeNode() результаты вызова в многократных событиях изменения узла, один для каждого узла в поддереве базировались в удаленном узле.)
    События только гарантируются для изменений, произведенных в пределах той же самой JVM как зарегистрированный слушатель, хотя некоторые реализации могут генерировать события для изменений, произведенных вне этой JVM. События могут быть сгенерированы прежде, чем изменения стали постоянными. События не сгенерированы, когда косвенные потомки этого узла добавляются или удаляются; вызывающая сторона, требуя таких событий должна зарегистрироваться в каждом потомке.
    Немного гарантий могут быть сделаны относительно создания узла. Поскольку узлы создаются неявно на доступ, возможно, не выполнимо для реализации определить, существовал ли дочерний узел во внешней памяти до доступа (например, потому что внешняя память недостижима, или кэшируемая информация является устаревшей). При этих обстоятельствах реализации ни не требуются генерировать события изменения узла, ни мешаются делать так.
    
    Параметры:
    ncl - NodeChangeListener, чтобы добавить.
    
    Броски:
    
    NullPointerException - если ncl является нулем.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    removeNodeChangeListener(NodeChangeListener), addPreferenceChangeListener(PreferenceChangeListener)
  - removeNodeChangeListener
```
public abstract void removeNodeChangeListener(NodeChangeListener ncl)
```
    Удаляет указанный NodeChangeListener, таким образом, он больше не получает события изменения.
    
    Параметры:
    ncl - NodeChangeListener, чтобы удалить.
    
    Броски:
    
    IllegalArgumentException - если ncl не был зарегистрированный NodeChangeListener на этом узле.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    addNodeChangeListener(NodeChangeListener)
  - exportNode
```
public abstract void exportNode(OutputStream os)
                         throws IOException,
                                BackingStoreException
```
    Испускает на указанном потоке вывода XML-документ, представляющий все предпочтение, содержавшееся в этом узле (но не его потомки). Этот XML-документ является, в действительности, офлайновым резервным копированием узла.
    У XML-документа будет следующее объявление DOCTYPE:
```
 <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
 
```
    Кодировка символов UTF-8 будет использоваться.
    Этот метод является исключением к общему правилу, что результаты параллельного выполнения многократных методов в этом классе приводят к результатам, эквивалентным некоторому последовательному выполнению. Если предпочтение в этом узле изменяется одновременно с вызовом этого метода, экспортируемое предпочтение включает "нечеткий снимок" предпочтения, содержавшегося в узле; некоторые из параллельных модификаций могут быть отражены в экспортируемых данных, в то время как другие не могут.
    Параметры:
    os - поток вывода, о котором можно испустить XML-документ.
    
    Броски:
    
    IOException - если запись в указанный поток вывода приводит к IOException.
    
    BackingStoreException - если привилегированные данные не могут быть считаны из внешней памяти.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    importPreferences(InputStream)
  - exportSubtree
```
public abstract void exportSubtree(OutputStream os)
                            throws IOException,
                                   BackingStoreException
```
    Испускает XML-документ, представляющий все предпочтение, содержавшееся в этом узле и всех его потомках. Этот XML-документ, в действительности, офлайновое резервное копирование поддерева базировалось в узле.
    У XML-документа будет следующее объявление DOCTYPE:
```
 <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
 
```
    Кодировка символов UTF-8 будет использоваться.
    Этот метод является исключением к общему правилу, что результаты параллельного выполнения многократных методов в этом классе приводят к результатам, эквивалентным некоторому последовательному выполнению. Если предпочтение или узлы в поддереве, базированном в этом узле, изменяются одновременно с вызовом этого метода, экспортируемое предпочтение включает "нечеткий снимок" поддерева; некоторые из параллельных модификаций могут быть отражены в экспортируемых данных, в то время как другие не могут.
    Параметры:
    os - поток вывода, о котором можно испустить XML-документ.
    
    Броски:
    
    IOException - если запись в указанный поток вывода приводит к IOException.
    
    BackingStoreException - если привилегированные данные не могут быть считаны из внешней памяти.
    
    IllegalStateException - если этот узел (или предок) был удален с removeNode() метод.
    См. Также:
    importPreferences(InputStream), exportNode(OutputStream)
  - importPreferences
```
public static void importPreferences(InputStream is)
                              throws IOException,
                                     InvalidPreferencesFormatException
```
    Импорт все предпочтение представляется XML-документом об указанном входном потоке. Документ может представить пользовательские настройки или установки системы. Если это представит пользовательские настройки, то предпочтение будет импортировано в пользовательское привилегированное дерево вызова (даже если они первоначально происходили из привилегированного дерева различного пользователя). Если какое-либо предпочтение, описанное документом, будет населять привилегированные узлы, которые не существуют, то узлы будут создаваться.
    У XML-документа должно быть следующее объявление DOCTYPE:
```
 <!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">
 
```
    (Этот метод разрабатывается для использования в соединении с exportNode(OutputStream) и exportSubtree(OutputStream).
    Этот метод является исключением к общему правилу, что результаты параллельного выполнения многократных методов в этом классе приводят к результатам, эквивалентным некоторому последовательному выполнению. Метод ведет себя как будто реализованный сверху других открытых методов в этом классе, особенно node(String) и put(String, String).
    Параметры:
    is - входной поток, из которого можно считать XML-документ.
    
    Броски:
    
    IOException - если чтение от указанного входного потока приводит к IOException.
    
    InvalidPreferencesFormatException - Данные на входном потоке не составляют допустимый XML-документ с переданным под мандат типом документа.
    
    SecurityException - Если менеджер безопасности присутствует, и он отрицает RuntimePermission("preferences").
    См. Также:
    RuntimePermission

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

Предпочтение класса

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

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

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

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

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

MAX_KEY_LENGTH

MAX_VALUE_LENGTH

MAX_NAME_LENGTH

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

Предпочтение

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

userNodeForPackage

systemNodeForPackage

userRoot

корневой каталог

поместить

добраться

удалить

очистить

putInt

getInt

putLong

getLong

putBoolean

getBoolean

putFloat

getFloat

putDouble

getDouble

putByteArray

getByteArray

ключи

childrenNames

родитель

узел

nodeExists

removeNode

имя

absolutePath

isUserNode

toString

сброс

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

addPreferenceChangeListener

removePreferenceChangeListener

addNodeChangeListener

removeNodeChangeListener

exportNode

exportSubtree

importPreferences