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 つの識別子は、同じハッシュコードを持ちます。

オーバーライド:

クラス Object 内の hashCode

戻り値:

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

導入されたバージョン:

1.2

関連項目:

Hashtable

equals

public boolean equals(Object obj)

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

オーバーライド:

クラス Object 内の equals

パラメータ:

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

戻り値:

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

導入されたバージョン:

1.2

関連項目:

Hashtable