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

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

Remote

public interface ActivationSystem

extends Remote

ActivationSystem は、グループ、およびその中にある起動可能なオブジェクトのうちで起動しておくものを登録する方法を提供します。ActivationSystem は、ActivationSystem を使って登録されたオブジェクトを起動する Activator、および起動中あるいは停止中のオブジェクトと停止中のグループの情報を取得する ActivationMonitor と密接に連携します。

導入されたバージョン:

1.2

関連項目:

Activator, ActivationMonitor

フィールドの概要

static int

SYSTEM_PORT 起動システムを探すポートです。

メソッドの概要

ActivationMonitor	activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation) グループが起動中であることを起動システムに通知するコールバックです。
ActivationDesc	getActivationDesc(ActivationID id) 起動識別子が id であるオブジェクトの起動記述子を返します。
ActivationGroupDesc	getActivationGroupDesc(ActivationGroupID id) 起動グループ識別子が id であるグループの起動グループ記述子を返します。
ActivationGroupID	registerGroup(ActivationGroupDesc desc) 起動グループを登録します。
ActivationID	registerObject(ActivationDesc desc) 起動記述子 desc の登録、および起動可能なリモートオブジェクトの起動識別子の取得に使います。
ActivationDesc	setActivationDesc(ActivationID id, ActivationDesc desc) 起動識別子が id であるオブジェクトの起動記述子 desc を設定します。
ActivationGroupDesc	setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) 起動グループ識別子が id であるオブジェクトの起動グループ記述子 desc を設定します。
void	shutdown() 起動システムを停止します。
void	unregisterGroup(ActivationGroupID id) 起動グループを削除します。
void	unregisterObject(ActivationID id) ActivationSystem で登録された起動 ID、および関連した記述子を削除します。

フィールドの詳細

SYSTEM_PORT

public static final int SYSTEM_PORT

起動システムを探すポートです。

メソッドの詳細

registerObject

public ActivationID registerObject(ActivationDesc desc)
                            throws ActivationException,
                                   UnknownGroupException,
                                   RemoteException

起動記述子 desc の登録、および起動可能なリモートオブジェクトの起動識別子の取得に使います。ActivationSystem は、記述子 desc に指定されたオブジェクトの ActivationID (起動識別子) を作成し、安定記憶領域に、あとで使用するための起動記述子およびそれに関連した識別子を記録します。Activator が特定の識別子の activate 要求を受け取った場合は、指定された識別子の起動記述子 (以前に登録されたもの) を検索した上で、その情報を使ってオブジェクトを起動します。

パラメータ:

desc - オブジェクトの起動記述子

戻り値:

オブジェクトの起動に使用する起動 ID

例外:

ActivationException - 登録が失敗した場合。たとえば、データベース更新の失敗

UnknownGroupException - desc に示されたグループがシステムに登録されていない場合

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

導入されたバージョン:

1.2

unregisterObject

public void unregisterObject(ActivationID id)
                      throws ActivationException,
                             UnknownObjectException,
                             RemoteException

ActivationSystem で登録された起動 ID、および関連した記述子を削除します。オブジェクトは、その起動 ID で起動できなくなります。

パラメータ:

id - オブジェクトの起動 ID (以前に登録されたもの)

例外:

ActivationException - 登録解除が失敗した場合。たとえば、データベース更新の失敗

UnknownObjectException - オブジェクトが不明な (登録されていない) 場合

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

導入されたバージョン:

1.2

registerGroup

public ActivationGroupID registerGroup(ActivationGroupDesc desc)
                                throws ActivationException,
                                       RemoteException

起動グループを登録します。ActivationSystem で起動グループを登録しないと、そのグループにオブジェクトを登録できません。

パラメータ:

desc - グループの記述子

戻り値:

グループの識別子

例外:

ActivationException - グループの登録が失敗した場合

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

導入されたバージョン:

1.2

activeGroup

public ActivationMonitor activeGroup(ActivationGroupID id,
                                     ActivationInstantiator group,
                                     long incarnation)
                              throws UnknownGroupException,
                                     ActivationException,
                                     RemoteException

グループが起動中であることを起動システムに通知するコールバックです。この呼び出しが ActivationGroup.createGroup メソッドの内部で実行されることにより、ActivationSystem にグループが起動中であることが通知されます。

パラメータ:

id - 起動グループの識別子

group - グループのインスタンシエータ

incarnation - グループの生成番号

戻り値:

起動グループのモニター

例外:

UnknownGroupException - グループが未登録の場合

ActivationException - グループがすでに起動している場合

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

導入されたバージョン:

1.2

unregisterGroup

public void unregisterGroup(ActivationGroupID id)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException

起動グループを削除します。起動グループはこのコールバックを返すことにより、グループを削除 (破棄) するようアクティベータに通知します。この呼び出しが完了した場合、グループ内でのオブジェクトの登録や起動はできなくなります。グループ、およびそれに関連したオブジェクトの情報はすべて、システムから削除されます。

パラメータ:

id - 起動グループの識別子

例外:

ActivationException - 登録解除が失敗した場合。たとえば、データベース更新の失敗

UnknownGroupException - グループが未登録の場合

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

導入されたバージョン:

1.2

shutdown

public void shutdown()
              throws RemoteException

起動システムを停止します。起動デーモンによって生成されたグループをすべて破棄して、起動デーモンを終了します。

例外:

RemoteException - 起動デーモンの接続/停止が失敗した場合

導入されたバージョン:

1.2

setActivationDesc

public ActivationDesc setActivationDesc(ActivationID id,
                                        ActivationDesc desc)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        UnknownGroupException,
                                        RemoteException

起動識別子が id であるオブジェクトの起動記述子 desc を設定します。この変更は、次回にオブジェクトを起動したときに有効になります。

パラメータ:

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

desc - 起動可能なオブジェクトの起動記述子

戻り値:

起動記述子の以前の値

例外:

UnknownGroupException - desc に関連したグループが未登録の場合

UnknownObjectException - 起動 id が未登録の場合

ActivationException - 一般的なエラー。たとえば、ログの更新が不可能

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

導入されたバージョン:

1.2

setActivationGroupDesc

public ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id,
                                                  ActivationGroupDesc desc)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException

起動グループ識別子が id であるオブジェクトの起動グループ記述子 desc を設定します。この変更は、次回にグループを起動したときに有効になります。

パラメータ:

id - 起動グループの起動グループ識別子

desc - 起動グループの起動グループ記述子

戻り値:

起動グループ記述子の以前の値

例外:

UnknownGroupException - id に関連したグループが未登録の場合

ActivationException - 一般的なエラー。たとえば、ログの更新が不可能

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

導入されたバージョン:

1.2

getActivationDesc

public ActivationDesc getActivationDesc(ActivationID id)
                                 throws ActivationException,
                                        UnknownObjectException,
                                        RemoteException

起動識別子が id であるオブジェクトの起動記述子を返します。

パラメータ:

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

戻り値:

起動記述子

例外:

UnknownObjectException - id が未登録の場合

ActivationException - 一般的なエラー

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

導入されたバージョン:

1.2

getActivationGroupDesc

public ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id)
                                           throws ActivationException,
                                                  UnknownGroupException,
                                                  RemoteException

起動グループ識別子が id であるグループの起動グループ記述子を返します。

パラメータ:

id - グループの起動グループ識別子

戻り値:

起動グループ記述子

例外:

UnknownGroupException - id が未登録の場合

ActivationException - 一般的なエラー

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

導入されたバージョン:

1.2