java.rmi.activation

インタフェース ActivationMonitor

すべてのスーパーインタフェース:

Remote

public interface ActivationMonitor
extends Remote

ActivationMonitor は ActivationGroup ごとにあり、ActivationSystem.activeGroup の呼び出しでグループが起動中と報告されたときに取得されます。この処理は、内部で実行されます。起動グループは、そのオブジェクトが起動または停止したとき、あるいはグループ全体が停止したときに、その ActivationMonitor に通知を行います。

導入されたバージョン:

1.2

関連項目:

Activator, ActivationSystem, ActivationGroup

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	activeObject(ActivationID id, MarshalledObject<? extends Remote> obj) オブジェクトが起動したことを通知します。
void	inactiveGroup(ActivationGroupID id, long incarnation) グループが停止していることを通知します。
void	inactiveObject(ActivationID id) 起動グループは、グループ内のオブジェクトが停止したときに、グループのモニターの inactiveObject メソッドを呼び出します。

メソッドの詳細

inactiveObject

void inactiveObject(ActivationID id)
                    throws UnknownObjectException,
                           RemoteException

起動グループは、グループ内のオブジェクトが停止したときに、グループのモニターの inactiveObject メソッドを呼び出します。起動グループは、そのグループが起動した VM 内のオブジェクトが動作を停止したことを知るには、起動グループの inactiveObject メソッドを呼び出します。

inactiveObject 呼び出しは、起動識別子 id を持つオブジェクトを指すリモートオブジェクト参照が有効でなくなったことを ActivationMonitor に知らせます。モニタは id に関連した参照を無効な参照と見なします。参照が無効と見なされるので、以後同じ起動識別子への activate の呼び出しでは、リモートオブジェクトがふたたび起動されます。

パラメータ:

id - オブジェクトの起動識別子

例外:

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

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

導入されたバージョン:

1.2

activeObject

void activeObject(ActivationID id,
                MarshalledObject<? extends Remote> obj)
                  throws UnknownObjectException,
                         RemoteException

オブジェクトが起動したことを通知します。ActivationGroup は、そのグループ内のオブジェクトが直接起動される以外の方法で起動された場合 (すなわち、オブジェクトが自分自身で登録して起動した場合) にそれをそのモニターに通知します。

パラメータ:

id - 起動したオブジェクトの ID

obj - オブジェクトのスタブの整列化された形式

例外:

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

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

導入されたバージョン:

1.2

inactiveGroup

void inactiveGroup(ActivationGroupID id,
                 long incarnation)
                   throws UnknownGroupException,
                          RemoteException

グループが停止していることを通知します。以後、グループ内のオブジェクトを起動する要求があると、グループはふたたび作成されます。グループは、その中にあるすべてのオブジェクトが停止していると報告されると停止します。

パラメータ:

id - グループの ID

incarnation - グループの生成番号

例外:

UnknownGroupException - グループが不明な場合

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

導入されたバージョン:

1.2