| 目次 | 前の項目 | 次 の項目 | Java Remote Method Invocation |
起動識別子を介してアクセスできるリモートオブジェクトを作成するには、次のような準備が必要です。起動記述子 (ActivationDesc) は、次のどれかの方法で登録できます。起動用にオブジェクトを登録するときは、上のどれか 1 つの方法だけを使用してください。複数の方法を使用しないでください。起動可能オブジェクトの実装方法の例については、後述する「起動可能リモートオブ ジェクトの構築」を参照してください。
7.3.1
ActivationDescクラスActivationDescには、オブジェクトの起動に必要な情報が含まれます。具体的には、オブジェクトの起動グループ識別子、オブジェクトのクラス名、オブジェクトのコードの ロード元のコードベースパス (URL)、および、起動のたびに使用されるオブジェクト固有の初期化データが含まれるMarshalledObjectが含まれます。起動システムに登録された記述子は、オブジェクトの再作成または起動に必要な情報を取得するため、起動プロセス中に参照されます。オブジェクトの記述子に 含まれる
MarshalledObjectは、オブジェクトのリモートオブジェクトのコンストラクタに 2 番目の引数として、起動時に使用するために渡されます。package java.rmi.activation;public final class ActivationDesc implements java.io.Serializable { public ActivationDesc(String className, String codebase, java.rmi.MarshalledObject data) throws ActivationException; public ActivationDesc(String className, String codebase, java.rmi.MarshalledObject data, boolean restart) throws ActivationException; public ActivationDesc(ActivationGroupID groupID, String className, String codebase, java.rmi.MarshalledObject data, boolean restart); public ActivationDesc(ActivationGroupID groupID, String className, String codebase, java.rmi.MarshalledObject data); public ActivationGroupID getGroupID(); public String getClassName(); public String getLocation(); public java.rmi.MarshalledObject getData() public boolean getRestartMode(); }
ActivationDescの 1 つ目のコンストラクタは、オブジェクト記述子を構築します。対象となるオブジェクトは、クラスが、codebase で指定されたコードベースパスからロードできる className、および整列化された形式の初期化情報が data であるオブジェクトです。この形式のコンストラクタが使用される場合、オブジェクトのグループ識別子は、デフォルトでその JVM のActivationGroupの現在の識別子になります。同じActivationGroupIDを持つオブジェクトは、すべて同じ JVM 内で起動されます。現在のグループがアクティブでない場合は、ActivationExceptionがスローされます。groupID がnullの場合は、IllegalArgumentExceptionがスローされます。ActivationDescの 2 つ目のコンストラクタは、1 つ目のコンストラクタと同じようにしてオブジェクト記述子を構築しますが、パラメータ restart も指定する必要があります。オブジェクトの「再起動サービス」を必要とする場合、つまり、アクティベータの再起動時にオブジェクトが自動的に再起動される ようにするには (必要なときに 遅延起動するのとは反対)、restart にtrueを指定します。restart にfalseを指定すると、オブジェクトは必要なときにのみリモートメソッド呼び出しにより起動されます。
ActivationDescの 3 つ目のコンストラクタは、グループ識別子が groupID で、クラス名が、codebase で指定されたコードベースパスからロードできる className、および初期化情報が data であるオブジェクトのオブジェクト記述子を構築します。同じ groupID を持つオブジェクトは、すべて同じ JVM 内で起動されます。
ActivationDescの 4 つ目のコンストラクタは、3 つ目のコンストラクタと同じようにしてオブジェクト記述子を構築しますが、再起動モードを指定できるようになっています。前述したオブジェクトの再起動 サービスが必要な場合は、restart にtrueを指定します。
getGroupIDメソッドは、記述子で指定されたオブジェクトのグループ識別子を返します。グループは、複数のオブジェクトを 1 つの Java 仮想マシンにまとめる役割を果たします。
getClassNameメソッドは、起動記述子で指定されたオブジェクトのクラス名を返します。
getLocationメソッドは、オブジェクトのクラスのダウンロード元となるコードベースパスを返します。
getDataメソッドは、記述子で指定されたオブジェクトの初期化 (起動) データが含まれる「整列化されたオブジェクト」を返します。
getRestartModeメソッドは、このオブジェクトの再起動モードが有効になっている場合はtrueを返し、無効になっている場合はfalseを返します。
7.3.2
ActivationIDクラス起動プロトコルでは、起動識別子を使用して、しばらく起動可能なリモートオブジェクトを表します。起動識別子 (ActivationIDクラスのインスタンス) には、オブジェクトを起動するために必要な次のような情報が含まれています。オブジェクトの起動識別子は、オブジェクトを起動システムに登録することで取得できます。登録は次のような方法で行えます (前述の内容にも留意のこと)。package java.rmi.activation;public class ActivationID implements java.io.Serializable { public ActivationID(Activator activator); public Remote activate(boolean force) throws ActivationException, UnknownObjectException, java.rmi.RemoteException; public boolean equals(Object obj); public int hashCode(); }
ActivationIDのコンストラクタは、activator という引数だけをとります。 この引数には、この起動識別子に関連付けられたオブジェクトを起動するアクティベータへのリモート参照を指定します。ActivationIDのインスタンスは、大域的に一意になります。
activateメソッドは、起動識別子に関連付けられたオブジェクトを起動します。force パラメータに true を指定すると、キャッシュされているリモートオブジェクトの参照は古い参照であると見なされ、オブジェクトの起動時にはグループへの問い合わせが強制的に 行われます。force に false を指定すると、キャッシュされた値が使用されます。起動に失敗した場合は、ActivationExceptionがスローされます。オブジェクト識別子がアクティベータに認識されない識別子である場合、activateメソッドはUnknownObjectExceptionをスローします。アクティベータへのリモート呼び出しが失敗した場合は、RemoteExceptionがスローされます。
equalsメソッドは、内容が等しいかどうかをチェックするメソッドです。このメソッドは、すべてのフィールドが等価 (各フィールドのObject.equalsのセマンティクスに照らし合わせて同一または等価) である場合はtrueを返します。p1 と p2 がActivationIDクラスのインスタンスであるとすると、p1.equals(p2)がtrueを返す場合は、hashCodeメソッドは同じ値を返します。
7.3.3
ActivatableクラスActivatableクラスは、持続的アクセスを必要とする、システムにより起動可能なリモートオブジェクトを扱うためのサポートを提供します。Activatableクラスは、起動可能オブジェクトの実装および管理に使用する必要のある中心的な API です。なお、オブジェクトの登録や起動を行うためには、事前に起動システムデーモンrmidを動作させておく必要があります。package java.rmi.activation;public abstract class Activatable extends java.rmi.server.RemoteServer { protected Activatable(String codebase, java.rmi.MarshalledObject data, boolean restart, int port) throws ActivationException, java.rmi.RemoteException; protected Activatable(String codebase, java.rmi.MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws ActivationException, java.rmi.RemoteException; protected Activatable(ActivationID id, int port) throws java.rmi.RemoteException; protected Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws java.rmi.RemoteException; protected ActivationID getID(); public static Remote register(ActivationDesc desc) throws UnknownGroupException, ActivationException, java.rmi.RemoteException; public static boolean inactive(ActivationID id) throws UnknownObjectException, ActivationException, java.rmi.RemoteException; public static void unregister(ActivationID id) throws UnknownObjectException, ActivationException, java.rmi.RemoteException; public static ActivationID exportObject(Remote obj, String codebase, MarshalledObject data, boolean restart, int port) throws ActivationException, java.rmi.RemoteException; public static ActivationID exportObject(Remote obj, String codebase, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws ActivationException, java.rmi.RemoteException; public static Remote exportObject(Remote obj, ActivationID id, int port) throws java.rmi.RemoteException; public static Remote exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws java.rmi.RemoteException; public static boolean unexportObject(Remote obj, boolean force) throws java.rmi.NoSuchObjectException; }
起動可能リモートオブジェクトの実装は、Activatableクラスを extends 節で拡張しているかどうかに依存していません。Activatableクラスを拡張するリモートオブジェクトの実装では、スーパークラスjava.rmi.server.RemoteObjectから適切なhashCodeメソッドとequalsメソッドの定義が継承されます。したがって、同一のActivatableリモートオブジェクトを参照する 2 つのリモートオブジェクト参照は等価になります (equalsメソッドが true を返す)。また、Activatableクラスのインスタンスは、その適切なスタブオブジェクトと等しくなります。たとえば、Object.equalsメソッドを、その引数にオブジェクトの実装に対応するスタブオブジェクトを指定して呼び出すと、true が返されます (逆の場合も同様)。
Activatable クラスメソッド
Activatableクラスの 1 つ目のコンストラクタは、オブジェクトの登録と指定されたポート port でのオブジェクトのエクスポートに使用します。 port にゼロを指定した場合は匿名ポートが選ばれます。codebase には、オブジェクトのクラスコードのダウンロード元となる URL パスを指定し、data にはその初期化データを指定します。restart にtrueを指定すると、アクティベータが再起動し、かつグループがクラッシュした場合に、オブジェクトが自動的に再起動されるようになります。restart にfalseを指定すると、オブジェクトは必要なときにのみリモートメソッド呼び出しにより起動されるようになります。このコンストラクタは、オブジェクトを「最初の」構築時に登録およびエクスポートするため、
Activatableクラスの具象サブクラスから呼び出さなければなりません。起動可能オブジェクト構築の副作用として、クライアントからの呼び出しに応じられるように、リ モートオブジェクトが起動システムに「登録」されると同時に RMI ランタイムに「エクスポート」されます (port にゼロを指定した場合は匿名ポートで)。このコンストラクタは、起動システムへのオブジェクトの登録が失敗した場合は
ActivationExceptionをスローします。RMI ランタイムへのオブジェクトのエクスポートが失敗した場合はRemoteExceptionをスローします。2 つ目のコンストラクタは、
Activatableの最初のコンストラクタと同じですが、この起動可能オブジェクトとのやりとりに使用するクライアントソケットファクトリとサーバソケットファクトリを指定 できるようになっています。詳細は、「RMI ソケットファクトリ」に関す る節を参照してください。3 つ目のコンストラクタは、オブジェクトの起動と指定されたポート port でのオブジェクトのエクスポート (
ActivationIDid を使用) に使用します。このコンストラクタは、オブジェクト自身が、次のパラメータをとる特別な「起動」コンストラクタにより「起動」されるときにActivatableクラスの具象サブクラスから呼び出さなければなりません。構築の副作用として、リモートオブジェクトは指定されたポート port で RMI ランタイムに「エクスポート」され、クライアントからの呼び出しに応じられるようになります。このコンストラクタは、RMI ランタイムへのオブジェクトのエクスポートが失敗した場合はRemoteExceptionをスローします。4 つ目のコンストラクタは 3 つ目のコンストラクタと同じですが、この起動可能オブジェクトとのやりとりに使用するクライアントソケットファクトリとサーバソケットファクトリを指定で きるようになっています。
getIDメソッドは、オブジェクトの起動識別子を返します。このメソッドは、サブクラスだけがオブジェクトの識別子を取得できるように protected 指定されています。オブジェクトの識別子は、オブジェクトがアクティブでないことを報告する場合、またはオブジェクトの起動記述子の登録を解除する場合に 使用します。
registerメソッドは、起動可能リモートオブジェクトを必要なときに起動できるように、そのオブジェクト記述子 desc を起動システムに登録します。このメソッドを使用するのは、起動可能オブジェクトを、事前に作成しないで登録するときです。このメソッドは、起動可能オブ ジェクトをあとで保存したり呼び出したりできるように、そのRemoteスタブを返します。この結果、起動可能オブジェクトは、初めに強制的に作成または起動されます。desc のグループ識別子が起動システムに登録されていない場合は、このメソッドはUnknownGroupExceptionをスローします。起動システムが動作していない場合はActivationExceptionをスローします。また、起動システムのリモート呼び出しが失敗した場合はRemoteExceptionをスローします。
inactiveメソッドは、指定した起動 id を持つオブジェクトが現在アクティブでないことをシステムに知らせるために使用します。現時点でアクティブとされているオブジェクトは、クライアントから の呼び出しを受けないように RMI ランタイムからアンエクスポートされます (保留状態の呼び出しや実行中の呼び出しがない場合だけ)。また、このメソッドを呼び出すと、この JVM のActivationGroupにもオブジェクトがアクティブでないことが知らされ、これを受けて、ActivationGroupは、そのActivationMonitorにオブジェクトがアクティブでないことを知らせます。このメソッドの呼び出しが成功した場合、それ以降、アクティベータに対して起動要求があると、オブ ジェクトは再度起動されます。inactiveメソッドは、オブジェクトのアンエクスポートに成功した場合、つまり、保留状態の呼び出しや実行中の呼び出しがない場合はtrueを返し、保留状態の呼び出しや実行中の呼び出しが存在するためにオブジェクトをアンエクスポートできなかった場合はfalseを返します。指定したオブジェクトがアクティベータに認識されないオブジェクトである場合 (すでにアクティブでなくなっている可能性あり)、このメソッドはUnknownObjectExceptionをスローします。グループがアクティブでない場合はActivationExceptionをスローします。モニタにオブジェクトがアクティブでないことを知らせるのに失敗した場合はRemoteExceptionをスローします。オブジェクトがアクティブであると見られる場合であっても、すでにアンエクスポートされている場合は、このメソッドの呼び出しは成功する ことがあります。
unregisterメソッドは、id に関連付けられた起動記述子の登録を解除します。この結果、オブジェクトはその id で起動できなくなります。オブジェクト id が起動システムの知らない識別子である場合は、UnknownObjectExceptionがスローされます。起動システムが動作していない場合は、ActivationExceptionがスローされます。起動システムのリモート呼び出しが失敗した場合は、RemoteExceptionがスローされます。1 つ目の
exportObjectメソッドは、extends 節でActivatableクラスを拡張していない「起動可能」オブジェクトから明示的に呼び出すことができます。このメソッドは、次の 2 つの目的に使用します。エクスポートされたオブジェクトは、RMI 呼び出しを受け取ることができるようになります。この
exportObjectメソッドは、起動記述子 desc を起動システムに登録して取得した起動識別子を返します。起動グループが JVM でアクティブになっていない場合は、ActivationExceptionがスローされます。オブジェクトの登録またはエクスポートが失敗した場合は、RemoteExceptionがスローされます。obj が extends 節で
Activatableを拡張している場合は、Activatableの 1 つ目のコンストラクタがこのメソッドを呼び出すため、このメソッドを呼び出す必要はありません。2 つ目の
exportObjectメソッドは、1 つ目のexportObjectメソッドと同じですが、起動可能オブジェクトとのやりとりに使用するクライアントソケットファクトリとサーバソケットファクトリを指定できるようになって います。3 つ目の
exportObjectメソッドは、識別子 id を持つ「起動可能」リモートオブジェクト (必ずしもActivatable型である必要はない) を RMI ランタイムにエクスポートし、オブジェクト obj がクライアントからの呼び出しに応じられるようにします。port にゼロを指定した場合は、オブジェクトは匿名ポートでエクスポートされます。起動中、この
exportObjectメソッドは、Activatableクラスを拡張しない「起動可能」オブジェクトから明示的に呼び出される必要があります。Activatableクラスを拡張しているオブジェクトの場合は、このメソッドを直接呼び出す必要はありません。この場合、このメソッドは上の 3 つ目のコンストラクタ (サブクラスがその特別な起動コンストラクタから呼び出すコンストラクタ) により呼び出されます。この
exportObjectメソッドは、起動可能オブジェクトのRemoteスタブを返します。オブジェクトのエクスポートに失敗した場合は、このメソッドはRemoteExceptionをスローします。4 つ目の
exportObjectメソッドは 3 つ目のexportObjectメソッドと同じですが、この起動可能オブジェクトとのやりとりに使用するクライアントソケットファクトリとサーバソケットファクトリを指定できるように なっています。
unexportObjectメソッドを使うと、着呼がリモートオブジェクト obj を利用できなくなります。force パラメータがtrueの場合は、たとえそのリモートオブジェクトに対する保留中または進行中の呼び出しがある場合でも、オブジェクトは強制的にアンエクスポートされます。 force パラメータにfalseを指定すると、保留状態の呼び出しや実行中の呼び出しがない場合に限り、オブジェクトはアンエクスポートされます。オブジェクトが正常にアンエクスポート された場合は、RMI のランタイムによってそのオブジェクトが内部テーブルから削除されます。RMI から強制的にオブジェクトを削除すると、クライアントはそのリモートオブジェクトへの古い参照を保持したままになってしまう可能性があります。オブジェク トが事前に RMI のランタイムにエクスポートされていない場合は、このメソッドは、java.rmi.NoSuchObjectExceptionをスローします。
起動可能リモートオブジェクトの構築
オブジェクトを起動できるようにするには、「起動可能」オブジェクトの実装クラス (Activatableクラスを拡張しているかどうかにかかわらず) で、その起動識別子 (ActivationID型のもの) と、その起動データjava.rmi.MarshalledObject(登録時に使用した起動識別子で提供したもの) の 2 つの引数をとる特別な public コンストラクタを定義する必要があります。起動グループは、その JVM 内でリモートオブジェクトを起動するときに、この特別なコンストラクタを使用してリモートオブジェクトを構築します (詳細は後述)。リモートオブジェクトの実装では、適切な方法により自分自身を初期化するために、起動データが使用される可能性があります。また、Activatable.inactiveメソッド呼び出しによりアクティブでなくなったときに起動グループにそれを知らせることができるように、リモートオブジェクトで、その起動識別子を保持し ておくこともできます。
Activatableの 1 つ目と 2 つ目のコンストラクタは、起動可能オブジェクトの登録と、指定されたポート port でのオブジェクトのエクスポートの両方に使用されます。このコンストラクタは、オブジェクトを最初に構築するときに使用すべきです。 3 つ目のコンストラクタは、オブジェクトを再度起動するときに使用します。
Activatableの具象サブクラスでは、最初の構築時には 1 つ目または 2 つ目のコンストラクタ形式を呼び出して、オブジェクトの登録とエクスポートを行う必要があります。このコンストラクタは、まず、オブジェクトのクラス名、 オブジェクト用に提供された codebase および data により起動記述子 (ActivationDesc) を作成します。 また、その起動グループは JVM のデフォルトのグループになります。次に、作成した起動記述子をデフォルトのActivationSystemに登録します。最後に、起動可能オブジェクトを特定のポート port で RMI ランタイムにエクスポートし (port にゼロを指定した場合は匿名ポートが選ばれる)、オブジェクトをactiveObjectとしてローカルなActivationGroupに報告します。登録中かエクスポート中にエラーが発生した場合は、このコンストラクタはRemoteExceptionをスローします。なお、それ以降、protected メソッドgetIDを呼び出すとオブジェクトの起動識別子が返されるように、オブジェクトのActivationID(登録により取得したもの) の初期化も行います。
Activatableの 3 つ目のコンストラクタ形式は、指定されたポートでのオブジェクトのエクスポートに使用されます。この 3 つ目のコンストラクタ形式は、オブジェクト自身が次の 2 つの引数をとるオブジェクト自身の「起動」コンストラクタにより起動されるときにActivatableクラスの具象サブクラスから呼び出さなければなりません。このコンストラクタは、指定した「ポート」 (port にゼロを指定した場合は匿名ポートが選ばれる) で起動可能オブジェクトを RMI ランタイムにエクスポートするだけです。オブジェクトはActivationGroupによって起動されており、オブジェクトがアクティブになっていることはすでに知られているため、オブジェクトがアクティブであることをActivationGroupに知らせることはしません。次のコードは、リモートオブジェクトインタフェース
Serverと、extends 節でActivatableクラスを「拡張」したServerImplの実装例です。package examples;
public interface Server extends java.rmi.Remote {
public void doImportantStuff()
throws java.rmi.RemoteException;
}
public class ServerImpl extends Activatable implements Server
{
// Constructor for initial construction, registration and export
public ServerImpl(String codebase, MarshalledObject data)
throws ActivationException, java.rmi.RemoteException
{
// register object with activation system, then
// export on anonymous port
super(codebase, data, false, 0);
}
// Constructor for activation and export; this constructor
// is called by the ActivationInstantiator.newInstance
// method during activation in order to construct the object.
public ServerImpl(ActivationID id, MarshalledObject data)
throws java.rmi.RemoteException
{
// call the superclass's constructor in order to
// export the object to the RMI runtime.
super(id, 0);
// initialize object (using data, for example)
}
public void doImportantStuff() { ... }
}オブジェクトのエクスポートは、オブジェクトそのものが担当します。Activatableのコンストラクタは、UnicastRemoteObject型のライブ参照によりオブジェクトを RMI ランタイムに「エクスポート」処理します。したがって、extends 節でActivatableクラスを拡張しているオブジェクトの実装では、適切なスーパークラスのコンストラクタを呼び出す場合を除いて、オブジェクトを明示的にエクスポートする必 要はありません。extends 節でActivatableクラスを拡張していないオブジェクトの実装では、static メソッドActivatable.exportObjectのいずれかを呼び出してオブジェクトを明示的にエクスポートしなければなりません。次の例では、
ServerImplはActivatableではなく別のクラスを extends 節で拡張しています。 したがって、ServerImplは、最初の構築時と起動時に自分自身のエクスポートを担当します。このクラス定義には、ServerImplの初期化コンストラクタと特別な「起動」コンストラクタがあります。それぞれのコンストラクタの中では、オブジェクトをエクスポートするため、所定の呼び 出しを行なっています。package examples;public class ServerImpl extends SomeClass implements Server { // constructor for initial creation public ServerImpl(String codebase, MarshalledObject data) throws ActivationException, java.rmi.RemoteException { // register and export the object Activatable.exportObject(this, codebase, data, false, 0); } // constructor for activation public ServerImpl(ActivationID id, MarshalledObject data) throws java.rmi.RemoteException { // export the object Activatable.exportObject(this, id, 0); } public void doImportantStuff() { ... } }
オブジェクトを作成しないで起動記述子を登録する
起動可能リモートオブジェクトを、先に作成しないで起動システムに登録するには、その起動記述子 (ActivationDescクラスのインスタンス) をただ登録するだけでかまいません。起動記述子には、必要時に起動システムがオブジェクトを起動するのに必要なすべての情報が含まれています。examples.ServerImplクラスのインスタンスの起動記述子は、次のようにして登録できます。なお、例外処理は省略しています。
Server server;
ActivationDesc desc;
String codebase = "http://zaphod/codebase/";MarshalledObject data = new MarshalledObject("some data");
desc = new ActivationDesc( "examples.ServerImpl", codebase, data);
server = (Server)Activatable.register(desc);
registerの呼び出し行では、examples.ServerImplオブジェクトのスタブであり、examples.ServerImplで実装されているのと同じリモートインタフェースを実装したRemoteスタブが返されます。たとえば、このRemoteスタブではリモートインタフェースServerが実装されています。キャストされてserverに代入されている、このスタブオブジェクトは、リモートインタフェース examples.Server を実装したオブジェクトをとるメソッドにパラメータとして渡すことができます。
目次 | 前の項目 | 次の項目
Copyright © 1997-2004 Sun Microsystems, Inc. All Rights Reserved.