Класс Preferences

Узел в иерархической коллекции данных настроек. Этот класс позволяет приложениям хранить и извлекать данные настроек и конфигурации пользователей и системы. Эти данные хранятся постоянно в базе данных, зависящей от реализации. Типичные реализации включают плоские файлы, регистры, специфичные для ОС, серверы каталогов и базы данных SQL. Пользователь этого класса не должен беспокоиться о деталях базы данных.

Существуют два отдельных дерева узлов настроек, одно для пользовательских настроек и одно для системных настроек. Каждый пользователь имеет отдельное дерево пользовательских настроек, а все пользователи в данной системе используют одно и то же дерево системных настроек. Точное определение «пользователя» и «системы» будет варьироваться в зависимости от реализации. Типичная информация, хранимая в дереве пользовательских настроек, может включать выбор шрифта, выбор цвета или предпочтительное расположение и размер окна для определённого приложения. Типичная информация, хранимая в дереве системных настроек, может включать данные конфигурации установки приложения.

Узлы в дереве настроек имеют имена, аналогичные именам каталогов в иерархической файловой системе. Каждый узел в дереве настроек имеет имя узла (которое необязательно уникально), уникальное полное имя пути и имя пути, относительное к каждому предку, включая его самого.

Узел корня имеет имя узла пустую строку (""). Каждый другой узел имеет произвольное имя узла, заданное во время его создания. Единственные ограничения на это имя заключаются в том, что оно не может быть пустой строкой и не может содержать символ косой черты ('/').

Узел корня имеет абсолютный путь "/". Узлы, являющиеся дочерними по отношению к корневому узлу, имеют абсолютные пути "/" + <имя узла>. Все остальные узлы имеют абсолютные пути <абсолютный путь родительского узла> + "/" + <имя узла>. Обратите внимание, что все абсолютные пути начинаются с символа косой черты.

Имя пути узла n, относительное к его предку a, — это просто строка, которую необходимо добавить к абсолютному имени пути a, чтобы получить абсолютный путь n, с удалением начального символа косой черты (если он присутствует). Обратите внимание на:

• Относительные имена путей не начинаются с символа косой черты.
• Имя пути каждого узла относительно самого себя — пустая строка.
• Имя пути каждого узла относительно его родителя — его имя узла (за исключением корневого узла, у которого нет родительского узла).
• Имя пути каждого узла относительно корня — это его абсолютный путь с удалённым начальным символом косой черты.

И наконец, обратите внимание на:

• Имя пути не содержит нескольких последовательных символов косой черты.
• Никакое имя пути, за исключением абсолютного имени пути корня, не оканчивается символом косой черты.
• Любая строка, соответствующая этим двум правилам, является допустимым именем пути.

Все методы, изменяющие данные настроек, разрешено выполнять асинхронно; они могут возвращать значения немедленно, а изменения будут в конечном итоге распространяться на постоянную базу данных с задержкой, зависящей от реализации. Метод flush может использоваться для синхронного принудительного обновления базы данных.

Нормальное завершение виртуальной машины Java не приведёт к потере ожидаемых обновлений — явное вызов flush не требуется при завершении для обеспечения того, что ожидаемые обновления будут сохранены.

Все методы, которые считывают настройки из объекта Preferences, требуют от вызывающей стороны указать значение по умолчанию. Значение по умолчанию возвращается, если значение не было ранее установлено или если база данных недоступна. Цель состоит в том, чтобы позволить приложениям работать, хотя и с немного ухудшенной функциональностью, даже если база данных станет недоступной. Несколько методов, таких как flush, имеют семантику, которая предотвращает их выполнение, если база данных недоступна. Обычным приложениям не нужно вызывать ни один из этих методов, что можно определить по тому, что они объявлены как выбрасывающие исключение BackingStoreException.

Методы этого класса могут вызываться одновременно несколькими потоками в одной JVM без необходимости внешней синхронизации, и результаты будут эквивалентны некоторому последовательному выполнению. Если этот класс используется одновременно множеством JVM, которые хранят свои данные настроек в одной и той же базе данных, база данных не будет повреждена, но никаких других гарантий относительно согласованности данных настроек не предоставляется.

Этот класс содержит механизм экспорта/импорта, позволяющий «экспортировать» настройки в документ XML и «импортировать» документы XML, представляющие настройки, обратно в систему. Этот механизм может использоваться для резервного копирования всего или части дерева настроек и последующего восстановления из резервной копии.

Документ XML имеет следующее объявление DOCTYPE:

<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">

<?xml version="1.0" encoding="UTF-8"?>

    <!-- DTD for a Preferences tree. -->

    <!-- The preferences element is at the root of an XML document
         representing a Preferences tree. -->
    <!ELEMENT preferences (root)>

    <!-- The preferences element contains an optional version attribute,
          which specifies version of DTD. -->
    <!ATTLIST preferences EXTERNAL_XML_VERSION CDATA "0.0" >

    <!-- The root element has a map representing the root's preferences
         (if any), and one node for each child of the root (if any). -->
    <!ELEMENT root (map, node*) >

    <!-- Additionally, the root contains a type attribute, which
         specifies whether it's the system or user root. -->
    <!ATTLIST root
              type (system|user) #REQUIRED >

    <!-- Each node has a map representing its preferences (if any),
         and one node for each child (if any). -->
    <!ELEMENT node (map, node*) >

    <!-- Additionally, each node has a name attribute -->
    <!ATTLIST node
              name CDATA #REQUIRED >

    <!-- A map represents the preferences stored at a node (if any). -->
    <!ELEMENT map (entry*) >

    <!-- An entry represents a single preference, which is simply
          a key-value pair. -->
    <!ELEMENT entry EMPTY >
    <!ATTLIST entry
              key   CDATA #REQUIRED
              value CDATA #REQUIRED >

Примечание для реализации: в JRE Sun's реализация PreferencesFactory расположена следующим образом:

1. Если системная переменная java.util.prefs.PreferencesFactory определена, то она считается полным именем класса, реализующего интерфейс PreferencesFactory. Класс загружается и создаётся; если этот процесс завершится ошибкой, будет выброшено неопределённое исключение.

2. Если файл класса реализации PreferencesFactory был установлен в файле jar, видимом для system class loader, и этот файл jar содержит файл конфигурации поставщика с именем java.util.prefs.PreferencesFactory в каталоге ресурсов META-INF/services, то первым именем класса, указанным в этом файле, будет использоваться. Если предоставлено более одного такого файла jar, будет использоваться первый найденный.

   Класс загружается и создаётся; если этот процесс завершится ошибкой, будет выброшено неопределённое исключение.

3. Наконец, если ни указанная выше системная переменная, ни файл jar расширения не предоставлены, то загружается и создаётся системная по умолчанию PreferencesFactory реализация для базовой платформы.

Поля

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 символов).

См. также:

Значения постоянных полей

Конструкторы

Preferences

protected Preferences()

Единственный конструктор. (Для вызова подклассами, как правило, неявный).

Методы

userNodeForPackage

public static Preferences userNodeForPackage(Class<?> c)

static Preferences prefs = Preferences.userNodeForPackage(Foo.class);

Параметры:

c - класс, для пакета которого требуется узел настроек пользователя.

Возвращает:

узел настроек пользователя, связанный с пакетом, членом которого является c.

Исключения:

NullPointerException - если c является null.

SecurityException - если менеджер безопасности присутствует и отклоняет RuntimePermission("preferences").

См. также:

RuntimePermission

systemNodeForPackage

public static Preferences systemNodeForPackage(Class<?> c)

static Preferences prefs = Preferences.systemNodeForPackage(Foo.class);

Параметры:

c - класс, для пакета которого требуется системный узел настроек.

Возвращает:

системный узел настроек, связанный с пакетом, членом которого является c.

Исключения:

NullPointerException - если c является null.

SecurityException - если менеджер безопасности присутствует и отклоняет RuntimePermission("preferences").

См. также:

RuntimePermission

userRoot

public static Preferences userRoot()

Возвращает корневой узел настроек для вызывающего пользователя.

Возвращает:

корневой узел настроек для вызывающего пользователя.

Исключения:

SecurityException - Если менеджер безопасности присутствует и отклоняет RuntimePermission("preferences").

См. также:

RuntimePermission

systemRoot

public static Preferences systemRoot()

Возвращает корневой узел настроек для системы.

Возвращает:

корневой узел настроек для системы.

Исключения:

SecurityException - Если менеджер безопасности присутствует и отклоняет RuntimePermission("preferences").

См. также:

RuntimePermission

put

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().

get

public abstract String get(String key,
                           String def)

Параметры:

key - ключ, связанное значение которого должно быть возвращено.

def - значение, которое должно быть возвращено в случае, если в этом узле настроек нет значения, связанного с key.

Возвращает:

значение, связанное с key, или def если нет значения, связанного с key, или хранилище недоступно.

Исключения:

IllegalStateException - если этот узел (или предок) был удален с помощью метода removeNode().

NullPointerException - если key является null. (Значение null для def разрешено.)

remove

public abstract void remove(String key)

Параметры:

key - ключ, отображение которого должно быть удалено из узла настроек.

Исключения:

NullPointerException - если key является null.

IllegalStateException - если этот узел (или предок) был удален с помощью метода removeNode().

clear

public abstract void clear()
                    throws BackingStoreException

Исключения:

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)

Параметры:

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, со значением ключа в этом узле настроек. Связанная строка — это та, что была бы возвращена, если бы значение long было передано в 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)

Параметры:

key - ключ, связанное значение которого должно быть возвращено как long.

def - значение, которое должно быть возвращено в случае, если в этом узле настроек нет значения, связанного с key, или связанное значение не может быть интерпретировано как long, или хранилище недоступно.

Возвращает:

значение long, представленное строкой, связанной с key в этом узле настроек, или def, если связанного значения не существует или оно не может быть интерпретировано как long.

Исключения:

IllegalStateException - если этот узел (или предковый) был удалён методом removeNode().

NullPointerException - если key имеет значение null.

См. также:

putLong(String,long), get(String,String)

putBoolean

public abstract void putBoolean(String key,
                                boolean value)

Связывает строку, представляющую заданное логическое значение, с указанным ключом в этом узле настроек. Связанная строка — это "true", если значение равно true, и "false", если оно равно 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)

Параметры:

key - ключ, связанное значение которого должно быть возвращено как boolean.

def - значение, которое должно быть возвращено в случае, если в этом узле настроек нет значения, связанного с key, или связанное значение не может быть интерпретировано как boolean, или хранилище недоступно.

Возвращает:

логическое значение, представленное строкой, связанной с key в этом узле настроек, или def, если связанного значения не существует или оно не может быть интерпретировано как boolean.

Исключения:

IllegalStateException - если этот узел (или предковый) был удалён методом removeNode().

NullPointerException - если key имеет значение null.

См. также:

get(String,String), putBoolean(String,boolean)

putFloat

public abstract void putFloat(String key,
                              float value)

Связывает строку, представляющую заданное значение float, со значением ключа в этом узле настроек. Связанная строка — это та, что была бы возвращена, если бы значение float было передано в 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)

Параметры:

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, с указанным ключом в этом узле настроек. Связанная строка — это строка, которая была бы возвращена, если бы значение типа double было передано в 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)

Параметры:

key - ключ, связанное значение которого должно быть возвращено как число с плавающей точкой double.

def - значение, которое должно быть возвращено в случае, если у этого узла настроек нет значения, связанного с key, или связанное значение не может быть интерпретировано как число с плавающей точкой double, или кэш недоступен.

Возвращает:

значение типа double, представленное строкой, связанной с key в этом узле настроек, или def, если связанное значение не существует или не может быть интерпретировано как число с плавающей точкой double.

Исключение:

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 - если длина ключа превышает MAX_KEY_LENGTH или длина массива байтов превышает MAX_VALUE_LENGTH*3/4.

IllegalStateException - если этот узел (или предшественник) был удалён методом removeNode().

См. также:

getByteArray(String,byte[]), get(String,String)

getByteArray

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

Параметры:

key - ключ, связанное значение которого должно быть возвращено как массив байтов.

def - значение, которое должно быть возвращено в случае, если у этого узла настроек нет значения, связанного с key, или связанное значение не может быть интерпретировано как массив байтов, или кэш недоступен.

Возвращает:

массив байтов, представленный строкой, связанной с key в этом узле настроек, или def, если связанное значение не существует или не может быть интерпретировано как массив байтов.

Исключение:

IllegalStateException - если этот узел (или предшественник) был удалён методом removeNode().

NullPointerException - если key равно null. (Значение null для def разрешено.)

См. также:

get(String,String), putByteArray(String,byte[])

keys

public abstract String[] keys()
                       throws BackingStoreException

Возвращает:

массив ключей, для которых в этом узле настроек есть связанное значение.

Исключение:

BackingStoreException - если эту операцию нельзя выполнить из-за сбоя в кэше или потери связи с ним.

IllegalStateException - если этот узел (или предшественник) был удалён методом removeNode().

childrenNames

public abstract String[] childrenNames()
                                throws BackingStoreException

Возвращает имена дочерних узлов этого узла настроек, относительно этого узла. (Возвращаемый массив будет пустым, если у этого узла нет дочерних узлов.)

Возвращает:

имена дочерних узлов этого узла настроек.

Исключение:

BackingStoreException - если эту операцию нельзя выполнить из-за сбоя в кэше или потери связи с ним.

IllegalStateException - если этот узел (или предшественник) был удалён методом removeNode().

parent

public abstract Preferences parent()

Возвращает родительский узел этого узла настроек или null, если это корневой узел.

Возвращает:

родительский узел этого узла настроек.

Исключение:

IllegalStateException - если этот узел (или предшественник) был удалён методом removeNode().

node

public abstract Preferences node(String pathName)

Параметры:

pathName - имя пути узла предпочтений для возврата.

Возвращает:

указанный узел предпочтений.

Исключения:

IllegalArgumentException - если имя пути некорректно (например, содержит несколько последовательных символов косой черты или оканчивается символом косой черты и имеет длину более одного символа).

NullPointerException - если имя пути равно null.

IllegalStateException - если этот узел (или его предшественник) был удален методом removeNode().

См. также:

flush()

nodeExists

public abstract boolean nodeExists(String pathName)
                            throws BackingStoreException

Параметры:

pathName - имя пути узла, существование которого необходимо проверить.

Возвращает:

true, если указанный узел существует.

Исключения:

BackingStoreException - если данная операция не может быть завершена из-за сбоя в базе данных или невозможности связи с ней.

IllegalArgumentException - если имя пути некорректно (например, содержит несколько последовательных символов косой черты или оканчивается символом косой черты и имеет длину более одного символа).

NullPointerException - если имя пути равно null.

IllegalStateException - если этот узел (или его предшественник) был удален методом removeNode() и pathName не является пустой строкой ("").

removeNode

public abstract void removeNode()
                         throws BackingStoreException

Исключения:

BackingStoreException - если данная операция не может быть завершена из-за сбоя в базе данных или невозможности связи с ней.

IllegalStateException - если этот узел (или его предшественник) уже был удален методом removeNode().

UnsupportedOperationException - если этот метод вызван на корневом узле.

См. также:

flush()

name

public abstract String name()

Возвращает имя этого узла предпочтений, относительно его родительского узла.

Возвращает:

Имя этого узла предпочтений, относительно его родительского узла.

absolutePath

public abstract String absolutePath()

Возвращает абсолютное имя пути этого узла предпочтений.

Возвращает:

Абсолютное имя пути этого узла предпочтений.

isUserNode

public abstract boolean isUserNode()

Возвращает true если этот узел предпочтений находится в дереве пользовательских предпочтений, false если он находится в дереве системных предпочтений.

Возвращает:

true если этот узел предпочтений находится в дереве пользовательских предпочтений, false если он находится в дереве системных предпочтений.

toString

public abstract String toString()

Возвращает строковое представление этого узла предпочтений, как если бы оно было вычислено выражением: (this.isUserNode() ? "User" : "System") + " Preference Node: " + this.absolutePath().

Переопределяет:

toString в классе Object

Возвращает:

строковое представление объекта.

flush

public abstract void flush()
                    throws BackingStoreException

Исключения:

BackingStoreException - если данная операция не может быть завершена из-за сбоя в базе данных или невозможности связи с ней.

См. также:

sync()

sync

public abstract void sync()
                   throws BackingStoreException

Обеспечивает, что будущие чтения из этого узла предпочтений и его потомков будут отражать любые изменения, внесенные в постоянное хранилище (любым виртуальной машиной) до вызова sync. В качестве побочного эффекта, принудительно записывает любые изменения в содержимое этого узла предпочтений и его потомков в постоянное хранилище, как если бы метод flush был вызван на этом узле.

Исключения:

BackingStoreException - если данная операция не может быть завершена из-за сбоя в базе данных или невозможности связи с ней.

IllegalStateException - если этот узел (или его предшественник) был удален методом removeNode().

См. также:

flush()

addPreferenceChangeListener

public abstract void addPreferenceChangeListener(PreferenceChangeListener pcl)

Параметры:

pcl - слушатель изменений предпочтений для добавления.

Исключения:

NullPointerException - если pcl равно null.

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)

Параметры:

ncl - Добавляемый NodeChangeListener.

Исключения:

NullPointerException - если ncl равно null.

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

<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">

Параметры:

os - поток вывода, в который будет выведен XML-документ.

Исключения:

IOException - если запись в указанный поток вывода приводит к IOException.

BackingStoreException - если данные предпочтений не могут быть считаны из хранилища.

IllegalStateException - если этот узел (или его предок) был удалён методом removeNode().

См. также:

importPreferences(InputStream)

exportSubtree

public abstract void exportSubtree(OutputStream os)
                            throws IOException,
                                   BackingStoreException

<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">

Параметры:

os - поток вывода, в который будет выведен XML-документ.

Исключения:

IOException - если запись в указанный поток вывода приводит к IOException.

BackingStoreException - если данные предпочтений не могут быть считаны из хранилища.

IllegalStateException - если этот узел (или его предок) был удалён методом removeNode().

См. также:

importPreferences(InputStream), exportNode(OutputStream)

importPreferences

public static void importPreferences(InputStream is)
                              throws IOException,
                                     InvalidPreferencesFormatException

<!DOCTYPE preferences SYSTEM "http://java.sun.com/dtd/preferences.dtd">

Параметры:

is - поток ввода, из которого будет прочитан XML-документ.

Исключения:

IOException - если чтение из указанного потока ввода приводит к IOException.

InvalidPreferencesFormatException - Данные в потоке ввода не представляют собой допустимый XML-документ с указанным типом документа.

SecurityException - Если менеджер безопасности присутствует и запрещает RuntimePermission("preferences").

См. также:

RuntimePermission