Класс PropertyDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.PropertyDescriptor

Прямые известные подклассы:: IndexedPropertyDescriptor

public class PropertyDescriptor extends FeatureDescriptor

Класс PropertyDescriptor описывает одно свойство, которое Java Bean экспортирует через пару методов-аксессоров.

С:: 1.1

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

Конструктор	Описание
`PropertyDescriptor(String propertyName, Class<?> beanClass)`	Создаёт PropertyDescriptor для свойства, которое следует стандартной Java-конвенции, имея методы-аксессоры getFoo и setFoo.
`PropertyDescriptor(String propertyName, Class<?> beanClass, String readMethodName, String writeMethodName)`	Этот конструктор принимает имя простого свойства и имена методов для чтения и записи свойства.
`PropertyDescriptor(String propertyName, Method readMethod, Method writeMethod)`	Этот конструктор принимает имя простого свойства и объекты Method для чтения и записи свойства.

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

Модификатор и тип	Метод	Описание
`PropertyEditor`	`createPropertyEditor(Object bean)`	Создаёт экземпляр редактора свойств, используя текущий класс редактора свойств.
`boolean`	`equals(Object obj)`	Сравнивает этот `PropertyDescriptor` с указанным объектом.
`Class<?>`	`getPropertyEditorClass()`	Получает любой явный класс PropertyEditor, который был зарегистрирован для этого свойства.
`Class<?>`	`getPropertyType()`	Возвращает информацию о типе Java для свойства.
`Method`	`getReadMethod()`	Получает метод, который должен использоваться для чтения значения свойства.
`Method`	`getWriteMethod()`	Получает метод, который должен использоваться для записи значения свойства.
`int`	`hashCode()`	Возвращает хэш-код для объекта.
`boolean`	`isBound()`	Обновления «связанных» свойств вызовут событие «PropertyChange», когда свойство изменится.
`boolean`	`isConstrained()`	Попытки обновления «ограниченных» свойств вызовут событие «VetoableChange», когда свойство изменится.
`void`	`setBound(boolean bound)`	Обновления «связанных» свойств вызовут событие «PropertyChange», когда свойство изменится.
`void`	`setConstrained(boolean constrained)`	Попытки обновления «ограниченных» свойств вызовут событие «VetoableChange», когда свойство изменится.
`void`	`setPropertyEditorClass(Class<?> propertyEditorClass)`	Обычно PropertyEditors находятся с помощью PropertyEditorManager.
`void`	`setReadMethod(Method readMethod)`	Устанавливает метод, который должен использоваться для чтения значения свойства.
`void`	`setWriteMethod(Method writeMethod)`	Устанавливает метод, который должен использоваться для записи значения свойства.

Методы, объявленные в классе java.beans.FeatureDescriptor

attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setDisplayName, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

PropertyDescriptor

public PropertyDescriptor(String propertyName, Class<?> beanClass) throws IntrospectionException

Создаёт PropertyDescriptor для свойства, следующего стандартной Java-конвенции, имеющей методы-аксессоры getFoo и setFoo. Таким образом, если имя аргумента «fred», предполагается, что метод записи — «setFred», а метод чтения — «getFred» (или «isFred» для булевого свойства). Обратите внимание, что имя свойства должно начинаться с строчной буквы, которая будет прописной в именах методов.

Параметры:: propertyName - Программное имя свойства.; beanClass - Объект класса целевого бинa. Например, sun.beans.OurButton.class.
Исключения:: IntrospectionException - если во время интроспекции произошла ошибка.

PropertyDescriptor

public PropertyDescriptor(String propertyName, Class<?> beanClass, String readMethodName, String writeMethodName) throws IntrospectionException

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

Параметры:: propertyName - Программное имя свойства.; beanClass - Объект класса целевого бинa. Например, sun.beans.OurButton.class.; readMethodName - Имя метода, используемого для чтения значения свойства. Может быть null, если свойство только для записи.; writeMethodName - Имя метода, используемого для записи значения свойства. Может быть null, если свойство только для чтения.
Исключения:: IntrospectionException - если во время интроспекции произошла ошибка.

PropertyDescriptor

public PropertyDescriptor(String propertyName, Method readMethod, Method writeMethod) throws IntrospectionException

Этот конструктор принимает имя простого свойства и объекты Method для чтения и записи свойства.

Параметры:: propertyName - Программное имя свойства.; readMethod - Метод, используемый для чтения значения свойства. Может быть null, если свойство только для записи.; writeMethod - Метод, используемый для записи значения свойства. Может быть null, если свойство только для чтения.
Исключения:: IntrospectionException - если во время интроспекции произошла ошибка.

Подробное описание методов

getPropertyType

public Class<?> getPropertyType()

Возвращает информацию о типе Java для свойства. Обратите внимание, что объект Class может описывать примитивные типы Java, такие как int. Этот тип возвращается методом чтения или используется как тип параметра метода записи. Возвращает null, если свойство индексированное и не поддерживает доступ без индекса.

Возвращает:: объект Class, представляющий информацию о типе Java, или null, если тип определить нельзя

getReadMethod

public Method getReadMethod()

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

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

setReadMethod

public void setReadMethod(Method readMethod) throws IntrospectionException

Устанавливает метод, который должен использоваться для чтения значения свойства.

Параметры:: readMethod - Новый метод чтения.
Исключения:: IntrospectionException - если метод чтения некорректен
С момента:: 1.2

getWriteMethod

public Method getWriteMethod()

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

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

setWriteMethod

public void setWriteMethod(Method writeMethod) throws IntrospectionException

Устанавливает метод, который должен использоваться для записи значения свойства.

Параметры:: writeMethod - Новый метод записи.
Исключения:: IntrospectionException - если метод записи некорректен
С момента:: 1.2

isBound

public boolean isBound()

Обновления "привязанных" свойств вызовут событие "PropertyChange" при изменении свойства.

Возвращает:: Истинно, если это привязанное свойство.

setBound

public void setBound(boolean bound)

Обновления "привязанных" свойств вызовут событие "PropertyChange" при изменении свойства.

Параметры:: bound - Истинно, если это привязанное свойство.

isConstrained

public boolean isConstrained()

Попытки обновить "ограниченные" свойства вызовут событие "VetoableChange" при изменении свойства.

Возвращает:: Истинно, если это ограниченное свойство.

setConstrained

public void setConstrained(boolean constrained)

Попытки обновить "ограниченные" свойства вызовут событие "VetoableChange" при изменении свойства.

Параметры:: constrained - Истинно, если это ограниченное свойство.

setPropertyEditorClass

public void setPropertyEditorClass(Class<?> propertyEditorClass)

Обычно PropertyEditors находятся с помощью PropertyEditorManager. Однако, если по какой-либо причине вы хотите связать определённый PropertyEditor с заданным свойством, вы можете сделать это с помощью этого метода.

Параметры:: propertyEditorClass - Класс желаемого PropertyEditor.

getPropertyEditorClass

public Class<?> getPropertyEditorClass()

Получает явным образом зарегистрированный класс PropertyEditor для данного свойства.

Возвращает:: Любой явным образом зарегистрированный класс PropertyEditor для данного свойства. Обычно возвращается "null", указывая, что ни один специальный редактор не зарегистрирован, поэтому для поиска подходящего PropertyEditor следует использовать PropertyEditorManager.

createPropertyEditor

public PropertyEditor createPropertyEditor(Object bean)

Создаёт экземпляр редактора свойств, используя текущий класс редактора свойств.

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

Параметры:: bean - исходный объект
Возвращает:: экземпляр редактора свойств или null, если редактор свойств не определён или не может быть создан
С момента:: 1.5

equals

public boolean equals(Object obj)

Сравнивает этот PropertyDescriptor с указанным объектом. Возвращает true, если объекты идентичны. Два PropertyDescriptor идентичны, если методы чтения, записи, типы свойств, редактор свойств и флаги эквивалентны.

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

equals в классе Object

Параметры:

obj - объект-ссылка для сравнения.

Возвращает:

true, если этот объект идентичен аргументу obj; false в противном случае.

С момента:

1.4

См. также:

hashCode

public int hashCode()

Возвращает значение хэш-кода для объекта. См. Object.hashCode() для полного описания.

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

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

С момента:

1.5

См. также:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/beans/PropertyDescriptor.html