RMI-IIOP プログラマーズガイド Copyright © 1999 Sun Microsystems, Inc.  Copyright © 1999 International Business Machines Corporation. All Rights Reserved.

ドキュメントの目次

目次

• はじめに
• 背景情報
• RMI-IIOP について
• 新しい rmic コンパイラ
• 新しい idlj コンパイラ
• RMI プログラムから IIOP を使用する
• IIOP を介して RMI プログラムを実行するときの制約
• RMI Hello World プログラムを RMI-IIOP に変換する
• その他の注意事項

はじめに

背景情報

• RMI-IIOP のホームページ。RMI-IIOP のドキュメント、サンプルコード、仕様、ニュース、その他の関連 Web サイトなどへのリンクが含まれる
• RMI-IIOP FAQ ページ。RMI-IIOP に関する基本的な質問に対する回答が含まれる
• Java RMI のホームページ。 RMI ドキュメント、例、仕様などへのリンクが含まれる。必ず読んでください。
• 「RMI」。Java チュートリアル
• RMI API ドキュメント
• Java IDL の Web ページ。 Sun の CORBA/IIOP 実装の概要
• 「IDL」。Java チュートリアル
• 「Java Language to IDL Mapping」。RMI-IIOP の詳細な技術仕様

RMI-IIOP について

RMI

RMI には、ほかの言語との相互運用性はありません。 また、非標準の通信プロトコルを使用しているため、CORBA オブジェクトと通信することができません。

IIOP、CORBA、および Java IDL

JDK の CORBA/IIOP 実装は、Java IDL と呼ばれています。idltojava コンパイラおよび Java IDL を使用して、Java プログラミング言語から CORBA オブジェクトの定義、実装、およびアクセスを行うことができます。

「Java IDL」 Web ページでは、CORBA/IIOP プログラミングについて Java を中心にわかりやすく説明されています。Java IDL プログラムの作成についての概要は、「入門: Hello World」Web ページを参照してください。

RMI-IIOP

新しい rmic コンパイラ

新しい rmic のフラグを次に示します。

-iiop -- IIOP スタブ/Tie を生成する
-idl -- IDL を生成する
-noValueMethods -- IDL の valuetype 内にメソッドとコンストラクタが生成されないようにする
-always -- 既存のスタブ、Tie、または idl が入力クラスより新しいときでも再生成する。-iiop または -idl フラグ (あるいはその両方) が指定されている場合のみ有効
-factory -- ファクトリキーワードを使用する
-idlModule <fromJavaPackage<.class>> <toIDLModule> -- IDLEntity パッケージマッピングを指定する。例: -idlModule foo.bar my::real::idlmod
-idlFile <fromJavaPackage<.class>> <toIDLFile> -- IDLEntity ファイルマッピングを指定する。例: -idlFile test.pkg.X TEST16.idl

-iiop フラグ

スタブクラスは、abstract インタフェースにも生成されます。abstract インタフェースは、java.rmi.Remote は継承していませんが、そのメソッドから java.rmi.RemoteException または java.rmi.RemoteException のスーパークラスがスローされるインタフェースです。また、java.rmi.Remote を継承せず、メソッドが存在しないインタフェースも、abstract インタフェースです。

-idl フラグ

注: 生成された IDL は、IDL に対する CORBA 2.3 拡張機能がサポートされている IDL コンパイラを使用しないとコンパイルできません。

-noValueMethods フラグ

rmic についての詳細は、RMIC ツールのページ (Solaris 版/Windows 版) を参照してください。

新しい idlj コンパイラ

RMI プログラムから IIOP を使用する

1. ネームサービスに RMI レジストリを使用している場合は、CosNaming プラグインを使用して JNDI に切り替える必要があります。次の操作を行う必要があります。
1. クライアントおよびサーバのコードに、次のコードを使用して JNDI 用の InitialContext を作成する必要があります。

         import javax.naming.*;
         ...
         Context initialNamingContext = new InitialContext();

2. RMI レジストリで lookup() および bind() が使用されている部分を、すべて JNDI の lookup() および bind() に変更します。たとえば、RMI サーバで次のコードを使用するのではなく、

         import java.rmi.*;
         ...
         Naming.rebind("MyObject", myObj);

次のコードを使用します。

         import javax.naming.*;
         ...
         initialNamingContext.rebind("MyObject", myObj);

3. クライアントがアプレットの場合は、this を JNDI の CosNaming プラグインに渡す必要があります。上記のコードを次のコードに置き換えます。

        import java.util.*;
        import javax.naming.*;
        ...
        Hashtable env = new Hashtable();
        env.put("java.naming.applet", this);
        Context ic = new InitialContext(env);

2. ネームサービスに RMI レジストリを使用していない場合は、 初期リモートオブジェクト参照のブートストラップの方法を変更することができます。たとえば、サーバのコードでは、Java 直列化を使用して RMI オブジェクト参照を ObjectOutputStream に書き込みます。 そのオブジェクト参照をクライアントのコードに渡して、RMI スタブに直列化復元を行うことができます。

サーバ側では、PortableRemoteObject.toStub() 呼び出しを使用してスタブを取得し、writeObject() を使用してそのスタブを ObjectOutputStream に直列化します。次のコードによって、これらの処理が行われます。

org.omg.CORBA.ORB myORB = org.omg.CORBA.ORB.init(new String[0], null);
Wombat myWombat = new WombatImpl();
javax.rmi.CORBA.Stub myStub = (javax.rmi.CORBA.Stub)PortableRemoteObject.toStub(myWombat);
myStub.connect(myORB);
// myWombat is now connected to myORB.  To connect other objects to the
// same ORB, use PortableRemoteObject.connect(nextWombat, myWombat);
FileOutputStream myFile = new FileOutputStream("t.tmp");
ObjectOutputStream myStream = new ObjectOutputStream(myFile);
myStream.writeObject(myStub);

クライアント側では、readObject() を使用して ObjectInputStream から、リモート参照の直列化復元をオブジェクトに行います。 次のコードが使用されます。

FileInputStream myFile = new FileInputStream("t.tmp");
ObjectInputStream myStream = new ObjectInputStream(myFile);
Wombat myWombat = (Wombat)myStream.readObject();
org.omg.CORBA.ORB myORB = org.omg.CORBA.ORB.init(new String[0], null);
((javax.rmi.CORBA.Stub)myWombat).connect(myORB);
// myWombat is now connected to myORB.  To connect other objects to the
// same ORB, use PortableRemoteObject.connect(nextWombat, myWombat);

3. リモート実装クラスを javax.rmi.PortableRemoteObject から継承するように変更するか、PortableRemoteObject.exportObject() を呼び出して実装クラスを作成してから実装オブジェクトを明示的にエクスポートします。

 
4. コード内で、リモートインタフェースの Java キャストが使用されている個所を、すべて javax.rmi.PortableRemoteObject.narrow() を使用するように変更します。

 
5. 使用済みのオブジェクトをアンエクスポートするときは、分散ガベージコレクションに依存したり、RMI DGC 機能を使用したりせずに、PortableRemoteObject.unexportObject() を使用してください。このとき、1.1.6 で JRMP にエクスポートされたオブジェクトには影響しません。

 
6. -iiop オプションを指定して rmic コマンドを実行し、RMI スタブおよび Tie を再生成します。スタブおよび Tie ファイルが次の名前で作成されます。

     _<implementionName>_Tie.class
     _<interfaceName>_Stub.class

7. サーバを起動する前に、次のコマンドを使用して CosNaming サーバを自身のプロセス内で起動します。

     tnameserv

デフォルトのポート番号 900 が使用されます。別のポート番号 (ポート 1050 など) を使用する場合は、ORBInitialPort 修飾子を使用します。

     tnameserv -ORBInitialPort 1050

8. クライアントおよびサーバのアプリケーションを起動するときは、次のシステムプロパティを指定します。

     java -Djava.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory
          -Djava.naming.provider.url=iiop://<hostname>:900
           <appl_class>

この例では、デフォルトのネームサービスのポート番号 900 が使用されています。ステップ 7 で別のポート番号を指定した場合は、プロバイダの URL に、同じポート番号を使用する必要があります。プロバイダの URL の <hostname> は、ステップ 7 で CosNaming サーバを起動したときに使用したホスト名です。


9. クライアントがアプレットの場合は、アプレットタグに次のプロパティを指定します。

     java.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory
     java.naming.provider.url=iiop://<hostname>:900

この例では、デフォルトのネームサービスのポート番号 900 が使用されています。ステップ 7 で別のポート番号を指定した場合は、プロバイダの URL に、同じポート番号を使用する必要があります。プロバイダの URL の <hostname> は、ステップ 7 で CosNaming サーバを起動したときに使用したホスト名です。

IIOP を介して RMI プログラムを実行するときの制約

1. リモートインタフェース内のすべての定数の定義は、基本データ型または文字列でなければなりません。 また、コンパイル時に評価する必要があります。
2. Java-to-IDL マッピング規則によって生成された、IDL の復号化名と競合する Java の名前を使用しないでください。Java-to-IDL の名前のマッピング規則については、「Java Language to IDL Mapping」の 28.3.2 節を参照してください。
3. 複数の基底リモートインタフェースから、同じメソッド名をリモートインタフェースに 2 回以上継承しないでください。
4. 名前を使用するときは、大文字小文字の区別に注意してください。型の名前およびその型の変数を使用するときは、大文字小文字は区別されません。ただし、ほとんどの名前では、大文字小文字は区別されます。
5. IIOP を介してオブジェクト参照を転送するときに、オブジェクト参照の実行時共有に依存すると、正しく保持されないことがあります。ほかのオブジェクトの実行時共有は、正しく保持されます。
6. 次の RMI 機能は使用しないでください。
• RMISocketFactory
• UnicastRemoteObject
• Unreferenced
• DGC インタフェース

RMI Hello World プログラムを RMI-IIOP に変換する

RMI の Hello World は、次の要素で構成されています。

• HelloImpl.java - RMI サーバ
• Hello.java - HelloImpl によって実装されたリモートインタフェース
• HelloApplet.java - RMI クライアント
• Hello.html - HelloApplet をロードする

RMI の Hello World の例を使用したことがない場合は、使用してみることをお勧めします。例を使用したあとで、次のステップを実行します。

実装クラス (サーバ) を RMI-IIOP に適合させる:

1. javax.rmi.server.UnicastRemoteObject ではなく javax.rmi.server.PortableRemoteObject をインポートします。

     //Goodbye
     //import java.rmi.server.UnicastRemoteObject;

     //Hello
     import javax.rmi.PortableRemoteObject;

2. JNDI ネーミングパッケージをインポートします。

     import javax.naming.*;

3. HelloImpl の継承元を、UnicastRemoteObject から PortableRemoteObject に変更します。

     public class HelloImpl
                  extends PortableRemoteObject
                  ...

4. 次のコードを追加して、RMI レジストリから JNDI レジストリに変更します。

     Context initialNamingContext = new InitialContext();

初期 JNDI ネーミングコンテキストが提供されます。 このステップは、クライアント側でも実行する必要があります。
 
5. rebind() を RMI 版から JNDI 版に変更します。

変更前のコード:

     HelloImpl obj = new HelloImpl("HelloServer");
     Naming.rebind("HelloServer", obj);

変更後のコード:

     HelloImpl obj = new HelloImpl("HelloServer"); //unchanged
     initialNamingContext.rebind("HelloServer",obj);

1. PortableRemoteObject パッケージをインポートします。

     import javax.rmi.PortableRemoteObject;

2. JNDI 初期ネーミングコンテキストを作成し、CosNaming プラグインに渡します。

     import java.util.*;
     import javax.naming.*;
     ...
     Hashtable env = new Hashtable();
     env.put("java.naming.corba.applet", this);
     //The next two values will be specifiable
     //By applet tag params in future releases
     env.put("java.naming.factory.initial",
             "com.sun.jndi.cosnaming.CNCtxFactory");
     env.put("java.naming.provider.url", "iiop://<hostname>:900");
     Context ic = new InitialContext(env);

3. lookup() を RMI 版から JNDI 版に変更し、Java リモートインタフェースのキャストを javax.rmi.PortableRemoteObject.narrow() の呼び出しに置き換えます。

変更前のコード:

     import java.rmi.*;
     ...
     Hello obj = (Hello)Naming.lookup("//" +
                     getCodeBase().getHost() + "/HelloServer");

変更後のコード:

     import javax.naming.*;
     ...
     Hello obj =
      (Hello)PortableRemoteObject.narrow(
                         initialNamingContext.lookup("HelloServer"),
                         Hello.class);

次のプロパティを Hello.html アプレットタグに追加します。

<param name="java.naming.factory.initial" value="com.sun.jndi.cosnaming.CNCtxFactory">
<param name="java.naming.provider.url" value="iiop://<hostname>:900">

Java ソースファイルのコンパイル

javac -d $HOME/public_html/codebase Hello.java HelloImpl.java HelloApplet.java

検索パスの $RMI_IIOP_HOME/bin ディレクトリに rmic コマンドが指定されていることを確認します。

rmic -iiop -d $HOME/public_html/codebase examples.hello.HelloImpl

JNDI ネームサーバの起動

tnameserv

tnameserv -ORBInitialPort 1050

Hello サーバの起動

java -Djava.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory
     -Djava.naming.provider.url=iiop://<hostname>:900
     examples.hello.HelloImpl

Hello クライアントの起動

appletviewer を使用して Hello.html をロードします。

appletviewer Hello.html

<html>
<title>Hello World</title>
<center> <h1>Hello World</h1> </center>

HelloServer からのメッセージ:
<p>
<applet
        code="examples.hello.HelloApplet"
        width=500 height=120>

</applet>
</HTML>

クライアントアプレットをアプリケーションに変換する

クライアントアプリケーションを RMI-IIOP に適合させる:

1. HelloApplet をアプリケーションに変換します。
• HelloApplet.java (RMI の元のバージョン) を HelloApp.java にコピーする
• クラス名を HelloApp などに変更する
• extends Applet 句を削除する
• init() を main() に変更する
• String message =""; を移動する
• paint() メソッドを除去する
  
  
  
2. RMI レジストリを JNDI レジストリに変更します。

     import javax.naming.*;
     ...
     Context initialNamingContext = new InitialContext();

3. lookup() を RMI 版から JNDI 版に変更し、Java リモートインタフェースのキャストを javax.rmi.PortableRemoteObject.narrow() の呼び出しに置き換えます。

変更前のコード:

     import java.rmi.*;
     ...
     Hello obj = (Hello)Naming.lookup("//" +
                     getCodeBase().getHost() + "/HelloServer");

変更後のコード:

     import javax.naming.*;
     ...
     Hello obj = (Hello)PortableRemoteObject.narrow(
                         initialNamingContext.lookup("HelloServer"),
                         Hello.class);

サーバの起動時に、ホストおよびポートが指定されます。

javac -d $HOME/public_html/codebase HelloApp.java

ネームサーバおよび Hello サーバの起動

アプレットの例と同じ方法で起動します。

Hello アプリケーションのクライアントの起動

次のコードで起動します。

java -Djava.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory
     -Djava.naming.provider.url=iiop://<hostname>:900
      examples.hello.HelloApp

その他の注意事項

サーバはスレッドに対して安全でなければならない

同一のベクトルキーを持つハッシュテーブル

1. JDK 1.1 RMI アプリケーションによって、ハッシュテーブルが作成されます。
2. アプリケーションによって、ベクトルキー A を使用して値がハッシュテーブルに格納されます。
3. アプリケーションによって、ベクトルキー B を使用して別の値がハッシュテーブルに格納されます。ベクトル B とベクトル A の構造は同じですが、これらは異なるオブジェクトです。
4. ハッシュテーブルに対して、キー A およびキー B の 2 つのエントリが追加されました。
5. JDK 1.1 RMI アプリケーションによって、ハッシュテーブルの各値が 1.2 RMI アプリケーションに送信されます。
6. 1.2 の側のハッシュテーブルには、キー B のエントリが 1 つ作成されます。これは、ハッシュテーブルの直列化復元コードが 1.2 の規則を使用してハッシュテーブルを生成するときに、規則によってオブジェクト識別情報ではなく値とベクトルキーが比較されるためです。
7. RMI を使用してこのハッシュテーブルを 1.2 から 1.1 に戻した場合も、ハッシュテーブルにはキー B のエントリだけが格納されています。

ほかの ORB との相互運用

既知の問題点

• JNDI 1.1 では、java.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory がアプレットのパラメータとしてサポートされていません。このため、InitialContext コンストラクタにプロパティとして明示的に渡す必要があります。この機能は、JNDI 1.2 ではサポートされています。
• ポート 900 は、Solaris 上で予約されています。Solaris で実行する場合は、1024 より大きいポート番号を使用してください。
• Solaris の場合、RMI-IIOP アプリケーションの実行中に「ファイル記述子の不足」が発生することがあります。使用しているファイル記述子の数が多過ぎる場合に、この問題が発生する可能性があります。つまり、クラスパス内の各 JAR ファイルで 1 つのファイル記述子が消費されているため、JDK 1.1.6 のセットアップによって多数の JAR ファイルがクラスパスに追加されたときに、この現象が発生する可能性があります。アプリケーションを実行する前に、ファイル記述子の制限を、デフォルト値の 64 より大きい値に設定します。たとえば、ulimit を 90 以上に設定するには、次のコマンドを実行します。

ulimit -n 90