モジュール java.rmi
パッケージ java.rmi.activation

インタフェースActivationSystem

  • すべてのスーパー・インタフェース:
    Remote
    public interface ActivationSystem
extends Remote
    ActivationSystemは、グループ、およびその中にある「起動可能な」オブジェクトのうちで起動しておくものを登録する方法を提供します。 ActivationSystemは、ActivationSystemを使って登録されたオブジェクトを起動するActivator、および起動中あるいは停止中のオブジェクトと停止中のグループに関する情報を取得するActivationMonitorと密接に連携しながら動作します。
    導入されたバージョン:
    1.2
    関連項目:
    Activator, ActivationMonitor

    • フィールドの詳細

      • SYSTEM_PORT

        static final int SYSTEM_PORT
        起動システムを探すポートです。
        関連項目:
        定数フィールド値

    • メソッドの詳細

      • registerObject

        ActivationID registerObject​(ActivationDesc desc)
                     throws ActivationException,
                            UnknownGroupException,
                            RemoteException
        registerObjectメソッドは、起動記述子descの登録、および起動可能なリモート・オブジェクトの起動識別子の取得に使います。 ActivationSystemは、記述子descに指定されたオブジェクトのActivationID (起動識別子)を作成し、安定記憶領域に、あとで使用するための起動記述子およびそれに関連した識別子を記録します。 Activatorは、特定の識別子を対象としたactivate要求を受け取ると、指定された識別子に対応する起動記述子(前に登録したもの)を探し、その情報を使用してオブジェクトを起動します。
        パラメータ:
        desc - オブジェクトの起動記述子
        戻り値:
        オブジェクトの起動に使用する起動ID
        例外:
        ActivationException - 登録が失敗した場合(たとえば、データベース更新の失敗)。
        UnknownGroupException - descに示されたグループがこのシステムに登録されていない場合
        RemoteException - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2

      • unregisterObject

        void unregisterObject​(ActivationID id)
               throws ActivationException,
                      UnknownObjectException,
                      RemoteException
        ActivationSystemで登録された起動ID、および関連した記述子を削除します。オブジェクトは、その起動IDで起動できなくなります。
        パラメータ:
        id - オブジェクトの起動ID (以前に登録されたもの)
        例外:
        ActivationException - 登録解除が失敗した場合(たとえば、データベース更新の失敗など)
        UnknownObjectException - オブジェクトが不明な(登録されていない)場合
        RemoteException - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2

      • registerGroup

        ActivationGroupID registerGroup​(ActivationGroupDesc desc)
                         throws ActivationException,
                                RemoteException
        起動グループを登録します。 オブジェクトを起動グループに登録する前に、その起動グループをActivationSystemに登録しておく必要があります。
        パラメータ:
        desc - グループの記述子
        戻り値:
        グループの識別子
        例外:
        ActivationException - グループの登録が失敗した場合
        RemoteException - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2

      • activeGroup

        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 - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2

      • unregisterGroup

        void unregisterGroup​(ActivationGroupID id)
              throws ActivationException,
                     UnknownGroupException,
                     RemoteException
        起動グループを削除します。 起動グループはこのコールバックを返すことにより、グループを削除(破棄)するようアクティベータに通知します。 この呼出しが成功した場合は、そのグループにオブジェクトを登録したり、そのグループ内でオブジェクトを起動したりすることはできなくなります。 そのグループに関する情報と、そのグループに関連付けられたオブジェクトはすべてシステムから削除されます。
        パラメータ:
        id - 起動グループの識別子
        例外:
        ActivationException - 登録解除が失敗した場合(たとえば、データベース更新の失敗など)
        UnknownGroupException - グループが登録されていない場合
        RemoteException - リモート呼出しが失敗した場合
        導入されたバージョン:
        1.2

      • shutdown

        void shutdown()
       throws RemoteException
        起動システムを停止します。 起動デーモンによって生成されたグループをすべて破棄して、起動デーモンを終了します。
        例外:
        RemoteException - 起動デーモンの接続/シャットダウンが失敗した場合
        導入されたバージョン:
        1.2