public interface ActivationSystem extends Remote
ActivationSystemは、グループ、およびその中にある「起動可能な」オブジェクトのうちで起動しておくものを登録する方法を提供します。 ActivationSystemは、ActivationSystemを使って登録されたオブジェクトを起動するActivator、および起動中あるいは停止中のオブジェクトと停止中のグループに関する情報を取得するActivationMonitorと密接に連携しながら動作します。 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) |
registerObjectメソッドは、起動記述子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、および関連した記述子を削除します。オブジェクトは、その起動IDで起動できなくなります。 |
static final int SYSTEM_PORT
ActivationID registerObject(ActivationDesc desc) throws ActivationException, UnknownGroupException, RemoteException
registerObjectメソッドは、起動記述子descの登録、および起動可能なリモート・オブジェクトの起動識別子の取得に使います。 ActivationSystemは、記述子descに指定されたオブジェクトのActivationID (起動識別子)を作成し、安定記憶領域に、あとで使用するための起動記述子およびそれに関連した識別子を記録します。 Activatorは、特定の識別子を対象としたactivate要求を受け取ると、指定された識別子に対応する起動記述子(前に登録したもの)を探し、その情報を使用してオブジェクトを起動します。 desc - オブジェクトの起動記述子ActivationException - 登録が失敗した場合(たとえば、データベース更新の失敗)。UnknownGroupException - descに示されたグループがこのシステムに登録されていない場合RemoteException - リモート呼出しが失敗した場合void unregisterObject(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
ActivationSystemで登録された起動ID、および関連した記述子を削除します。オブジェクトは、その起動IDで起動できなくなります。id - オブジェクトの起動ID (以前に登録されたもの)ActivationException - 登録解除が失敗した場合(たとえば、データベース更新の失敗など)UnknownObjectException - オブジェクトが不明な(登録されていない)場合RemoteException - リモート呼出しが失敗した場合ActivationGroupID registerGroup(ActivationGroupDesc desc) throws ActivationException, RemoteException
ActivationSystemに登録しておく必要があります。 desc - グループの記述子ActivationException - グループの登録が失敗した場合RemoteException - リモート呼出しが失敗した場合ActivationMonitor activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException, ActivationException, RemoteException
ActivationGroup.createGroupメソッドの内部で実行されることにより、グループが起動中であることをActivationSystemに通知します。 id - 起動グループの識別子group - グループのインスタンシエータincarnation - グループの生成番号UnknownGroupException - グループが登録されていない場合ActivationException - 指定されたidに対するグループがすでに起動されており、かつそのグループが指定されたgroupと等しくないか、あるいはそのグループが指定されたgroupとは異なるincarnationを持つ場合RemoteException - リモート呼出しが失敗した場合void unregisterGroup(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
id - 起動グループの識別子ActivationException - 登録解除が失敗した場合(たとえば、データベース更新の失敗など)UnknownGroupException - グループが登録されていない場合RemoteException - リモート呼出しが失敗した場合void shutdown()
throws RemoteException
RemoteException - 起動デーモンの接続/シャットダウンが失敗した場合ActivationDesc setActivationDesc(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
idであるオブジェクトの起動記述子descを設定します。 この変更は、次回オブジェクトを起動したときに有効になります。 id - 起動可能なオブジェクトの起動識別子desc - 起動可能なオブジェクトの起動記述子UnknownGroupException - descに関連したグループが登録されていない場合UnknownObjectException - 起動idが登録されていない場合ActivationException - 一般的なエラー(たとえば、ログを更新できない場合)RemoteException - リモート呼出しが失敗した場合getActivationDesc(java.rmi.activation.ActivationID)ActivationGroupDesc setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
idであるオブジェクトの起動グループ記述子descを設定します。 この変更は、次回グループを起動したときに有効になります。 id - 起動グループの起動グループ識別子desc - 起動グループの起動グループ記述子UnknownGroupException - idに関連したグループが登録されていない場合ActivationException - 一般的なエラー(たとえば、ログを更新できない場合)RemoteException - リモート呼出しが失敗した場合getActivationGroupDesc(java.rmi.activation.ActivationGroupID)ActivationDesc getActivationDesc(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
idであるオブジェクトの起動記述子を返します。id - 起動可能なオブジェクトの起動識別子UnknownObjectException - idが登録されていない場合ActivationException - 一般的なエラーRemoteException - リモート呼出しが失敗した場合setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)ActivationGroupDesc getActivationGroupDesc(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
idであるグループの起動グループ記述子を返します。id - グループの起動グループ識別子UnknownGroupException - idが登録されていない場合ActivationException - 一般的なエラーRemoteException - リモート呼出しが失敗した場合setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc) バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。