java.beans
クラス PropertyDescriptor

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

直系の既知のサブクラス:

IndexedPropertyDescriptor

public class PropertyDescriptor

extends FeatureDescriptor

PropertyDescriptor は、Java Bean が一対のアクセス用メソッドを使ってエクスポートする単一のプロパティを記述します。

コンストラクタの概要

PropertyDescriptor(String propertyName, Class beanClass)
アクセス用メソッド getFoo および setFoo を使って、標準の Java 規約に準拠しているプロパティの PropertyDescriptor を構築します。

PropertyDescriptor(String propertyName, Class beanClass, String getterName, String setterName)
このコンストラクタは、単純なプロパティ名と、プロパティの読み込みおよび書き込み用のメソッド名を引数に取ります。

PropertyDescriptor(String propertyName, Method getter, Method setter)
このコンストラクタは、単純なプロパティ名と、プロパティの読み込みおよび書き込み用の Method オブジェクトを引数に取ります。

メソッドの概要

boolean	equals(Object obj) PropertyDescriptor と指定されたオブジェクトを照合します。
Class	getPropertyEditorClass() このプロパティの明示的な登録済み PropertyEditor クラスを取得します。
Class	getPropertyType() プロパティの Class オブジェクトを取得します。
Method	getReadMethod() プロパティ値の読み込みに使用するメソッドを取得します。
Method	getWriteMethod() プロパティ値の書き込みに使用するメソッドを取得します。
boolean	isBound() バウンドプロパティを更新し、プロパティの変更時に PropertyChange イベントがトリガされるようにします。
boolean	isConstrained() 制約プロパティの更新を試み、プロパティの変更時に VetoableChange イベントがトリガされるようにします。
void	setBound(boolean bound) バウンドプロパティを更新し、プロパティの変更時に PropertyChange イベントがトリガされるようにします。
void	setConstrained(boolean constrained) 制約プロパティの更新を試み、プロパティの変更時に VetoableChange イベントがトリガされるようにします。
void	setPropertyEditorClass(Class propertyEditorClass) 通常、PropertyEditor は PropertyEditorManager を使って検索されますが、何らかの理由により特定の PropertyEditor を指定プロパティに関連付けたい場合は、このメソッドを使用できます。
void	setReadMethod(Method getter) プロパティ値の読み込みに使用するメソッドを設定します。
void	setWriteMethod(Method setter) プロパティ値の書き込みに使用するメソッドを設定します。

クラス java.beans.FeatureDescriptor から継承したメソッド

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

クラス java.lang.Object から継承したメソッド

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PropertyDescriptor

public PropertyDescriptor(String propertyName,
                          Class beanClass)
                   throws IntrospectionException

アクセス用メソッド getFoo および setFoo を使って、標準の Java 規約に準拠しているプロパティの PropertyDescriptor を構築します。引数名が fred であれば、書き込み用メソッドは setFred、読み込み用メソッドは getFred (boolean プロパティでは isFred) になります。プロパティ名は必ず小文字で始まりますが、メソッド名では先頭文字が大文字になることに注意してください。

パラメータ:

propertyName - プロパティのプログラム名

beanClass - ターゲット bean の Class オブジェクト。たとえば、sun.beans.OurButton.class

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

PropertyDescriptor

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 - イントロスペクション中に例外が発生した場合

PropertyDescriptor

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

このコンストラクタは、単純なプロパティ名と、プロパティの読み込みおよび書き込み用の Method オブジェクトを引数に取ります。

パラメータ:

propertyName - プロパティのプログラム名

getter - プロパティ値の読み込みに使用するメソッド。プロパティが書き込み専用の場合は null

setter - プロパティ値の書き込みに使用するメソッド。プロパティが読み込み専用の場合は null

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

メソッドの詳細

getPropertyType

public Class getPropertyType()

プロパティの Class オブジェクトを取得します。

戻り値:

プロパティの Java 型情報。Class オブジェクトは、int などの組み込みの Java 型を記述する場合があるので注意する。インデックスなしアクセスをサポートしないインデックス付きプロパティの場合、結果は null になる

ReadMethod が返す型

getReadMethod

public Method getReadMethod()

プロパティ値の読み込みに使用するメソッドを取得します。

戻り値:

プロパティ値の読み込みに使用するメソッド。プロパティを読み込めない場合は null

setReadMethod

public void setReadMethod(Method getter)
                   throws IntrospectionException

プロパティ値の読み込みに使用するメソッドを設定します。

パラメータ:

getter - 新しい get メソッド

IntrospectionException

getWriteMethod

public Method getWriteMethod()

プロパティ値の書き込みに使用するメソッドを取得します。

戻り値:

プロパティ値の書き込みに使用するメソッド。プロパティを書き込めない場合は null

setWriteMethod

public void setWriteMethod(Method setter)
                    throws IntrospectionException

プロパティ値の書き込みに使用するメソッドを設定します。

パラメータ:

setter - 新しい set メソッド

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)

通常、PropertyEditor は PropertyEditorManager を使って検索されますが、何らかの理由により特定の PropertyEditor を指定プロパティに関連付けたい場合は、このメソッドを使用できます。

パラメータ:

propertyEditorClass - PropertyEditor の Class

getPropertyEditorClass

public Class getPropertyEditorClass()

このプロパティの明示的な登録済み PropertyEditor クラスを取得します。

戻り値:

このプロパティの明示的な登録済み PropertyEditor クラス。通常は、特別なエディタが登録されていないため PropertyEditorManager を使って適切な PropertyEditor を検索するべきであることを示す null が返される

equals

public boolean equals(Object obj)

PropertyDescriptor と指定されたオブジェクトを照合します。両者が等価である場合、true を返します。読み取り、書き込み、プロパティの型、プロパティエディタ、フラグが等しければ、2 つの PropertyDescriptor は等価です。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象の参照オブジェクト

戻り値:

obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false

導入されたバージョン:

1.4

関連項目:

Object.hashCode(), Hashtable