java.rmi.activation

クラス ActivationID

java.lang.Object

java.rmi.activation.ActivationID

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

Serializable

public class ActivationID
extends Object
implements Serializable

起動では、時間が経過しても起動可能なリモートオブジェクトに対して特別な識別子が使用されます。起動識別子 (ActivationID クラスのインスタンス) には、オブジェクトを起動するために必要な次のような情報が含まれています。

• オブジェクトのアクティベータへのリモート参照 (RemoteRef のインスタンス)
• オブジェクトの一意識別子 (UID のインスタンス)

オブジェクトの起動識別子は、オブジェクトを起動システムに登録することで取得できます。登録の方法は、複数あります。

• Activatable.register メソッドを使用
• 最初の Activatable コンストラクタを使用。このコンストラクタは、3 つの引数をとり、オブジェクトの登録とエクスポートの両方を実行する
• 最初の Activatable.exportObject メソッドを使用。引数としては、起動記述子、オブジェクト、およびポートをとる。このメソッドは、オブジェクトの登録、およびエクスポートの両方を実行する

導入されたバージョン:

1.2

関連項目:

Activatable, 直列化された形式

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

コンストラクタ

コンストラクタと説明
ActivationID(Activator activator) ActivationID のコンストラクタは、1 つの引数 activator をとります。この引数は、この識別子に関連したオブジェクトの起動にかかわるアクティベータへのリモート参照を指定します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Remote	activate(boolean force) 指定された ID のオブジェクトを起動します。
boolean	equals(Object obj) 2 つの起動 ID の内容を比較します。
int	hashCode() 起動 ID のハッシュコードを返します。

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

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

コンストラクタの詳細

ActivationID

public ActivationID(Activator activator)

ActivationID のコンストラクタは、1 つの引数 activator をとります。この引数は、この識別子に関連したオブジェクトの起動にかかわるアクティベータへのリモート参照を指定します。ActivationID のインスタンスは、大域的に一意です。

パラメータ:

activator - オブジェクトの起動にかかわるアクティベータへの参照

導入されたバージョン:

1.2

メソッドの詳細

activate

public Remote activate(boolean force)
                throws ActivationException,
                       UnknownObjectException,
                       RemoteException

指定された ID のオブジェクトを起動します。

パラメータ:

force - true の場合、オブジェクトを起動するときに、アクティベータをグループに接続する。キャッシュに入っている参照を返す処理はしない。false の場合は、キャッシュに入っている値を戻り値として使用可能。

戻り値:

起動しているリモートオブジェクトへの参照

例外:

ActivationException - 起動に失敗した場合

UnknownObjectException - オブジェクトが不明な場合

RemoteException - リモート呼び出しが失敗した場合

導入されたバージョン:

1.2

hashCode

public int hashCode()

起動 ID のハッシュコードを返します。同じリモートオブジェクトを参照する 2 つの識別子は、同じハッシュコードを持ちます。

オーバーライド:

hashCode、クラス: Object

戻り値:

このオブジェクトのハッシュコード値。

導入されたバージョン:

1.2

関連項目:

Hashtable

equals

public boolean equals(Object obj)

2 つの起動 ID の内容を比較します。次の条件が両方とも満たされる場合に true を返します。1) 一意の識別子の内容が同等である。 2) 各識別子に指定されているアクティベータが、同じリモートオブジェクトを参照する

オーバーライド:

equals、クラス: Object

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.2

関連項目:

Hashtable