Spec-Zone.ru › OpenJDK 8

Класс PropertyEditorManager

  • java.lang.Object
    • java.beans.PropertyEditorManager

public class PropertyEditorManager
extends Object

Класс PropertyEditorManager может использоваться для поиска редактора свойств для любого заданного типа. Этот редактор свойств должен поддерживать интерфейс java.beans.PropertyEditor для редактирования заданного объекта.

PropertyEditorManager использует три метода для поиска редактора для заданного типа. Во-первых, он предоставляет метод registerEditor, позволяющий зарегистрировать редактор для определенного типа. Во-вторых, он пытается найти подходящий класс, добавляя «Editor» к полному квалифицированному имени класса заданного типа (например, «foo.bah.FozEditor»). Наконец, он берет простое имя класса (без имени пакета), добавляет «Editor» и ищет соответствующий класс в пути поиска пакетов.

Итак, для входного класса foo.bah.Fred, PropertyEditorManager сначала проверит свои таблицы, чтобы увидеть, был ли зарегистрирован редактор для foo.bah.Fred, и если да, то использует его. Затем он будет искать класс foo.bah.FredEditor. Затем он будет искать (скажем) класс стандартEditorsPackage.FredEditor.

По умолчанию редакторы свойств будут предоставлены для Java-примитивных типов «boolean», «byte», «short», «int», «long», «float» и «double»; а также для классов java.lang.String, java.awt.Color и java.awt.Font.

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

Конструктор и описание
PropertyEditorManager()

Методы

Модификатор и тип Метод и описание
static PropertyEditor findEditor(Class<?> targetType)

Находит редактор значения для заданного целевого типа.

static String[] getEditorSearchPath()

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

static void registerEditor(Class<?> targetType, Class<?> editorClass)

Регистрирует класс редактора для редактирования значений заданного целевого класса.

static void setEditorSearchPath(String[] path)

Изменяет список имён пакетов, которые будут использоваться для поиска редакторов свойств.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

PropertyEditorManager

public PropertyEditorManager()

Методы

registerEditor

public static void registerEditor(Class<?> targetType,
                                  Class<?> editorClass)

Регистрирует класс редактора для редактирования значений заданного целевого класса. Если класс редактора null, то любое существующее определение будет удалено. Таким образом, этот метод может быть использован для отмены регистрации. Регистрация отменяется автоматически, если целевой или редакторский класс загружается.

Если существует менеджер безопасности, вызывается его метод checkPropertiesAccess. Это может привести к исключению SecurityException.

Параметры:
targetType - объект класса типа, подлежащего редактированию
editorClass - объект класса класса редактора
Исключения:
SecurityException - если менеджер безопасности существует и его метод checkPropertiesAccess не разрешает установку системных свойств
См. также:
SecurityManager.checkPropertiesAccess()

findEditor

public static PropertyEditor findEditor(Class<?> targetType)

Находит редактор значения для заданного целевого типа.

Параметры:
targetType - Объект класса для редактируемого типа
Возвращает:
Объект редактора для заданного целевого класса. Результат null, если подходящий редактор не найден.

getEditorSearchPath

public static String[] getEditorSearchPath()

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

Возвращает:
Массив имён пакетов, которые будут проверяться в порядке поиска редакторов свойств.

Значение по умолчанию для этого массива зависит от реализации, например, в реализации Sun он изначально устанавливается в {"sun.beans.editors"}.

setEditorSearchPath

public static void setEditorSearchPath(String[] path)

Изменяет список имён пакетов, которые будут использоваться для поиска редакторов свойств.

Сначала, если существует менеджер безопасности, вызывается его метод checkPropertiesAccess. Это может привести к SecurityException.

Параметры:
path - Массив имён пакетов.
Исключения:
SecurityException - если менеджер безопасности существует и его метод checkPropertiesAccess не разрешает установку системных свойств.
См. также:
SecurityManager.checkPropertiesAccess()

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API