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

クラスActivationDesc

  • すべての実装されたインタフェース:
    Serializable
    public final class ActivationDesc
extends Object
implements Serializable
    起動記述子には、オブジェクトを起動するために必要な情報が格納されています。
    • オブジェクトのグループ識別子
    • オブジェクトの、完全指定されたクラス名
    • オブジェクトのコードの位置(クラスの位置)、コード・ベースURLパス
    • オブジェクトの再起動「モード」、および
    • オブジェクト固有の初期化データが格納されている、「整列化された」オブジェクト

    記述子によって指定されたオブジェクトを作成し直したり、起動したりするには、起動システムに登録された記述子を使います。 オブジェクトの記述子にあるMarshalledObjectは、再初期化時あるいは起動時にオブジェクトで使えるように、リモート・オブジェクトのコンストラクタに2番目の引数として渡されます。

    導入されたバージョン:
    1.2
    関連項目:
    Activatable, 直列化された形式

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      ActivationDesc​(String className, String location, MarshalledObject<?> data)
      クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。
      ActivationDesc​(String className, String location, MarshalledObject<?> data, boolean restart)
      クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。
      ActivationDesc​(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data)
      クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。
      ActivationDesc​(ActivationGroupID groupID, String className, String location, MarshalledObject<?> data, boolean restart)
      クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      boolean equals​(Object obj)
      2つの起動記述子の内容を比較します。
      String getClassName()
      記述子で指定されたオブジェクトが使うクラス名を返します。
      MarshalledObject<?> getData()
      記述子で指定されたオブジェクトが使う初期化データまたは起動データがある「整列化されたオブジェクト」を返します。
      ActivationGroupID getGroupID()
      記述子で指定されたオブジェクトが使うグループ識別子を返します。
      String getLocation()
      記述子で指定されたオブジェクトが使うコードの位置を返します。
      boolean getRestartMode()
      起動記述子に関連したオブジェクトの「再起動」モードを返します。
      int hashCode()
      同様のActivationDescに対して同じハッシュ・コードを返します。

    • コンストラクタの詳細

      • ActivationDesc

        public ActivationDesc​(String className,
                      String location,
                      MarshalledObject<?> data)
               throws ActivationException
        クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。 この形式のコンストラクタを使用する場合、groupIDのデフォルトは、このVMのActivationGroupの現在のIDになります。 ActivationGroupIDが同じオブジェクトはすべて、同じVMの中で起動されます。

        このコンストラクタで作成した記述子を使って指定されたオブジェクトは、要求に応じて(デフォルトでは再起動モードがfalse)のみ起動されることに注意してください。 起動可能なオブジェクトが再起動サービスを必要とする場合、boolean型パラメータrestartを用いたActivationDescコンストラクタの一部を使用します。

        このコンストラクタは、このVMの現在の起動グループがない場合はActivationExceptionをスローします。 ActivationGroupを作成するには、ActivationGroup.createGroupメソッドを使います。

        パラメータ:
        className - オブジェクトの、パッケージ名が完全指定されたクラス名
        location - オブジェクトのコードの位置(クラスのロード元の位置)
        data - 整列化された形式で格納されている、オブジェクトの初期化(起動)データ
        例外:
        ActivationException - 現在のグループが存在しない場合
        UnsupportedOperationException - この実装で起動がサポートされていない場合のみ
        導入されたバージョン:
        1.2

      • ActivationDesc

        public ActivationDesc​(String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
               throws ActivationException
        クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。 この形式のコンストラクタを使用する場合、groupIDのデフォルトは、このVMのActivationGroupの現在のIDになります。 ActivationGroupIDが同じオブジェクトはすべて、同じVMの中で起動されます。

        このコンストラクタは、このVMの現在の起動グループがない場合はActivationExceptionをスローします。 ActivationGroupを作成するには、ActivationGroup.createGroupメソッドを使います。

        パラメータ:
        className - オブジェクトの、パッケージ名が完全指定されたクラス名
        location - オブジェクトのコードの位置(クラスのロード元の位置)
        data - 整列化された形式で格納されている、オブジェクトの初期化(起動)データ
        restart - trueの場合は、アクティベータが再起動したとき、または突然のクラッシュ後にオブジェクトの起動グループを再起動したときにオブジェクトも再起動される。falseの場合は、オブジェクトは要求に応じて起動される。 restartをtrueに指定しても、新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。
        例外:
        ActivationException - 現在のグループが存在しない場合
        UnsupportedOperationException - この実装で起動がサポートされていない場合のみ
        導入されたバージョン:
        1.2

      • ActivationDesc

        public ActivationDesc​(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data)
        クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。 groupIDが同じオブジェクトはすべて、同じJava VMの中で起動されます。

        このコンストラクタで作成した記述子を使って指定されたオブジェクトは、要求に応じて(デフォルトでは再起動モードがfalse)のみ起動されることに注意してください。 起動可能なオブジェクトが再起動サービスを必要とする場合、boolean型パラメータrestartを用いたActivationDescコンストラクタの一部を使用します。

        パラメータ:
        groupID - グループの識別子。ActivationSystem.registerGroupメソッドの登録から取得される。 グループは、オブジェクトが起動されるVMを指定する。
        className - オブジェクトの、パッケージ名が完全指定されたクラス名
        location - オブジェクトのコードの位置(クラスのロード元の位置)
        data - 整列化された形式で格納されている、オブジェクトの初期化(起動)データ
        例外:
        IllegalArgumentException - groupIDがnullの場合
        UnsupportedOperationException - この実装で起動がサポートされていない場合のみ
        導入されたバージョン:
        1.2

      • ActivationDesc

        public ActivationDesc​(ActivationGroupID groupID,
                      String className,
                      String location,
                      MarshalledObject<?> data,
                      boolean restart)
        クラス名がclassNameであるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトはlocationの位置のコードからロード可能であり、初期化情報はdataです。 groupIDが同じオブジェクトはすべて、同じJava VMの中で起動されます。
        パラメータ:
        groupID - グループの識別子。ActivationSystem.registerGroupメソッドの登録から取得される。 グループは、オブジェクトが起動されるVMを指定する。
        className - オブジェクトの、パッケージ名が完全指定されたクラス名
        location - オブジェクトのコードの位置(クラスのロード元の位置)
        data - 整列化された形式で格納されている、オブジェクトの初期化(起動)データ
        restart - trueの場合は、アクティベータが再起動したとき、または突然のクラッシュ後にオブジェクトの起動グループを再起動したときにオブジェクトも再起動される。falseの場合は、オブジェクトは要求に応じて起動される。 restartをtrueに指定しても、新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。
        例外:
        IllegalArgumentException - groupIDがnullの場合
        UnsupportedOperationException - この実装で起動がサポートされていない場合のみ
        導入されたバージョン:
        1.2

    • メソッドの詳細

      • getGroupID

        public ActivationGroupID getGroupID()
        記述子で指定されたオブジェクトが使うグループ識別子を返します。 グループは、複数のオブジェクトを1つのJava仮想マシンにまとめる役割を果たします。 RMIは、1つの仮想マシン内で、同じgroupIDを持つ複数のオブジェクトを作成または起動します。
        戻り値:
        グループの識別子
        導入されたバージョン:
        1.2

      • getClassName

        public String getClassName()
        記述子で指定されたオブジェクトが使うクラス名を返します。
        戻り値:
        クラス名
        導入されたバージョン:
        1.2

      • getLocation

        public String getLocation()
        記述子で指定されたオブジェクトが使うコードの位置を返します。
        戻り値:
        コードの位置
        導入されたバージョン:
        1.2

      • getData

        public MarshalledObject<?> getData()
        記述子で指定されたオブジェクトが使う初期化データまたは起動データがある「整列化されたオブジェクト」を返します。
        戻り値:
        オブジェクト固有の「初期化」データ
        導入されたバージョン:
        1.2

      • getRestartMode

        public boolean getRestartMode()
        起動記述子に関連したオブジェクトの「再起動」モードを返します。
        戻り値:
        この起動記述子に関連付けられた起動可能なオブジェクトが、起動デーモンが再起動したとき、または突然のクラッシュ後にオブジェクトのグループが再起動されるときにそのデーモンを介して再起動される場合はtrue、それ以外の場合はfalseを返す。つまり、そのオブジェクトはメソッド呼出し経由で要求された場合にのみ起動する。 再起動モードがtrueの場合、アクティベータは新規登録オブジェクトを最初にすぐ起動するわけではない。初期起動はすぐには行われない。
        導入されたバージョン:
        1.2

      • equals

        public boolean equals​(Object obj)
        2つの起動記述子の内容を比較します。
        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        obj - 比較対象のオブジェクト
        戻り値:
        2つのObjectが等しい場合はtrue。そうでない場合はfalse
        導入されたバージョン:
        1.2
        関連項目:
        Hashtable

      • hashCode

        public int hashCode()
        同様のActivationDescに対して同じハッシュ・コードを返します。
        オーバーライド:
        hashCode 、クラス:  Object
        戻り値:
        整数型
        関連項目:
        Hashtable