java.rmi.activation

クラス ActivationDesc

java.lang.Object

java.rmi.activation.ActivationDesc

すべての実装されたインタフェース:

Serializable

public final class ActivationDesc
extends Object
implements Serializable

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

• オブジェクトのグループ識別子
• オブジェクトの、完全指定されたクラス名
• オブジェクトのコードの位置 (クラスの位置)、コードベース URL パス
• オブジェクトの再起動「モード」、および
• オブジェクト固有の初期化データが格納されている、「整列化された」オブジェクト

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

導入されたバージョン:

1.2

関連項目:

Activatable, 直列化された形式

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

コンストラクタ

コンストラクタと説明
ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data) クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。
ActivationDesc(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart) クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。
ActivationDesc(String className, String location, MarshalledObject<?> data) クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。
ActivationDesc(String className, String location, MarshalledObject<?> data, boolean restart) クラス名が className であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは location の位置のコードからロード可能であり、初期化情報は data です。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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 の中で起動されます。

このコンストラクタで作成した記述子を使って指定されたオブジェクトは、要求に応じて (デフォルトでは再起動モードが false) のみ起動されることに注意してください。起動可能なオブジェクトが再起動サービスを必要とする場合、boolean 型パラメータ restart を用いた ActivationDesc コンストラクタの一部を使用します。

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

パラメータ:

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

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

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

例外:

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

導入されたバージョン:

1.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 の場合は、オブジェクトは要求に応じて起動される。restart を true に指定しても、新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。

例外:

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

導入されたバージョン:

1.2

ActivationDesc

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

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

このコンストラクタで作成した記述子を使って指定されたオブジェクトは、要求に応じて (デフォルトでは再起動モードが false) のみ起動されることに注意してください。起動可能なオブジェクトが再起動サービスを必要とする場合、boolean 型パラメータ restart を用いた ActivationDesc コンストラクタの一部を使用します。

パラメータ:

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

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

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

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

例外:

IllegalArgumentException - groupID が null の場合

導入されたバージョン:

1.2

ActivationDesc

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

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

パラメータ:

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

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

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

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

restart - true の場合は、アクティベータが再起動したとき、または突然のクラッシュ後にオブジェクトの起動グループを再起動したときにオブジェクトも再起動される。false の場合は、オブジェクトは要求に応じて起動される。restart を true に指定しても、新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。

例外:

IllegalArgumentException - groupID が null の場合

導入されたバージョン:

1.2

メソッドの詳細

getGroupID

public ActivationGroupID getGroupID()

記述子で指定されたオブジェクトが使うグループ識別子を返します。グループは、複数のオブジェクトを 1 つの Java 仮想マシンにまとめる役割を果たします。RMI は、1 つの仮想マシン内で、同じ groupID を持つ複数のオブジェクトを作成または起動します。

戻り値:

グループの識別子

導入されたバージョン:

1.2

getClassName

public String getClassName()

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

戻り値:

クラス名

導入されたバージョン:

1.2

getLocation

public String getLocation()

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

戻り値:

コードの位置

導入されたバージョン:

1.2

getData

public MarshalledObject<?> getData()

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

戻り値:

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

導入されたバージョン:

1.2

getRestartMode

public boolean getRestartMode()

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

戻り値:

この起動記述子に関連付けられた起動可能なオブジェクトが、起動デーモンが再起動したとき、または突然のクラッシュ後にオブジェクトのグループが再起動されるときにそのデーモンを介して再起動される場合は true、それ以外の場合は false を返す。つまり、そのオブジェクトはメソッド呼び出し経由で要求された場合にのみ起動する。再起動モードが true の場合、アクティベータは新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。

導入されたバージョン:

1.2

equals

public boolean equals(Object obj)

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

オーバーライド:

equals、クラス: Object

パラメータ:

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

戻り値:

2 つの Object が等しい場合は true。そうでない場合は false

導入されたバージョン:

1.2

関連項目:

Hashtable

hashCode

public int hashCode()

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

オーバーライド:

hashCode、クラス: Object

戻り値:

整数型

関連項目:

Hashtable