java.beans

クラス Statement

java.lang.Object

java.beans.Statement

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

Expression

public class Statement
extends Object

Statement オブジェクトは、"a.setFoo(b)" のように、ターゲットと一連の引数に単一のメソッドが適用されるプリミティブな文を表します。この例ではターゲットとその引数を示す名前を使用していますが、Statement オブジェクトは名前空間を必要とせず、値自体で構成されます。Statement オブジェクトは、指定されたメソッドを単純な値のセット (ターゲットと引数の値の配列) として、その環境に関連付けます。

導入されたバージョン:

1.4

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	execute() execute メソッドは、methodName プロパティーと同じ名前のメソッドを検索し、ターゲットに対してそのメソッドを呼び出します。
Object[]	getArguments() 呼び出すメソッドの引数を返します。
String	getMethodName() 呼び出すメソッドの名前を返します。
Object	getTarget() この文のターゲットオブジェクトを返します。
String	toString() Java スタイルの構文を使って、この文の値を出力します。

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

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

コンストラクタの詳細

Statement

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

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

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

パラメータ:

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

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

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

メソッドの詳細

getTarget

public Object getTarget()

この文のターゲットオブジェクトを返します。このメソッドが null を返す場合は、execute() メソッドによって NullPointerException がスローされます。

戻り値:

この文のターゲットオブジェクト

getMethodName

public String getMethodName()

呼び出すメソッドの名前を返します。このメソッドが null を返す場合は、execute() メソッドによって NullPointerException がスローされます。

戻り値:

メソッドの名前

getArguments

public Object[] getArguments()

呼び出すメソッドの引数を返します。引数の数とその型は、呼び出されるメソッドと一致する必要があります。空の配列の同義として null を使用できます。

戻り値:

引数の配列

execute

public void execute()
             throws Exception

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

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

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

例外:

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

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

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

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

関連項目:

Method

toString

public String toString()

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

オーバーライド:

toString、クラス: Object

戻り値:

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