Класс 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.

С момента:: 1.1

Краткое описание конструкторов

Конструктор	Описание
`PropertyEditorManager()`	Создаёт `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()

Создаёт 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, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/beans/PropertyEditorManager.html