rmic を実行する
rmiregistry を開始する
rmid を開始する
ステップ 1:
リモートインタフェース、実装、クライアント、およびセットアップの各クラスをコンパイルする
% javac -d . AnotherRemoteInterface.java % javac -d . MyClass.java % javac -d . Client3.java % javac -d . Setup3.java
% rmic -d . examples.activation.MyClass
% rmiregistry &
注: rmiregistry を開始する前に、registry を実行するシェルまたはウィンドウに CLASSPATH が設定されていないこと、あるいは設定されていても、クライアントにダウンロードするクラスへのパス (リモートオブジェクトの実装クラスのスタブを含む) が含まれていないことを確認してください。
rmiregistry が、その開始時に CLASSPATH 内でスタブクラスを見つけると、サーバの java.rmi.server.codebase プロパティは無視されます。 その結果、クライアントは、そのリモートオブジェクトのスタブコードをダウンロードできません。
% rmid -J-Djava.security.policy=rmid.policy &
rmid.policy は、rmid のセキュリティポリシーファイル名です。
注: デフォルトでは、rmid は現在、セキュリティポリシーファイルを要求します。このファイルは、起動グループ用の JVM の起動に、各 ActivationGroupDescriptor の情報を使用できるかどうかを確認するために使用されます。完全な詳細については、rmid の Solaris オペレーティング環境用マニュアルページおよび rmid の Microsoft の Windows プラットフォーム用マニュアルページを参照してください。
コードベースのプロパティを実装スタブの位置に設定して、セットアップを実行します。次の 4 つを同じコマンド行に記述する必要があります。
- 「
java」コマンド - セキュリティポリシーファイルの位置を指定するプロパティの「名前」=「値」のペア
- スタブコードの位置を指定するプロパティ (「-D」から最後の「/」まで空白文字は含めない)
- セットアッププログラムの完全指定されたパッケージ名
空白文字は、java という語の直後に 1 つ、2 つのプロパティの間に 1 つ、および (ブラウザまたは紙上では判別しにくいですが) examples という語の直前に 1 つ必要です。
% java -Djava.security.policy=/home/rmi_tutorial/activation/policy
-Djava.rmi.server.codebase=file:/home/rmi_tutorial/activation/ examples.activation.Setup3
コードベースプロパティは、URL として解釈処理されます。 このため、プロパティは http://aHost/somesource/ か file:/myDirectory/location/ の形式、またはオペレーティングシステムによっては file:///myDirectory/location/ (file:のあとにスラッシュが 3 つ続く) の形式でなければなりません。
サンプルコードを実行するには file:サンプルコードを実行するには file:形式の URL の方が使いやすい場合があります。しかし、この場合、サーバにアクセスできるクライアントは、(サーバと同じマシン上で実行したり NFS などの共用ファイルシステムを使用して) サーバと同じファイルシステムにアクセスできるクライアントだけになります。HTTP サーバがまだ稼動していない場合は、米国サン・マイクロシステムズ社またはその関係会社の HTTP サーバからダウンロードすることができます。
これらのサンプル URL の各文字列には、末尾に「/」があることに注意してください。 java.rmi.server.codebase プロパティで指定する URL では、実装がクラス定義を適切に解釈処理 (検索) するために、末尾のスラッシュが必要です。コマンド行からの java.rmi.server.codebase プロパティの設定についての詳細は、java.rmi.server.codebase プロパティを使用した動的なコードのダウンロードについてのチュートリアルを参照してください。
プロパティ上の末尾のスラッシュを忘れたり、ソース位置にクラスファイルが見つからない (ダウンロード可能ではない) 場合、またはプロパティ名の入力を間違えた場合は、java.lang.ClassNotFoundException がスローされます。この例外は、リモートオブジェクトを rmiregistry にバインドしようとした場合、または最初のクライアントがそのオブジェクトのスタブにアクセスしようとした場合にスローされます。後者の場合は、rmiregistry が CLASSPATH 内でスタブを検索するため、さらに問題が発生する場合があります。
サーバ側の出力は、次のようになります。
Got the stub for MyClass
Exported MyClass
ステップ 6: クライアントを実行する
クライアントプログラムへの引数は、実装サーバのホスト名で、この場合は vector です。
% java -Djava.security.policy=/home/rmi_tutorial/activation/policy examples.activation.Client3 vector
クライアント側の出力は次のようになります。
Got a remote reference to the class MyClass
Called the remote method
Result: Watson are you there? I'm here!
別の方法
これまでの処理を別の方法で行うには、リモートインタフェースを実装する「アダプタ」クラスを作成します。 リモートインタフェースは、セットアッププログラムによってrmid およびレジストリに登録されます。 そのあと、「アダプタ」クラスによってオブジェクトのインスタンスが作成され、そのインスタンスにリモートメソッドが転送されます。この方法には、元のリモートでないクラスを変更する必要がないという利点があります。
リモートでない元のクラスが次のようであるとします。
package examples.activation;
public class MyNonRemoteClass {
private String result = null;
// Here's the original class, which concatenates two strings
//
public String calltheServer(String takeThis) {
result = takeThis + "I'm here!";
return result;
}
}
同じインタフェースである examples.activation.AnotherRemoteInterface を記述して、リモートに呼び出すメソッドを記述します。
package examples.activation;
import java.rmi.*;
public interface AnotherRemoteInterface extends Remote {
public String calltheServer(String s) throws RemoteException;
}
ただし、使用できるソースコードが MyNonRemoteClass.java にない場合もあるため、MyNonRemoteClass.java を編集するのではなく、新しいクラス examples.activation.MyNonRemoteClassAdapter を作成します。 この新しいクラスは、(イベントアダプタと同様に) 指定したインタフェースを実装し、適切な動作を実行します。前述の方法と MyNonRemoteClassAdapter を使用する方法との相違点は、MyNonRemoteClassAdapter がそのコンストラクタで MyNonRemoteClass のインスタンスを生成し、MyNonRemoteClass.calltheServer メソッドを呼び出すことです。
package examples.activation;
import java.rmi.*;
import java.rmi.activation.*;
public class MyNonRemoteClassAdapter implements
examples.activation.AnotherRemoteInterface
{
private String result = null;
private MyNonRemoteClass mnrc;
// The constructor for activation and export; this
// constructor is called by the method
// ActivationInstantiator.newInstance during
// activation, to construct the object.
//
public MyNonRemoteClassAdapter(ActivationID id,
MarshalledObject data) throws RemoteException
{
// Register the object with the activation system
// then export it on an anonymous port
//
Activatable.exportObject(this, id, 0);
// Create an instance of the class MyNonRemoteClass
//
mnrc = new MyNonRemoteClass();
}
// Define the method declared in AnotherRemoteInterface
// to accept a String, modify it, and return it to
// the client
//
public String calltheServer(String takeThis)
throws RemoteException
{
// Rather than modify the String here, forward
// it on to the non-remote object implementation
//
result = mnrc.calltheServer(takeThis);
return result;
}
}
rmic を実行するクラスおよびセットアッププログラムによって参照されるクラスは、アダプタクラスです。セットアッププログラム examples.activation.Setup3alt は、次のようになります。
package examples.activation;
import java.rmi.*;
import java.rmi.activation.*;
import java.util.Properties;
public class Setup3alt {
// This class registers information about the MyClass
// class with rmid and the rmiregistry
//
public static void main(String[] args) throws Exception {
System.setSecurityManager(new RMISecurityManager());
AnotherRemoteInterface ari;
// Don't forget the trailing slash at the end of the URL
// or your classes won't be found
//
String location = "file:/home/rmi_tutorial/activation/";
// Create the rest of the parameters that will be passed to
// the ActivationDesc constructor
//
MarshalledObject data = null;
// The second argument to the ActivationDesc constructor
// will be used to uniquely identify this class; it's
// location is relative to theURL-formatted String, location.
//
ActivationDesc desc = new ActivationDesc
("examples.activation.MyNonRemoteClassAdapter",
location, data);
ari = (AnotherRemoteInterface)Activatable.register(desc);
System.out.println("Got the stub for MyNonRemoteClassAdapter");
// Bind the stub to a name in the registry running on 1099
//
Naming.rebind("MyNonRemoteClassAdapter", ari);
System.out.println("Exported MyNonRemoteClassAdapter");
System.exit(0);
}
}
* この Web サイトで使用されている用語「Java Virtual Machine」または「JVM」は、Java プラットフォーム用の仮想マシンを表します。
| Copyright © 1999 Sun Microsystems, Inc. All Rights Reserved. コメントの送付先: rmi-comments@java.sun.com |
|