Класс PropertyDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.PropertyDescriptor

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

public class PropertyDescriptor extends FeatureDescriptor

Описание свойства, которое 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)`	Обычно PropertyEditor ищут с помощью 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 - Объект 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)

Обычно PropertyEditors находятся с помощью 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, 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/PropertyDescriptor.html