ActivationDesc (Java Platform SE 8)

java.lang.Object
- java.rmi.activation.ActivationDesc

すべての実装されたインタフェース:

Serializable
```
public final class ActivationDesc
extends Object
implements Serializable
```
起動記述子には、オブジェクトを起動するために必要な情報が格納されています。
- オブジェクトのグループ識別子
- オブジェクトの、完全指定されたクラス名
- オブジェクトのコードの位置(クラスの位置)、コード・ベースURLパス
- オブジェクトの再起動「モード」、および
- オブジェクト固有の初期化データが格納されている、「整列化された」オブジェクト
記述子によって指定されたオブジェクトを作成し直したり、起動したりするには、起動システムに登録された記述子を使います。オブジェクトの記述子にあるMarshalledObjectは、再初期化時あるいは起動時にオブジェクトで使えるように、リモート・オブジェクトのコンストラクタに2番目の引数として渡されます。
導入されたバージョン:

1.2

関連項目:

Activatable, 直列化された形式

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

コンストラクタ
コンストラクタと説明
`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`です。
`ActivationDesc(String className, String location, MarshalledObject<?> data)` クラス名が`className`であるオブジェクトが使うオブジェクト記述子を構築します。このオブジェクトは`location`の位置のコードからロード可能であり、初期化情報は`data`です。
`ActivationDesc(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`に対して同じハッシュ・コードを返します。

クラス java.lang.Objectから継承されたメソッド
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - 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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスActivationDesc

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

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

ActivationDesc

ActivationDesc

ActivationDesc

ActivationDesc

メソッドの詳細

getGroupID

getClassName

getLocation

getData

getRestartMode

equals

hashCode