类 java.beans.PropertyDescriptor

java.lang.Object
   |
   +----java.beans.FeatureDescriptor
           |
           +----java.beans.PropertyDescriptor

public class PropertyDescriptor

extends FeatureDescriptor

下列类的父类：

IndexedPropertyDescriptor

PropertyDescriptor 描述通过访问者方法对 Java Bean 所导出的一个特性。

构造子索引

PropertyDescriptor(String, Class)

为某特性构造 PropertyDescriptor ，它通过拥有 getFoo 和 setFoo 访问者方法来遵循标准 Java 约定。

PropertyDescriptor(String, Class, String, String)

该构造子采用简单特性名和读写该特性方法名。

PropertyDescriptor(String, Method, Method)

该构造子采用简单特性名和读写特性的 Method 对象。

方法索引

getPropertyEditorClass()

getPropertyType()

getReadMethod()

getWriteMethod()

isBound()

当特性改变时，更新“绑定”特性将导致激发一个“PropertyChange ”事件。

isConstrained()

当特性改变时，试图更新“限制”特性将导致激发一个“VetoableChange”事件。

setBound(boolean)

当特性改变时，更新“绑定”特性将导致激发一个“PropertyChange”事件。

setConstrained(boolean)

当特性改变时，试图更新“限制”特性将导致激发一个“VetoableChange”事件。

setPropertyEditorClass(Class)

通常使用 PropertyEditorManager 将找到 PropertyEditors 。

构造子

 public PropertyDescriptor(String propertyName,
                           Class beanClass) throws IntrospectionException

为某特性构造 PropertyDescriptor ，它通过拥有 getFoo 和 setFoo 访问者来遵循标准 Java 约定。因此若参数名是“fred”,则假定读程序方法是“getFred”并且写程序方法是“setFred”。注意特性名应以小写字符开始, 它将在方法名中被大写化。

参数：

propertyName - 特性的编程名。

beanClass - 目标 bean 的 Class 对象。例如 sun.beans.OurButton.class。

抛出： IntrospectionException

若内省时发生异常。

 public PropertyDescriptor(String propertyName,
                           Class beanClass,
                           String getterName,
                           String setterName) throws IntrospectionException

该构造子使用简单特性名和读写该特性的方法名。

参数：

propertyName - 特性的编程名。

beanClass - 目标 bean 的 Class 对象。例如 sun.beans.OurButton.class。

getterName - 读出特性值的方法的名字。若该特性为只写的，则可为 null。

setterName - 写出特性值的方法的名字。若该特性为只读的，则可为 null。

抛出： IntrospectionException

若内省时发生异常。

 public PropertyDescriptor(String propertyName,
                           Method getter,
                           Method setter) throws IntrospectionException

该构造子采用简单特性名和读写特性的 Method 对象。

参数：

propertyName - 特性的编程名。

getter - 读出特性值的方法。若该特性为只读的，则可为 null。

setter - 写出特性值的方法。若该特性为只读的，则可为 null。

抛出： IntrospectionException

若内省时发生异常。

方法

 public Class getPropertyType()

返回值：

特性的 Java 类型信息。注意 Class 对象可描述内置 Java 类型如“int”。若这是一个不支持非索引存取的索引特性，则结果可为“null”。

这是 ReadMethod 将返回的类型。

 public Method getReadMethod()

返回值：

应使用该方法来读特性值。若不能读该特性，则可返回 null 。

 public Method getWriteMethod()

返回值：

应使用该方法来写特性值。若不能写该特性，则可返回 null 。

 public boolean isBound()

当特性改变时，更新“绑定”特性将导致激发一个“PropertyChange”事件。

返回值：

若这是一个绑定特性，则为 true 。

 public void setBound(boolean bound)

当特性改变时，更新“绑定”特性将导致激发一个“PropertyChange”事件。

参数：

bound - 若这是一个绑定特性，则为 true 。

 public boolean isConstrained()

当特性改变时，试图更新“限制”特性将导致激发一个“VetoableChange”事件。

返回值：

若这是一个限制特性，则为 true 。

 public void setConstrained(boolean constrained)

当特性改变时，试图更新“限制”特性将导致激发一个“VetoableChange”事件。

参数：

constrained - 若这是一个限制特性，则为 true 。

 public void setPropertyEditorClass(Class propertyEditorClass)

通常使用 PropertyEditorManager 查找 PropertyEditors 。但由于某些原因若要将特定的 PropertyEditor 与给定特性相关联，则可用该方法实现。

参数：

propertyEditorClass - 期望的 PropertyEditor 的 Class 。

 public Class getPropertyEditorClass()

返回值：

已为该特性注册的显式 PropertyEditor Class 。通常这将返回“null”指示无特殊编辑器注册，因此应使用 PropertyEditorManager 来定位一个合适的 PropertyEditor。