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 であるオブジェクトが使うオブジェクト記述子を構築します。

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 の中で起動されます。

このコンストラクタで作成した記述子を使って指定されたオブジェクトは、要求に応じて (デフォルトでは再起動モードが 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 が同じオブジェクトはすべて、同じ 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 が同じオブジェクトはすべて、同じ VM の中で起動されます。

パラメータ:

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

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

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

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

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

例外:

IllegalArgumentException - groupID が null の場合

導入されたバージョン:

1.2

メソッドの詳細

getGroupID

public ActivationGroupID getGroupID()

記述子で指定されたオブジェクトが使うグループ識別子を返します。グループは、複数のオブジェクトを単一の 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 つの起動記述子の内容を比較します。

オーバーライド:

クラス Object 内の equals

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.2

関連項目:

Hashtable

hashCode

public int hashCode()

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

オーバーライド:

クラス Object 内の hashCode

戻り値:

整数型

関連項目:

Hashtable