java.beans

クラス Expression

java.lang.Object

java.beans.Statement

java.beans.Expression

public class Expression
extends Statement

Expression オブジェクトは、"a.getFoo()" のように、ターゲットと一連の引数に単一のメソッドが適用されて、結果が返されるプリミティブな式を表します。

Expression オブジェクトは、スーパークラスのプロパティーだけでなく、値 (この式の評価時に返されるオブジェクト) も提供します。通常、この戻り値は呼び出し元から提供されるのではなく、メソッドを動的に検索し、初めて getValue を呼び出すときにそのメソッドを呼び出すことによって計算されます。

導入されたバージョン:

1.4

関連項目:

getValue(), setValue(java.lang.Object)

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Expression(Object value, Object target, String methodName, Object[] arguments) 指定されたターゲットオブジェクトの指定された値を使って新しい Expression オブジェクトを作成して、名前、および引数の配列で指定されたメソッドを呼び出します。
Expression(Object target, String methodName, Object[] arguments) 指定されたターゲットオブジェクトの新しい Expression オブジェクトを作成して、名前、および引数の配列で指定されたメソッドを呼び出します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	execute() execute メソッドは、methodName プロパティーと同じ名前のメソッドを検索し、ターゲットに対してそのメソッドを呼び出します。
Object	getValue() このインスタンスの value プロパティーがまだ設定されていない場合、このメソッドは引数を使って、ターゲット上の指定された methodName からメソッドを動的に検索し、呼び出します。
void	setValue(Object value) この式の値を value に設定します。
String	toString() Java スタイルの構文を使って、この式の値を出力します。

クラス java.beans.Statement から継承されたメソッド

getArguments, getMethodName, getTarget

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

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

コンストラクタの詳細

Expression

@ConstructorProperties(value={"target","methodName","arguments"})
public Expression(Object target,
                                     String methodName,
                                     Object[] arguments)

指定されたターゲットオブジェクトの新しい Expression オブジェクトを作成して、名前、および引数の配列で指定されたメソッドを呼び出します。

target および methodName の値を null にしないでください。そうしない場合、この Expression の実行を試みると、NullPointerException が発生します。arguments 値が null の場合は、空の配列が arguments プロパティーの値として使用されます。

パラメータ:

target - この式のターゲットオブジェクト

methodName - 指定されたターゲットに対して呼び出すメソッドの名前

arguments - 指定されたメソッドを呼び出す引数の配列

関連項目:

getValue()

Expression

public Expression(Object value,
          Object target,
          String methodName,
          Object[] arguments)

指定されたターゲットオブジェクトの指定された値を使って新しい Expression オブジェクトを作成して、名前、および引数の配列で指定されたメソッドを呼び出します。value 値が value プロパティーの値として使用されるため、getValue() メソッドはこの Expression を実行せずにそれを返します。

target および methodName の値を null にしないでください。そうしない場合、この Expression の実行を試みると、NullPointerException が発生します。arguments 値が null の場合は、空の配列が arguments プロパティーの値として使用されます。

パラメータ:

value - この式の値

target - この式のターゲットオブジェクト

methodName - 指定されたターゲットに対して呼び出すメソッドの名前

arguments - 指定されたメソッドを呼び出す引数の配列

関連項目:

setValue(java.lang.Object)

メソッドの詳細

execute

public void execute()
             throws Exception

execute メソッドは、methodName プロパティーと同じ名前のメソッドを検索し、ターゲットに対してそのメソッドを呼び出します。 ターゲットのクラスが指定の名前で複数のメソッドを定義している場合、実装は『Java 言語仕様 (15.11)』に規定されているアルゴリズムを使って、もっとも本質的なメソッドを選択しなければいけません。コンパイル時の型情報の代わりにターゲットと引数の動的クラスが使用され、Method クラスそのものと同様に、プリミティブ値とその関連ラッパークラス間の変換は内部で処理されます。

次のメソッド型は、特殊なケースとして処理されます。

• クラスオブジェクトをターゲットとして使用することにより静的メソッドが呼び出される。
• 予約されたメソッド名「new」を使用し、あたかもすべてのクラスが静的な「new」メソッドを定義しているかのようにクラスのコンストラクタを呼び出す。通常、コンストラクタの呼び出しは値を返すため、Statement ではなく Expression とみなされます。
• List インタフェースに定義されているメソッド名「get」および「set」が配列のインスタンスにも適用されて、Array クラスにある同じ名前の静的メソッドにマッピングされます。

呼び出されたメソッドが正常に完了した場合は、そのメソッドが返した値が value プロパティーにコピーされます。基本となるメソッドの戻り型が void の場合は、value プロパティーに null が設定されます。

オーバーライド:

execute、クラス: Statement

例外:

NullPointerException - target または methodName プロパティーの値が null の場合

NoSuchMethodException - 一致するメソッドが見つからない場合

SecurityException - セキュリティーマネージャーが存在し、それがメソッドの呼び出しを拒否する場合

Exception - 呼び出されたメソッドによってスローされます

導入されたバージョン:

1.7

関連項目:

Method

getValue

public Object getValue()
                throws Exception

このインスタンスの value プロパティーがまだ設定されていない場合、このメソッドは引数を使って、ターゲット上の指定された methodName からメソッドを動的に検索し、呼び出します。このメソッド呼び出しの結果は、この式の value プロパティーにコピーされたあと、getValue の結果として返されます。value プロパティーがすでに設定されている場合は、setValue の呼び出しか、以前の getValue の呼び出しにより、value プロパティーが返されます。この場合、メソッドの検索や呼び出しは不要です。

デフォルトでは、Expression の value プロパティーは非公開の一意の値 (null 以外) になり、メソッドがまだ呼び出されていないことを内部的に示します。戻り値 null は、その他の値と同様にこのデフォルト値を置き換えます。このため、式の評価回数が 2 回以上になることはありません。

動的なターゲットおよび引数によるメソッドの選択方法の詳細については、excecute メソッドを参照してください。

戻り値:

このメソッドを引数に適用した結果。

例外:

Exception

関連項目:

Statement.execute(), setValue(java.lang.Object)

setValue

public void setValue(Object value)

この式の値を value に設定します。この値は getValue メソッドから返されます。このとき、この式に関連付けられているメソッドが呼び出されることはありません。

パラメータ:

value - この式の値。

関連項目:

getValue()

toString

public String toString()

Java スタイルの構文を使って、この式の値を出力します。

オーバーライド:

toString、クラス: Statement

戻り値:

このオブジェクトの文字列表現。