Класс 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. Затем он будет искать (например) класс standardEditorsPackage.FredEditor.

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

Since:: 1.1

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

Конструктор	Описание
`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.

Parameters:: targetType - объект класса типа, который должен быть отредактирован; editorClass - объект класса редактора
Throws:: SecurityException - если менеджер безопасности существует, и его метод checkPropertiesAccess не разрешает установку системных свойств
See Also:: SecurityManager.checkPropertiesAccess()

findEditor

public static PropertyEditor findEditor(Class<?> targetType)

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

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

getEditorSearchPath

public static String[] getEditorSearchPath()

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

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

setEditorSearchPath

public static void setEditorSearchPath(String[] path)

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

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

Parameters:: path - Массив имён пакетов.
Throws:: SecurityException - если менеджер безопасности существует, и его метод checkPropertiesAccess не разрешает установку системных свойств.
See Also:: SecurityManager.checkPropertiesAccess()