Spec-Zone.ru › OpenJDK 21

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

Since:
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, 2023, 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/21/docs/api/java.desktop/java/beans/PropertyEditorManager.html

Spec-Zone.ru

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