Класс PropertyDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.PropertyDescriptor

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

public class PropertyDescriptor extends FeatureDescriptor

PropertyDescriptor описывает одно свойство, предоставляемое Java-компонентом с помощью пары методов доступа.

С версии:: 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)`	Обычно редакторы свойств находятся с помощью PropertyEditorManager.
`void`	`setReadMethod(Method readMethod)`	Задает метод, который следует использовать для чтения значения свойства.
`void`	`setWriteMethod(Method writeMethod)`	Задает метод, который следует использовать для записи значения свойства.

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

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

Методы, объявленные в классе 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" для свойства типа boolean). Обратите внимание: имя свойства должно начинаться со строчной буквы; в именах методов она будет преобразована в прописную.

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

PropertyDescriptor

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

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

Параметры:: propertyName — Программное имя свойства.; beanClass — Объект Class целевого компонента. Например, 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».

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

setBound

public void setBound(boolean bound)

При изменении «связанных» свойств генерируется событие «PropertyChange».

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

isConstrained

public boolean isConstrained()

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

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

setConstrained

public void setConstrained(boolean constrained)

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

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

setPropertyEditorClass

public void setPropertyEditorClass(Class<?> propertyEditorClass)

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

Параметры:: propertyEditorClass — Класс требуемого PropertyEditor.

getPropertyEditorClass

public Class<?> getPropertyEditorClass()

Возвращает явно зарегистрированный для этого свойства класс PropertyEditor, если он есть.

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

createPropertyEditor

public PropertyEditor createPropertyEditor(Object bean)

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

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

Параметры:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/beans/PropertyDescriptor.html