rmic - Java RMI コンパイラ

rmic によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。

形式

rmic [ options ] package-qualified-class-name(s)

説明

rmic コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、java.rmi.Remote インタフェースを実装するクラスです。rmic コマンドでのクラス名は、そのクラスが javac コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 HelloImplrmic を実行するには、次のようにします。
rmic hello.HelloImpl
HelloImpl_Stub.class ファイルが、クラスのパッケージ名が付いた hello サブディレクトリに作成されます。

リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバ側のエンティティで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。

リモートオブジェクトの「Tie」は、スケルトンと同様にサーバ側のエンティティですが、IIOP プロトコルを使ってクライアントと通信します。

「スタブ」とは、リモートオブジェクトのクライアント側での代理です。 スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。

デフォルトで rmic では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。これは、-v1.2 オプションを指定した場合と同じ動作です。(1.5 以前では -vcompat オプションがデフォルトであったことに注意。) IIOP プロトコル用のスタブおよび Tie クラスを生成するには -iiop オプションを使用します。

スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、PortableRemoteObject.narrow メソッドを使わなければなりません。

オプション

-bootclasspath path
ブートストラップクラスファイルの位置をオーバーライドします。

-classpath path
rmic がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはセミコロンで分割します。したがって、path の一般形式は次のようになります。
.;<your_path>
次に例を示します。
.;C:\usr\local\java\classes
-d directory
生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。

% rmic -d C:\java\classes foo.MyClass
MyClass から取得したスタブとスケルトンクラスを C:\java\classes\foo ディレクトリに置きます。-d オプションが指定されていない場合は、「-d .」が指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの rmic では、-d が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた。)
-extdirs path
インストール型拡張機能の位置をオーバーライドします。

-g
局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。

-idl
rmic によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、『Java Language to IDL Mapping』 (OMG) を参照してください。

-idl オプションを使うときは、ほかのオプションも指定できます。

-always または -alwaysgenerate
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
-factory
生成された 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
rmic によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバ側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。

-iiop を使って rmic を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。

_<implementationName>_stub.class

_<interfaceName>_tie.class

-iiop オプションを使うときは、ほかのオプションも指定できます。

-always または -alwaysgenerate
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
-nolocalstubs
同じプロセスのクライアントとサーバに対して最適化されたスタブを作成しません。
-noValueMethods
-idl オプションとともに使われなければなりません。発行された IDL に、valuetype メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、valuetype の場合はオプションです。 -idl オプションを使うときは、 -noValueMethods オプションを指定しないかぎり生成されます。
-poa
継承が org.omg.CORBA_2_3.portable.ObjectImpl から org.omg.PortableServer.Servant に変わります。

Portable Object Adapter (POA) の PortableServer モジュールは、ネイティブの Servant 型を定義します。Java プログラミング言語では、Servant 型は、Java の org.omg.PortableServer.Servant クラスにマッピングされています。これはあらゆる POA サーバント実装の基底クラスとなり多数のメソッドを提供します。これらのメソッドはアプリケーションプログラマが呼び出すだけではなく、POA 自身からも呼び出され、場合によってはサーバントの動作を制御するためにユーザがオーバーライドすることもあります。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00-01-08.pdf に準拠しています。

-J
-J の後ろに続くオプションを java インタプリタに引き渡します。 java オプションと組み合わせて使います (-Jjava オプションの間にスペースは入れない)。

-keep または -keepgenerated
スタブ、スケルトン、または Tie クラスのための .java ソースファイルを .class ファイルと同じディレクトリに残します。

-nowarn
警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。

-vcompat
1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(1.5 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。

-verbose
コンパイラやリンカが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。

-v1.1
1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から rmic ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。

-v1.2
(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。

環境変数

CLASSPATH
ユーザ定義クラスへのパスをシステムに指定します。ディレクトリはセミコロンで分割します。次に例を示します。
.;C:\usr\local\java\classes

関連項目

javajavacCLASSPATH

Copyright © 2004 Sun Microsystems, Inc.All Rights Reserved. 
コメントの送付先: rmi-comments@java.sun.com 
Sun