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 obj) オブジェクトが起動したことを通知します。
void	inactiveGroup(ActivationGroupID id, long incarnation) グループが停止していることを通知します。
void	inactiveObject(ActivationID id) 起動グループは、グループ内のオブジェクトが停止したときに、グループのモニターの inactiveObject メソッドを呼び出します。

メソッドの詳細

inactiveObject

void inactiveObject(ActivationID id)
                    throws UnknownObjectException,
                           RemoteException

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

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

パラメータ:

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

例外:

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

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

導入されたバージョン:

1.2

activeObject

void activeObject(ActivationID id,
                  MarshalledObject 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