Класс PropertyDescriptor
- java.lang.Object
-
- java.beans.FeatureDescriptor
-
- java.beans.PropertyDescriptor
- Прямые известные подклассы:
- IndexedPropertyDescriptor
public class PropertyDescriptor extends FeatureDescriptor
Объект PropertyDescriptor описывает одно свойство, экспортируемое Java Bean с помощью пары методов-акцессоров.
Конструкторы
| Конструктор и описание |
|---|
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) Сравнивает этот |
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) Устанавливает метод, который должен использоваться для записи значения свойства. |
Методы, унаследованные от класса 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- если метод чтения недействителен
getWriteMethod
public Method getWriteMethod()
Получает метод, который должен использоваться для записи значения свойства.
- Возвращает:
- Метод, который должен использоваться для записи значения свойства. Может возвращать null, если свойство недоступно для записи.
setWriteMethod
public void setWriteMethod(Method writeMethod)
throws IntrospectionException Устанавливает метод, который должен использоваться для записи значения свойства.
- Параметры:
-
writeMethod- Новый метод записи. - Исключения:
-
IntrospectionException- если метод записи недействителен
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", означая, что нет специального редактора, и PropertyEditorManager следует использовать для поиска подходящего PropertyEditor.
createPropertyEditor
public PropertyEditor createPropertyEditor(Object bean)
Создаёт экземпляр редактора свойств, используя текущий класс редактора свойств.
Если класс редактора свойств имеет публичный конструктор, принимающий аргумент Object, то он будет вызван с параметром бинга в качестве аргумента. В противном случае будет вызван конструктор по умолчанию.
- Параметры:
-
bean- Объект-источник. - Возвращает:
- Экземпляр редактора свойств или null, если редактор свойств не определён или не может быть создан.
- С:
- 1.5
equals
public boolean equals(Object obj)
Сравнивает этот PropertyDescriptor с заданным объектом. Возвращает true, если объекты идентичны. Два PropertyDescriptor идентичны, если методы чтения, записи, типы свойств, редактор свойств и флаги эквивалентны.
- Переопределяет:
-
equalsв классеObject - Параметры:
-
obj- Сравниваемый объект-ссылка. - Возвращает:
-
trueесли этот объект идентичен аргументу obj;falseв противном случае. - С:
- 1.4
- См. также:
-
Object.hashCode(),HashMap
hashCode
public int hashCode()
Возвращает хеш-код объекта. См. Object.hashCode() для полного описания.
- Переопределяет:
-
hashCodeв классеObject - Возвращает:
- Хеш-код этого объекта.
- С:
- 1.5
- См. также:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
© 1993, 2020, 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.