JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。