java.rmi.activation
クラス ActivationDesc

java.lang.Object
  |
  +--java.rmi.activation.ActivationDesc

public final class ActivationDesc

extends Object

implements Serializable

起動記述子には、オブジェクトを起動するために必要な情報が格納されています。

• オブジェクトのグループ識別子
• オブジェクトのクラス名
• オブジェクトのコードの位置 (クラスの位置)
• オブジェクト固有の初期化データが格納されている、「整列化された」オブジェクト

記述子によって指定されたオブジェクトを作成し直したり、起動したりするには、起動システムに登録された記述子を使います。オブジェクトの記述子にある MarshalledObject が、2 番目の引数として、再初期化時あるいは起動時にオブジェクトが使うリモートオブジェクトのコンストラクタに渡されます。

導入されたバージョン:

JDK1.2

関連項目:

Activatable, 直列化された形式

コンストラクタの概要

ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject data)
クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。

ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject data, boolean restart)
クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。

ActivationDesc(String className, String location, MarshalledObject data)
クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。

ActivationDesc(String className, String location, MarshalledObject data, boolean restart)
クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。

メソッドの概要

boolean	equals(Object obj) 2 つの起動記述子の内容を比較します。
String	getClassName() 記述子で指定されたオブジェクトが使うクラス名を返します。
MarshalledObject	getData() 記述子で指定されたオブジェクトが使う初期化データまたは起動データがある「整列化されたオブジェクト」を返します。
ActivationGroupID	getGroupID() 記述子で指定されたオブジェクトが使うグループ識別子を返します。
String	getLocation() 記述子で指定されたオブジェクトが使うコードの位置を返します。
boolean	getRestartMode() 起動記述子に関連付けられたオブジェクトの「再起動」モードを返します。
int	hashCode() 同様の ActivationDesc に対して同じハッシュコードを返します。

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

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

コンストラクタの詳細

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject data)
               throws ActivationException

クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。この形式のコンストラクタを使用する場合、groupID のデフォルトは、この VM の ActivationGroup の現在の ID になります。ActivationGroupID が同じオブジェクトはすべて、同じ VM の中で起動されます。このコンストラクタで構築した記述子で指定されたオブジェクトは、RMI 起動デーモンが開始しても、自動的に再起動されることはありません。起動可能なオブジェクトへのメソッド呼び出しにより、要求に応じて起動されます。

このコンストラクタは、この VM の現在の起動グループがない場合は ActivationException をスローします。ActivationGroup を作成するには、ActivationGroup.createGroup メソッドを使います。

パラメータ:

className - オブジェクトの、パッケージ名が完全指定されたクラス名

location - オブジェクトのコードの位置 (クラスのロード元の位置)

data - 整列化された形式で格納されている、オブジェクトの初期化 (起動) データ

例外:

ActivationException - 現在のグループが存在しない場合

導入されたバージョン:

JDK1.2

ActivationDesc

public ActivationDesc(String className,
                      String location,
                      MarshalledObject data,
                      boolean restart)
               throws ActivationException

クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。この形式のコンストラクタを使用する場合、groupID のデフォルトは、この VM の ActivationGroup の現在の ID になります。ActivationGroupID が同じオブジェクトはすべて、同じ VM の中で起動されます。

このコンストラクタは、この VM の現在の起動グループがない場合は ActivationException をスローします。ActivationGroup を作成するには、ActivationGroup.createGroup メソッドを使います。

パラメータ:

className - オブジェクトの、パッケージ名が完全指定されたクラス名

location - オブジェクトのコードの位置 (クラスのロード元の位置)

data - 整列化された形式で格納されている、オブジェクトの初期化 (起動) データ

restart - true の場合は、アクティベータが再起動したときに、オブジェクトも起動される。false の場合は、オブジェクトは要求に応じて起動される

例外:

ActivationException - 現在のグループが存在しない場合

導入されたバージョン:

JDK1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject data)

クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。groupID が同じオブジェクトはすべて、同じ VM の中で起動されます。

パラメータ:

groupID - グループの識別子。ActivationSystem.registerGroup メソッドの登録から取得される。グループは、オブジェクトが起動される VM を指定する

className - オブジェクトの、パッケージ名が完全指定されたクラス名

location - オブジェクトのコードの位置 (クラスのロード元の位置)

data - 整列化された形式で格納されている、オブジェクトの初期化 (起動) データ

例外:

IllegalArgumentException - groupID が null の場合

導入されたバージョン:

JDK1.2

ActivationDesc

public ActivationDesc(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject data,
                      boolean restart)

クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。groupID が同じオブジェクトはすべて、同じ VM の中で起動されます。

パラメータ:

groupID - グループの識別子。ActivationSystem.registerGroup メソッドの登録から取得される。グループは、オブジェクトが起動される VM を指定する

className - オブジェクトの、パッケージ名が完全指定されたクラス名

location - オブジェクトのコードの位置 (クラスのロード元の位置)

data - 整列化された形式で格納されている、オブジェクトの初期化 (起動) データ

restart - true の場合は、アクティベータが再起動したときに、オブジェクトも起動される。false の場合は、オブジェクトは要求に応じて起動される

例外:

IllegalArgumentException - groupID が null の場合

導入されたバージョン:

JDK1.2

メソッドの詳細

getGroupID

public ActivationGroupID getGroupID()

記述子で指定されたオブジェクトが使うグループ識別子を返します。グループは、複数のオブジェクトを単一の Java Virtual Machine に集合させる方法を提供します。RMI は、1 つの Virtual Machine 内で、同じ groupID を持つ複数のオブジェクトを作成または起動します。

戻り値:

グループ識別子

導入されたバージョン:

JDK1.2

getClassName

public String getClassName()

記述子で指定されたオブジェクトが使うクラス名を返します。

戻り値:

クラス名

導入されたバージョン:

JDK1.2

getLocation

public String getLocation()

記述子で指定されたオブジェクトが使うコードの位置を返します。

戻り値:

コードの位置

導入されたバージョン:

JDK1.2

getData

public MarshalledObject getData()

記述子で指定されたオブジェクトが使う初期化データまたは起動データがある「整列化されたオブジェクト」を返します。

戻り値:

オブジェクト固有の「初期化」データ

導入されたバージョン:

JDK1.2

getRestartMode

public boolean getRestartMode()

起動記述子に関連付けられたオブジェクトの「再起動」モードを返します。

戻り値:

起動記述子に関連付けられた起動可能なオブジェクトが、起動デーモンの起動時に一緒に再起動される場合は true、そうでない場合は false。オブジェクトは、メソッド呼び出しによる要求に応じてのみ起動される

導入されたバージョン:

JDK1.2

equals

public boolean equals(Object obj)

2 つの起動記述子の内容を比較します。

パラメータ:

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

戻り値:

2 つのオブジェクトが等しい場合は true、そうでない場合は false

オーバーライド:

クラス Object 内の equals

導入されたバージョン:

JDK1.2

関連項目:

Hashtable

hashCode

public int hashCode()

同様の ActivationDesc に対して同じハッシュコードを返します。

戻り値:

整数値

オーバーライド:

クラス Object 内の hashCode

関連項目:

Hashtable