Java Remote Method Invocation: 7 - リモートオブジェクト起動

Java Remote Method Invocation

7.4 起動インタフェース

RMI 起動プロトコルでは、システムの正常な動作のため、アクティベータに関して守るべき次の 2 つの約束事があります。

すべてのシステムデーモン同様、アクティベータはマシンが動作している間、常に動作させておくこと

アクティベータは、すでにアクティブな状態のリモートオブジェクトを起動しないこと

アクティベータは、起動処理に関与するグループとオブジェクトから成る適切な情報のデータベースを保持します。

7.4.1 `Activator` インタフェース

アクティベータは、起動プロセス中にかかわるエンティティの 1 つです。前述したように、フォルト参照 (スタブ内) は、起動可能リモートオブジェクトへの「ライブ」参照を取得するため、アクティベータの activate メソッドを呼び出します。アクティベータは、起動要求を受け取ると、指定された起動識別子 id に対応する起動記述子を探し、そのオブジェクトを起動すべきグループを特定して、その起動グループのインスタンシエータの newInstance メソッドを呼び出します (リモートインタフェース ActivationGroup については後述)。必要であれば、アクティベータは起動グループの実行を開始します。たとえば、特定のグループ記述子に対応する起動グループがまだ実行されていない場合、アクティベータはその起動グループの子 JVM を生成し、生成した JVM 内で起動グループを立ち上げます。
アクティベータは、起動グループのエラーを監視、検出し、エラーの際は、その内部テーブルから古いリモート参照を削除します。

package java.rmi.activation;
public interface Activator extends java.rmi.Remote
{
	java.rmi.MarshalledObject activate(ActivationID id,
					   boolean force)
		throws UnknownObjectException, ActivationException,
		       java.rmi.RemoteException;
}

activate メソッドは、起動識別子 id に関連付けられたオブジェクトを起動します。そのオブジェクトがすでにアクティブな状態にあることをアクティベータが知っており、なおかつ force パラメータが false の場合は、スタブが「ライブ」参照とともにただちに呼び出し側に返されます。一方、対応するリモートオブジェクトがアクティブな状態にあることをアクティベータが知らないか、または force パラメータが true の場合は、アクティベータは起動記述子情報 (前に id を取得するため登録したもの) を使用して、オブジェクトを起動すべきグループ (JVM) を特定します。特定したオブジェクトのグループに対応する ActivationInstantiator がすでに存在する場合は、アクティベータは起動インスタンシエータの newInstance メソッドを呼び出し、オブジェクトの id と起動記述子を引数として渡します。
特定したオブジェクトのグループ記述子に対応する起動インスタンシエータまたはグループがまだ存在しない場合は、アクティベータは、子プロセスを生成するなどの方法により ActivationInstantiator の実行の新規生成を開始させます。アクティベータは、特定のグループの ActivationInstantiator を再作成するときは、そのグループの生成番号をインクリメントしなければなりません。生成番号はゼロから始まります。起動システムは、生成番号により、新しい ActivationSystem.activeGroup および ActivationMonitor.inactiveGroup の呼び出しを検出します。同じグループで、現在の生成番号よりも若い生成番号を持つ呼び出しは破棄されます。

注 - 新しい起動グループを実行するときは、アクティベータは起動グループの識別子、記述子、および生成番号を利用しなければなりません。アクティベータは、独立した JVM 内 (たとえば、別のプロセスや子プロセスとして) で起動グループを生成します。したがって、アクティベータは、ActivationGroup.createGroup メソッドで起動グループを作成するのに必要な情報を規定して引き渡す必要があります。この情報を、生成されたプロセスにどのように引き渡すかについては規定されていませんが、整列化されたオブジェクトの形式で子プロセスの「標準入力」に送ることが可能です。

アクティベータは、ActivationSystem.activeGroup メソッドにより起動グループの参照と生成番号が含まれる起動グループのコールバックを受け取ると、その起動インスタンシエータの newInstance メソッドを呼び出して、保留状態になっている起動要求を起動インスタンシエータに転送し、結果 (「整列化された」リモートオブジェクトの参照、つまりスタブ) をそれぞれの呼び出し側に返すことができます。
アクティベータは、オブジェクトのコードをロードしたり、オブジェクトの分散ガベージコレクションに関与したりしなくてもよいように、Remote オブジェクトではなく MarshalledObject を受け取ります。リモートオブジェクトへの強い参照を保持していれば、通常の分散ガベージコレクション機構の下では、アクティベータはリモートオブジェクトがガベージコレクトされるのを防ぐことができます。
起動が失敗した場合、activate メソッドは ActivationException をスローします。起動が失敗する原因としては、クラスが見つからない、起動グループにアクセスできないなど、さまざまな要因があります。指定された起動識別子 id に対応する起動記述子がこのアクティベータで登録されていない場合は、activate メソッドは UnknownObjectException をスローします。アクティベータのリモート呼び出しが失敗した場合は、RemoteException をスローします。

7.4.2 `ActivationSystem` インタフェース

ActivationSystem は、グループと、そのグループ内で起動させる「起動可能」オブジェクトを登録する手段を提供します。ActivationSystem は、ActivationSystem で登録されたオブジェクトを起動する Activator と、アクティブなオブジェクトや、アクティブでないオブジェクト、またはアクティブでないグループに関する情報を取得する ActivationMonitor の双方と密接に関連しながら動作します。

package java.rmi.activation;
public interface ActivationSystem extends java.rmi.Remote
{
	public static final int SYSTEM_PORT = 1098;

	ActivationGroupID registerGroup(ActivationGroupDesc desc)
		throws ActivationException, java.rmi.RemoteException;

	ActivationMonitor activeGroup(ActivationGroupID id,
				      ActivationInstantiator group,
				      long incarnation)
		throws UnknownGroupException, ActivationException,
		       java.rmi.RemoteException;

	void unregisterGroup(ActivationGroupID id)
		throws ActivationException, UnknownGroupException,
		       java.rmi.RemoteException;

	ActivationID registerObject(ActivationDesc desc)
		throws ActivationException, UnknownGroupException,
		       java.rmi.RemoteException;

	void unregisterObject(ActivationID id)
		throws ActivationException, UnknownObjectException,
		       java.rmi.RemoteException;

	void shutdown() throws java.rmi.RemoteException;
}

注 - セキュリティ保護のため、上記のすべてのメソッド (registerGroup、activeGroup、unregisterGroup、registerObject、unregisterObject、および shutdown) は、起動システムとは異なるホスト上で動作しているクライアントから呼び出された場合、java.rmi.RemoteException のサブクラスである java.rmi.AccessException をスローします。

registerObject メソッドは、起動記述子 desc の登録と、起動可能リモートオブジェクトの起動識別子の取得に使用します。ActivationSystem は、起動記述子 desc で指定されたオブジェクトの ActivationID (起動識別子) を作成し、後の使用に備えて起動記述子と、それに関連付けられた識別子を安定記憶領域に記録します。Activator は、特定の識別子を対象とした activate 要求を受け取ると、指定された識別子に対応する起動記述子 (前に登録したもの) を探し、その情報を使用してオブジェクトを起動します。desc で参照されているグループがこのシステムに登録されていない場合は、registerObject メソッドは UnknownGroupException をスローします。データベースの更新の失敗などが原因で登録が失敗した場合は、ActivationException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。
unregisterObject は、起動識別子 id と、それに関連付けられ、ActivationSystem に登録されている記述子を削除します。呼び出し完了後は、オブジェクトはその起動 id では起動できなくなります。指定されたオブジェクト id が起動システムが知らない (登録されていない) 識別子である場合は、unregisterObject メソッドは UnknownObjectException をスローします。データベース更新の失敗などが原因で登録解除処理が失敗した場合は、ActivationException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。
registerGroup メソッドは、グループ記述子 desc で指定された起動グループを起動システムに登録し、そのグループに割り当てられた ActivationGroupID を返します。オブジェクトを起動グループに登録する前に、その起動グループを ActivationSystem に登録しておく必要があります。グループの登録が失敗した場合は、このメソッドは ActivationException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。
activeGroup メソッドは、ActivationGroup からのコールバック (識別子 id を伴う) であり、group が現在アクティブな状態にあり、その JVM の ActivationInstantiator になっていることを起動システムに知らせます。このメソッドは、そのグループ内のグループまたはオブジェクトがアクティブでなくなったなど、オブジェクトとグループの状態の変化をシステムに伝えるためにグループが使用する ActivationMonitor を取得するため、ActivationGroup.createGroup メソッドにより内部的に呼び出されます。指定されたグループが登録されていない場合は、activeGroup メソッドは UnknownGroupException をスローします。指定されたグループがすでにアクティブな状態にある場合は、ActivationException をスローします。起動システムのリモート呼び出しが失敗した場合は、RemoteException をスローします。
unregisterGroup メソッドは、指定された識別子 id を持つ起動グループを起動システムから削除します。起動グループは、自分自身を破棄すべきであることをアクティベータに伝えるため、このコールバックを行います。この呼び出しが成功した場合は、そのグループにオブジェクトを登録したり、そのグループ内でオブジェクトを起動したりすることはできなくなります。そのグループに関する情報と、そのグループに関連付けられたオブジェクトはすべてシステムから削除されます。指定されたグループが登録されていない場合は、このメソッドは UnknownGroupException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。データ��鹿頏緇鹿碎閭鞫��昭碎閭鞫��釈�釶辣就妓乙⊂次⑬�⑬昭��このコマンドにより、指定されたポートで起動デーモンがシャットダウンされます。ポートを指定しない場合、デフォルトポート上のデーモンがシャットダウンされます。

7.4.3 `ActivationMonitor` クラス

ActivationMonitor は ActivationGroup に固有のクラスで、ActivationSystem.activeGroup の呼び出し (ActivationGroup.createGroup メソッドにより内部的に呼び出される) によりグループの報告が行われたときに取得されます。以下の場合には、起動グループは、ActivationMonitor に報告する必要があります。

a. そのオブジェクトがアクティブになったとき

b. そのオブジェクトがアクティブでなくなったとき

c. グループ全体がアクティブでなくなったとき

package java.rmi.activation;
public interface ActivationMonitor
	extends java.rmi.Remote
{

	public abstract void inactiveObject(ActivationID id)
		throws UnknownObjectException, RemoteException;

	public void activeObject(ActivationID id,
				 java.rmi.MarshalledObject mobj)
		throws UnknownObjectException, java.rmi.RemoteException;

	public void inactiveGroup(ActivationGroupID id,
				  long incarnation)
		throws UnknownGroupException, java.rmi.RemoteException;
}

起動グループは、そのモニタの inactiveObject メソッドを、グループ内のオブジェクトがアクティブでなくなったときに呼び出します。起動グループは、起動グループの inactiveObject メソッドの呼び出しにより、その JVM 内のオブジェクト (グループがその起動にかかわったオブジェクト) がアクティブでなくなったことを検出します。
inactiveObject 呼び出しは、起動識別子 id を持つオブジェクトを指すリモートオブジェクト参照が有効でなくなったことを ActivationMonitor に知らせます。これにより、モニタは id に関連付けられた参照が古い参照であると見なします。この参照は古い参照であると見なされるため、それ以降、同じ起動識別子を指定して activate を呼び出すと、リモートオブジェクトは再度起動されます。指定されたオブジェクトが ActivationMonitor が知らないオブジェクトである場合は、inactiveObject メソッドは UnknownObjectException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。
activeObject は、id に関連付けられたオブジェクトが現在アクティブな状態にあることを ActivationMonitor に知らせます。パラメータ obj には、オブジェクトの整列化された形式のスタブを指定します。ActivationGroup は、グループ内のオブジェクトがシステムにより直接起動される以外の方法でアクティブになった場合 (オブジェクトが自分自身で登録して起動した場合など) は、それをモニタに知らせなければなりません。指定されたオブジェクト id が登録されていない場合は、activeObject は UnknownObjectException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。
inactiveGroup は、id と incarnation で指定されたグループが現在アクティブでないことをモニタに知らせます。グループ内のオブジェクトを起動する要求がそれ以降発生すると、グループはより大きな生成番号で再作成されます。グループ内のすべてのオブジェクトが、自分がアクティブでなくなったことを報告すると、グループはアクティブでなくなります。指定されたグループ id が登録されていないか、指定された生成番号がグループの現在の生成番号よりも小さい場合は、inactiveGroup メソッドは UnknownGroupException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。

7.4.4 `ActivationInstantiator` クラス

ActivationInstantiator は、起動可能オブジェクトのインスタンスを生成する役割を持ちます。ActivationGroup の具象サブクラスでは、グループ内でのオブジェクトの作成を処理するため newInstance を実装しています。

package java.rmi.activation;
public interface ActivationInstantiator
	extends java.rmi.Remote
{
	public MarshalledObject newInstance(ActivationID id,
					    ActivationDesc desc)
		throws ActivationException, java.rmi.RemoteException;

}

アクティベータは、起動識別子 id と起動記述子 desc を持つオブジェクトをグループ内に再作成するため、インスタンシエータの newInstance メソッドを呼び出します。インスタンシエータは、次のような役割を持ちます。

起動記述子の getClassName メソッドを使用してオブジェクトのクラスを調べます。
getLocation メソッドを使って起動記述子から取得したコードベースパスから、そのクラスをロードします。

オブジェクトの ActivationID と、オブジェクト固有の初期化データが含まれる MarshalledObject の 2 つの引数をとるオブジェクトのクラスの特別な「起動」コンストラクタを呼び出して、そのクラスのインスタンスを生成する

作成したリモートオブジェクトが含まれる MarshalledObject を返す

また、インスタンシエータは、適切な inactiveObject を呼び出せるように、作成または起動したオブジェクトがアクティブでなくなったことをその ActivationMonitor に報告する役割も持ちます (詳細は ActivationGroup クラスを参照)。
オブジェクトの起動が失敗した場合は、newInstance メソッドは ActivationException をスローします。リモート呼び出しが失敗した場合は、RemoteException をスローします。

7.4.5 `ActivationGroupDesc` クラス

起動グループ記述子 (ActivationGroupDesc) には、同じ JVM 内でオブジェクトを起動する起動グループを作成または再作成するのに必要な情報が含まれます。
起動グループ記述子に含まれるものは次のとおりです。

グループのクラス名 (クラス名が null の場合、デフォルトの ActivationGroup 実装を表す)
グループのコードベースパス (グループのクラスの場所)

オブジェクト固有の初期化データを保持できる「整列化された」オブジェクト

グループのクラスは、ActivationGroup の具象サブクラスでなければなりません。ActivationGroup のサブクラスは、次の 2 つの引数をとる特別なコンストラクタを呼び出す static メソッド ActivationGroup.createGroup により作成または再作成されます。

グループの ActivationGroupID
グループの初期化データ (java.rmi.MarshalledObject 内)

package java.rmi.activation;
public final class ActivationGroupDesc
	implements java.io.Serializable
{

	public ActivationGroupDesc(java.util.Properties props,
				   CommandEnvironment env);;

	public ActivationGroupDesc(String className,
				   String codebase,
				   java.rmi.MarshalledObject data,
				   java.util.Properties props,
				   CommandEnvironment env);

	public String getClassName();

	public String getLocation();

	public java.rmi.MarshalledObject getData();

	public CommandEnvironment getCommandEnvironment();

	public java.util.Properties getPropertiesOverrides();

}

1 つ目のコンストラクタは、グループの実装とコード位置としてシステムのデフォルトを使用するグループ記述子を作成します。プロパティは、Java アプリケーション環境のオーバーライド (グループ実装の JVM 内のシステムプロパティをオーバーライドする) を指定します。コマンド環境では、子 JVM の起動に使用される正確なコマンドやオプションを制御するか、または null を設定して rmid のデフォルトを受け入れることが可能です。このコンストラクタは、グループクラス名 null を使って ActivationGroupDesc を作成します。グループクラス名 null は、システムのデフォルトである ActivationGroup 実装を表します。
2 番目のコンストラクタは最初と同じですが、Properties および CommandEnvironment を指定できるようになっています。
getClassName メソッドは、グループのクラス名 (null の場合が多い) を返します。グループクラス名 null は、システムのデフォルトである ActivationGroup 実装を表します。
getLocation メソッドは、グループのクラスのロード元となるコードベースパスを返します。
getData メソッドは、整列化された形式のグループの初期化データを返します。
getCommandEnvironment メソッドは、コマンド環境 (null の場合が多い) を返します。
getPropertiesOverrides メソッドは、この記述子のプロパティオーバーライド (null の場合が多い) を返します。

7.4.6 `ActivationGroupDesc.CommandEnvironment` クラス

CommandEnvironment クラスを使用すると、デフォルトのシステムプロパティのオーバーライド、および実装で定義された ActivationGroup のオプション指定が可能になります。

public static class CommandEnvironment
	implements java.io.Serializable
{
	public CommandEnvironment(String cmdpath, String[] args);
	public boolean equals(java.lang.Object);
	public String[] getCommandOptions();
	public String getCommandPath();
	public int hashCode();
}

コンストラクタは、指定されたコマンド、cmdpath、および追加コマンド行オプション args を使って CommandEnvironment を作成します。
equals は、コマンド環境オブジェクトに等しい内容を実装します。必要に応じて CommandEnvironment がハッシュテーブルに格納されるように、hashCode メソッドが適宜に実装されます。
getCommandOptions メソッドは、環境オブジェクトのコマンド行オプションを返します。
getCommandPath メソッドは、環境オブジェクトのコマンド文字列を返します。

7.4.7 `ActivationGroupID` クラス

登録された起動グループの識別子は、次のような役割を持ちます。

起動システム内でグループを一意に識別する

必要時にグループがその起動システムにアクセスできるように、グループの起動システムへの参照を保持する

ActivationGroupID は、ActivationSystem.registerGroup を呼び出すことで取得でき、起動システム内でのグループの識別に使用されます。このグループ識別子は、起動グループの作成または再作成時に、起動グループの特別なコンストラクタに引数として引き渡すことができます。

package java.rmi.activation;
public class ActivationGroupID implements java.io.Serializable
{
	public ActivationGroupID(ActivationSystem system);

	public ActivationSystem getSystem();

	public boolean equals(Object obj);

	public int hashCode();
}

ActivationGroupID のコンストラクタは、ActivationSystem が system で指定された一意のグループ識別子を作成します。
getSystem メソッドは、グループの起動システムを返します。
hashCode メソッドは、グループの識別子のハッシュコードを返します。同じリモートグループを参照する 2 つのグループ識別子は、同じハッシュコードを持ちます。
equals メソッドは、2 つのグループ識別子を比較して、内容が等しいかどうかを調べます。このメソッドは、1) 一意の識別子が内容的に同一であり、なおかつ、2) それぞれの識別子で指定された起動システムが同一のリモートオブジェクトを参照している場合は、true を返します。

7.4.8 `ActivationGroup` クラス

ActivationGroup は、そのグループ内に「起動可能」オブジェクトの新しいインスタンスを生成し、次の場合に ActivationMonitor に通知します。

a. そのオブジェクトがアクティブになったとき

b. そのオブジェクトがアクティブでなくなったとき

c. グループ全体がアクティブでなくなったとき
ActivationGroup が「最初に」作成されるのは、次のいずれかの場合です。

オブジェクトの「デフォルト」の ActivationDesc 作成の副作用として
ActivationGroup.createGroup メソッドを明示的に呼び出した場合

ActivationGroupDesc の登録のみが行われているグループの最初のオブジェクトを起動した副作用として

ActivationGroup を「再作成」できるのはアクティベータだけです。アクティベータは、登録されている起動グループごとに、必要に応じて独立した JVM (たとえば、子プロセスとして) を生成し、起動要求を適切なグループに転送します。JVM をどのように生成するかは、実装に任せられます。起動グループは、static メソッド ActivationGroup.createGroup により作成します。createGroup メソッドには、作成するグループに関して、1) グループは ActivationGroup の具象サブクラスでなければならない、2) グループは次の 2 つの引数をとるコンストラクタを持っていなければならない、という決まりがあります。

グループの ActivationGroupID
グループの初期化データ (MarshalledObject 内)

作成時、ActivationGroup のデフォルトの実装では、システムプロパティは ActivationGroupDesc が作成されたときのシステムプロパティ値に設定され、セキュリティマネージャは java.rmi.RMISecurityManager に設定されます。グループ内でオブジェクトが起動されるときに、いくつかのプロパティについては独自の値を設定したい場合は、任意の ActivationDesc が作成される前、つまり、デフォルトの ActivationGroupDesc が作成される前に設定するようにすべきです。

package java.rmi.activation;
public abstract class ActivationGroup
	extends UnicastRemoteObject
	implements ActivationInstantiator
{
	protected ActivationGroup(ActivationGroupID groupID)
		throws java.rmi.RemoteException;

	public abstract MarshalledObject newInstance(ActivationID id,
						     ActivationDesc desc)
		throws ActivationException, java.rmi.RemoteException;

	public abstract boolean inactiveObject(ActivationID id)
		throws ActivationException, UnknownObjectException,
		       java.rmi.RemoteException;

	public static ActivationGroup createGroup(ActivationGroupID id,
					          ActivationGroupDesc desc,
						  long incarnation)
		throws ActivationException;

	public static ActivationGroupID currentGroupID();

	public static void setSystem(ActivationSystem system)
		throws ActivationException;

	public static ActivationSystem getSystem()
		throws ActivationException;

	protected void activeObject(ActivationID id,
				    java.rmi.MarshalledObject mobj)
		throws ActivationException, UnknownObjectException,
		       java.rmi.RemoteException;

	protected void inactiveGroup()
		throws UnknownGroupException, java.rmi.RemoteException;

}

アクティベータは、起動記述子 desc を持つオブジェクトを起動するため、起動グループの newInstance メソッドを呼び出します。起動グループは、次のような役割を持ちます。

起動記述子の getClassName メソッドを使用してオブジェクトのクラスを調べます。
getLocation メソッドを使って起動記述子から取得した URL から、そのクラスをロードします。

オブジェクトの ActivationID と、オブジェクトの初期化データが含まれる MarshalledObject の 2 つの引数をとるオブジェクトのクラスの特別なコンストラクタを呼び出して、そのクラスのインスタンスを生成します。

作成したリモートオブジェクトを直列化したものをアクティベータに返します。

指定された記述子に対応するインスタンスを生成できなかった場合は、newInstance メソッドは ActivationException をスローします。
グループの inactiveObject メソッドは、Activatable.inactive メソッドの呼び出しを介して間接的に呼び出されます。リモートオブジェクトの実装では、そのオブジェクトがアクティブでなくなったとき (アクティブでなくなったとみなされるとき) に Activatable の inactive メソッドを呼び出さなければなりません。オブジェクトは、アクティブでなくなったときに Activatable.inactive を呼び出すようにしないと、グループは作成したオブジェクトへの強い参照を保持したままになるため、そのようなオブジェクトのガベージコレクトは行われなくなります。
グループの inactiveObject メソッドは、リモートオブジェクトがクライアントからの RMI 呼び出しに応じられないようにするため、id に関連付けられたリモートオブジェクトを RMI ランタイムからアンエクスポートします (リモートオブジェクトに対する保留状態の呼び出しや実行中の呼び出しがない場合に限る)。オブジェクトへの保留状態の呼び出しや実行中の呼び出しがある場合、inactiveObject は false を返し、アクションをとりません。
unexportObject オペレーションが成功すると (オブジェクトには保留状態または実行中の呼び出しがないことを意味する)、グループは、リモートオブジェクトが現在アクティブでない状態にあり、したがって、それ以降の起動要求時にはアクティベータによって再度起動できることを、その ActivationMonitor に知らせます (モニタの inactiveObject を使用)。オペレーションが成功すると、inactiveObject は true を返します。ActivationGroup によりオブジェクトがアクティブであると見なされる場合でも、すでにアンエクスポートされている場合は、このメソッドの呼び出しは成功することがあります。
このオブジェクトがアクティブでないとすでに報告されている場合や、この起動グループで一度も起動されたことがないなどの理由から、起動グループがこのオブジェクトを知らない場合は、inactiveObject メソッドは UnknownObjectException をスローします。アクティベータまたは起動グループのリモート呼び出しが失敗するなどの非起動処理が失敗した場合は、RemoteException をスローします。
createGroup メソッドは、現在の JVM 用に起動グループを作成し、設定を行います。起動グループを設定できるのは、それが現在設定されていない場合だけです。起動グループは、activate 要求を処理するため、Activator が起動グループの再作成を開始したときに createGroup によって設定されます。グループをこのメソッドで作成する前には、グループ記述子を ActivationSystem に登録しておく必要があります (前の登録から得た ActivationID を渡す)。
ActivationGroupDesc (desc) で指定するグループは、ActivationGroup の具象サブクラスでなければならず、そのグループの ActivationGroupID と、そのグループの初期化データが含まれた MarshalledObject (ActivationGroupDescから取得) の 2 つの引数をとる public コンストラクタを持っていなければなりません。ActivationGroupDesc.getClassName メソッドが null を返す場合、システムのデフォルトグループ実装が使用されます。注: 独自のカスタム起動グループを作成する場合、グループのコンストラクタでセキュリティマネージャを設定するようにしなければなりません。コンストラクタ内にセキュリティマネージャを設定しないと、グループの中でオブジェクトを起動することはでき��取馨�釈�釶辣就乙干⊂次⑬�⑬昭��勲堪��若閼緇浴鴦葹跛繖�裙笏鹿竢粤��ぢクラス
MarshalledObject はオブジェクトのコンテナで、RMI 呼び出しの際にオブジェクトをパラメータとして引き渡せるようにするものですが、受け取った側でのオブジェクトの直列化復元は、コンテナオブジェクト呼び出しを介してアプリケーションがそのオブジェクトを明示的に要求するまで延期されます。MarshalledObject に含まれる Serializable オブジェクトは、RMI 呼び出しの際に引き渡されたパラメータと同じセマンティクスで、要求時に直列化および直列化復元が行われます。これは、MarshalledObject 内のすべてのリモートオブジェクトが、そのスタブの直列化されたインスタンスによって表現されることを意味します。MarshalledObject に含まれるオブジェクトは、リモートオブジェクト、非リモートオブジェクトのどちらか、またはリモートと非リモートのオブジェクトの両方がそろったもののいずれかになります。
オブジェクトが MarshalledObject ラッパーの中に置かれると、直列化されたそのオブジェクトにコードベース URL (クラスのロード元) の情報が付加されます。同様に、MarshalledObject ラッパーからオブジェクトが取り出されるときは、そのオブジェクトのコードがローカルになければ、直列化の際に付加された URL から、そのオブジェクトのクラスのバイトコードが特定されロードされます。
package java.rmi;
public final class MarshalledObject implements java.io.Serializable
{
	public MarshalledObject(Object obj)
		throws java.io.IOException;

	public Object get()
		throws java.io.IOException, ClassNotFoundException;

	public int hashCode();

	public boolean equals();
}
MarshalledObject のコンストラクタは、引数として直列化可能なオブジェクト obj をとり、オブジェクトがバイトストリームに整列化された形式のものを保持します。整列化された形式のオブジェクトは、次のように、RMI 呼び出しの際に引き渡されるオブジェクトのセマンティクスを保持します。

get メソッドの呼び出しによりオブジェクトが再構築されるときに、各クラスのバイトコードを特定、ロードできるように、ストリーム中の各クラスには、そのコードベース URL 情報が付加される
リモートオブジェクトは、そのプロキシスタブで置き換えられる

MarshalledObject クラスのインスタンスが java.io.ObjectOutputStream に書き出されるときは、その中に含まれる整列化された形式のオブジェクト (構築時に作成されたもの) がストリームに書き出されます。したがって、バイトストリームだけが直列化されます。
MarshalledObject が java.io.ObjectInputStream から読み出されるときは、その中に含まれるオブジェクトは具象オブジェクトに直列化復元はされません。整列化されたオブジェクトの get メソッドが呼び出されるまで、オブジェクトは整列化された形式のままです。
get メソッドは、常に、整列化された形式で含められているオブジェクトの新しいコピーを再構築します。内部表現は、RMI 呼び出しの非整列化パラメータに対して使用されるセマンティクスで直列化復元されます。したがって、オブジェクトの表現を直列化復元すると、直列化されたオブジェクトのストリームに埋め込まれた URL 情報を使用してクラスコードがロードされます (ローカルにない場合)。
整列化された形式のオブジェクトの hashCode は、コンストラクタに引き渡されたオブジェクトと同じです。equals メソッドは、整列化された形式のオブジェクトどうしを比較し、それらが等価であれば true を返します。equals が比較を実行する際、クラスのコードベース注釈は無視されます。これは、2 つのオブジェクトが同じ直列化表現を保持する場合、それらは等価であることを意味します (直列化表現内の各クラスのコードベースを除く)。
目次 | 前の項目 | 次の項目
Copyright © 1997-1999 Sun Microsystems, Inc. All Rights Reserved.

7.4 起動インタフェース

7.4.1 Activator インタフェース

7.4.2 ActivationSystem インタフェース

7.4.3 ActivationMonitor クラス

7.4.4 ActivationInstantiator クラス

7.4.5 ActivationGroupDesc クラス

7.4.6 ActivationGroupDesc.CommandEnvironment クラス

7.4.7 ActivationGroupID クラス

7.4.8 ActivationGroup クラス

7.4.1 `Activator` インタフェース

7.4.2 `ActivationSystem` インタフェース

7.4.3 `ActivationMonitor` クラス

7.4.4 `ActivationInstantiator` クラス

7.4.5 `ActivationGroupDesc` クラス

7.4.6 `ActivationGroupDesc.CommandEnvironment` クラス

7.4.7 `ActivationGroupID` クラス

7.4.8 `ActivationGroup` クラス