javax.activation
クラス CommandInfo

java.lang.Object
  javax.activation.CommandInfo

public class CommandInfo
extends Object

CommandInfo クラスは、CommandMap 実装でコマンド要求の結果を記述するために使用されます。このクラスは、要求者に要求された動詞と bean のインスタンスの両方を提供します。また、コマンドを実装するクラスの名前を返すメソッドもありますが、有効な値が返される保証はありません。これは、CommandInfo をサブクラス化する CommandMap 実装が特殊な動作をするからです。たとえば、CommandMap は動的に JavaBeans を生成することができますが、この場合、クラス名だけですべての正しい状態情報を持つオブジェクトを作成できるとは限りません。

導入されたバージョン:

1.6

コンストラクタの概要

CommandInfo(String verb, String className)
CommandInfo のコンストラクタです。

メソッドの概要

String	getCommandClass() コマンドのクラス名を返します。
String	getCommandName() コマンドの動詞を返します。
Object	getCommandObject(DataHandler dh, ClassLoader loader) インスタンス化された JavaBean コンポーネントを返します。

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

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

コンストラクタの詳細

CommandInfo

public CommandInfo(String verb,
                   String className)

CommandInfo のコンストラクタです。

パラメータ:

verb - この CommandInfo が記述するコマンドの動詞

className - コマンドの完全指定されたクラス名

メソッドの詳細

getCommandName

public String getCommandName()

コマンドの動詞を返します。

戻り値:

コマンドの動詞

getCommandClass

public String getCommandClass()

コマンドのクラス名を返します。このメソッドは、CommandMap が独自の目的で CommandInfo をサブクラス化する場合に null を返すことがあります。つまり、クラス名を認識しているだけではコマンドの正しい状態を作成できるとは限りません。このメソッドが有効な値を返す保証はありません。

戻り値:

コマンドのクラス名、または null

getCommandObject

public Object getCommandObject(DataHandler dh,
                               ClassLoader loader)
                        throws IOException,
                               ClassNotFoundException

インスタンス化された JavaBean コンポーネントを返します。

まず、Beans.instantiate() を使ってコンポーネントをインスタンス化します。

bean が javax.activation.CommandObject インタフェースを実装する場合は、その setCommandContext メソッドを呼び出します。

DataHandler パラメータが null の場合、bean はデータを使わずにインスタンス化されます。注:これは、このメソッドがその InputStream にアクセスしようとしたときに、渡される DataHandler が何らかの理由で IOException をスローする場合に有用です。これによって呼び出し側は、bean がインスタンス化できれば、 bean への参照を取得できます。

bean が CommandObject インタフェースを実装しない場合、このメソッドは bean が java.io.Externalizable インタフェースを実装するかどうかをチェックします。実装する場合は、DataHandler から InputStream が取得できれば、bean の readExternal メソッドが呼び出されます。

パラメータ:

dh - コマンドに渡されるデータを記述する DataHandler

loader - bean のインスタンス化に使用される ClassLoader

戻り値:

bean

例外:

IOException

ClassNotFoundException

関連項目:

Beans.instantiate(java.lang.ClassLoader, java.lang.String), CommandObject