Класс PropertyDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.PropertyDescriptor

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

public class PropertyDescriptor extends FeatureDescriptor

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

Начиная с:: 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

Модификатор и тип	Метод	Описание
`Enumeration<String>`	`attributeNames()`	Возвращает перечисление локально-независимых имен этого элемента.
`String`	`getDisplayName()`	Возвращает локализованное отображаемое имя этого элемента.
`String`	`getName()`	Возвращает программное имя этого элемента.
`String`	`getShortDescription()`	Возвращает краткое описание этого элемента.
`Object`	`getValue(String attributeName)`	Получает именованный атрибут этого элемента.
`boolean`	`isExpert()`	Флаг "expert" используется для отделения элементов, предназначенных для опытных пользователей, от элементов, предназначенных для обычных пользователей.
`boolean`	`isHidden()`	Флаг "hidden" используется для обозначения элементов, предназначенных только для использования инструментами и не подлежащих отображению пользователям.
`boolean`	`isPreferred()`	Флаг "preferred" используется для обозначения элементов, которые особенно важно показывать пользователям.
`void`	`setDisplayName(String displayName)`	Задает локализованное отображаемое имя этого элемента.
`void`	`setExpert(boolean expert)`	Флаг "expert" используется для отделения элементов, предназначенных для опытных пользователей, от элементов, предназначенных для обычных пользователей.
`void`	`setHidden(boolean hidden)`	Флаг "hidden" используется для обозначения элементов, предназначенных только для использования инструментами и не подлежащих отображению пользователям.
`void`	`setName(String name)`	Задает программное имя этого элемента.
`void`	`setPreferred(boolean preferred)`	Флаг "preferred" используется для обозначения элементов, которые особенно важно показывать пользователям.
`void`	`setShortDescription(String text)`	Элементу можно сопоставить краткую описательную строку.
`void`	`setValue(String attributeName, Object value)`	Сопоставляет этому элементу именованный атрибут.
`String`	`toString()`	Возвращает строковое представление объекта.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

PropertyDescriptor

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

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

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

PropertyDescriptor

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

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

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

Параметры:: 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.