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

インタフェースActivationSystem

すべてのスーパー・インタフェース:
Remote
@Deprecated(forRemoval=true, since="15") public interface ActivationSystem extends Remote
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
詳細は、java.rmi.activationパッケージ仕様を参照してください。
ActivationSystemは、グループ、およびその中にある「起動可能な」オブジェクトのうちで起動しておくものを登録する方法を提供します。 ActivationSystemは、ActivationSystemを使って登録されたオブジェクトを起動するActivator、および起動中あるいは停止中のオブジェクトと停止中のグループに関する情報を取得するActivationMonitorと密接に連携しながら動作します。
導入されたバージョン:
1.2
関連項目:
Activator, ActivationMonitor

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static int
    SYSTEM_PORT
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動システムを探すポートです。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    ActivationMonitor
    activeGroup​(ActivationGroupID id, ActivationInstantiator group, long incarnation)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    グループが起動中であることを起動システムに通知するコールバックです。
    ActivationDesc
    getActivationDesc​(ActivationID id)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動識別子がidであるオブジェクトの起動記述子を返します。
    ActivationGroupDesc
    getActivationGroupDesc​(ActivationGroupID id)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動グループ識別子がidであるグループの起動グループ記述子を返します。
    ActivationGroupID
    registerGroup​(ActivationGroupDesc desc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動グループを登録します。
    ActivationID
    registerObject​(ActivationDesc desc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    registerObjectメソッドは、起動記述子descの登録、および起動可能なリモート・オブジェクトの起動識別子の取得に使います。
    ActivationDesc
    setActivationDesc​(ActivationID id, ActivationDesc desc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動識別子がidであるオブジェクトの起動記述子descを設定します。
    ActivationGroupDesc
    setActivationGroupDesc​(ActivationGroupID id, ActivationGroupDesc desc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動グループ識別子がidであるオブジェクトの起動グループ記述子descを設定します。
    void
    shutdown()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動システムを停止します。
    void
    unregisterGroup​(ActivationGroupID id)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    起動グループを削除します。
    void
    unregisterObject​(ActivationID id)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    ActivationSystemで登録された起動ID、および関連した記述子を削除します。オブジェクトは、その起動IDで起動できなくなります。

  • フィールド詳細

    • SYSTEM_PORT

      static final int SYSTEM_PORT
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動システムを探すポートです。
      関連項目:
      定数フィールド値

  • メソッドの詳細

    • registerObject

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

    • unregisterObject

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

    • registerGroup

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

    • activeGroup

      ActivationMonitor activeGroup​(ActivationGroupID id, ActivationInstantiator group, long incarnation) throws UnknownGroupException, ActivationException, RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      グループが起動中であることを起動システムに通知するコールバックです。 この呼出しがActivationGroup.createGroupメソッドの内部で実行されることにより、グループが起動中であることをActivationSystemに通知します。
      パラメータ:
      id - 起動グループの識別子
      group - グループのインスタンシエータ
      incarnation - グループの生成番号
      戻り値:
      起動グループのモニター
      例外:
      UnknownGroupException - グループが登録されていない場合
      ActivationException - 指定されたidに対するグループがすでに起動されており、かつそのグループが指定されたgroupと等しくないか、あるいはそのグループが指定されたgroupとは異なるincarnationを持つ場合
      RemoteException - リモート呼出しが失敗した場合
      導入されたバージョン:
      1.2

    • unregisterGroup

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

    • shutdown

      void shutdown() throws RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動システムを停止します。 起動デーモンによって生成されたグループをすべて破棄して、起動デーモンを終了します。
      例外:
      RemoteException - 起動デーモンの接続/シャットダウンが失敗した場合
      導入されたバージョン:
      1.2

    • setActivationDesc

      ActivationDesc setActivationDesc​(ActivationID id, ActivationDesc desc) throws ActivationException, UnknownObjectException, UnknownGroupException, RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動識別子がidであるオブジェクトの起動記述子descを設定します。 この変更は、次回オブジェクトを起動したときに有効になります。
      パラメータ:
      id - 起動可能なオブジェクトの起動識別子
      desc - 起動可能なオブジェクトの起動記述子
      戻り値:
      起動記述子の以前の値
      例外:
      UnknownGroupException - descに関連したグループが登録されていない場合
      UnknownObjectException - 起動idが登録されていない場合
      ActivationException - 一般的なエラー(たとえば、ログを更新できない場合)
      RemoteException - リモート呼出しが失敗した場合
      導入されたバージョン:
      1.2
      関連項目:
      getActivationDesc(java.rmi.activation.ActivationID)

    • setActivationGroupDesc

      ActivationGroupDesc setActivationGroupDesc​(ActivationGroupID id, ActivationGroupDesc desc) throws ActivationException, UnknownGroupException, RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動グループ識別子がidであるオブジェクトの起動グループ記述子descを設定します。 この変更は、次回グループを起動したときに有効になります。
      パラメータ:
      id - 起動グループの起動グループ識別子
      desc - 起動グループの起動グループ記述子
      戻り値:
      起動グループ記述子の以前の値
      例外:
      UnknownGroupException - idに関連したグループが登録されていない場合
      ActivationException - 一般的なエラー(たとえば、ログを更新できない場合)
      RemoteException - リモート呼出しが失敗した場合
      導入されたバージョン:
      1.2
      関連項目:
      getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

    • getActivationDesc

      ActivationDesc getActivationDesc​(ActivationID id) throws ActivationException, UnknownObjectException, RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動識別子がidであるオブジェクトの起動記述子を返します。
      パラメータ:
      id - 起動可能なオブジェクトの起動識別子
      戻り値:
      起動記述子
      例外:
      UnknownObjectException - idが登録されていない場合
      ActivationException - 一般的なエラー
      RemoteException - リモート呼出しが失敗した場合
      導入されたバージョン:
      1.2
      関連項目:
      setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

    • getActivationGroupDesc

      ActivationGroupDesc getActivationGroupDesc​(ActivationGroupID id) throws ActivationException, UnknownGroupException, RemoteException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      起動グループ識別子がidであるグループの起動グループ記述子を返します。
      パラメータ:
      id - グループの起動グループ識別子
      戻り値:
      起動グループ記述子
      例外:
      UnknownGroupException - idが登録されていない場合
      ActivationException - 一般的なエラー
      RemoteException - リモート呼出しが失敗した場合
      導入されたバージョン:
      1.2
      関連項目:
      setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)