ActivationMonitor (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.rmi.activation
インタフェース ActivationMonitor

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

public interface ActivationMonitor
extends Remote
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 の呼び出しは、ActivationMonitor に、その ActivationMonitor が起動識別子 id で保持しているリモートオブジェクト参照が無効になったことを通知します。モニタは 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