diff -r 8837e7172929 -r cabba0c0f3ee jdk/src/solaris/doc/sun/man/man1/ja/rmic.1 --- a/jdk/src/solaris/doc/sun/man/man1/ja/rmic.1 Mon Apr 18 23:00:53 2011 -0700 +++ b/jdk/src/solaris/doc/sun/man/man1/ja/rmic.1 Tue Apr 19 20:58:46 2011 -0700 @@ -19,22 +19,16 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH rmic 1 "02 Jun 2010" +.TH rmic 1 "14 Apr 2011" .LP -.SH "名前" -rmic \- Java RMI コンパイラ -.LP -.RS 3 - +.SH "̾" +rmic \- Java RMI ѥ .LP .LP -\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。 +\f3rmic\fP ˤäơJRMP ޤ IIOP ץȥѤ⡼ȥ֥ȤΥ֡ȥ󡢤 Tie 饹ޤޤOMG IDL ޤ .LP -.RE -.SH "形式" -.LP - +.SH "" .LP .nf \f3 @@ -45,12 +39,10 @@ .fi .LP -.SH "説明" -.LP - +.SH "" .LP .LP -\f3rmic\fP コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\f2java.rmi.Remote\fP インタフェースを実装するクラスです。\f3rmic\fP コマンドでのクラス名は、そのクラスが \f3javac\fP コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 \f2HelloImpl\fP で \f3rmic\fP を実行するには、次のようにします。 +\f3rmic\fP ѥˤäơ⡼ȥ֥ȤΡ֡ȥ󥯥饹ե (JRMP ץȥ)ӥ֤ Tie 饹եȤ߹碌 (IIOP ץȥ) ޤ⡼ȥ֥Ȥμ饹Ǥ뤳Υ饹եϡJava ץߥ󥰸Υ饹򥳥ѥ뤷Ȥޤ⡼ȼ饹ϡ\f2java.rmi.Remote\fP 󥿥ե륯饹Ǥ\f3rmic\fP ޥɤǤΥ饹̾ϡΥ饹 \f3javac\fP ޥɤǥѥ뤬ƤơĴʥѥå̾ꤵƤɬפޤȤС饹ե̾ \f2HelloImpl\fP \f3rmic\fP ¹ԤˤϡΤ褦ˤޤ .LP .nf \f3 @@ -62,37 +54,32 @@ .LP .LP -\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。 +\f2HelloImpl_Stub.class\fP ե뤬饹Υѥå̾դ \f2hello\fP ֥ǥ쥯ȥ˺ޤ .LP .LP -リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。 +⡼ȥ֥ȤΡ֥ȥפ JRMP ץȥ륵С¦ΥƥƥǡºݤΥ⡼ȥ֥ȼƤӽФ᥽åɤޤߤޤ .LP .LP -リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。 +⡼ȥ֥ȤΡTieפϡȥƱͤ˥С¦ΥƥƥǤIIOP ץȥȤäƥ饤Ȥ̿ޤ .LP .LP -「スタブ」とは、リモートオブジェクトのクライアント側での代理です。 スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。 -.LP -.LP -デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。 これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。) IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。 +֥֡פȤϡ⡼ȥ֥ȤΥ饤¦ǤǤ֤ϡ⡼ȥ֥ȤΥ᥽åɸƤӽФ򡢼ʪΥ⡼ȥ֥Ȥ󤹤륵С̿ޤäơ饤ȤΥ⡼ȥ֥ȤؤλȤϡºݤϥ륹֤ؤλȤȤʤޤ .LP .LP -スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、\f2PortableRemoteObject.narrow\fP メソッドを使わなければなりません。 +ǥեȤ \f3rmic\fP Ǥϡ1.2 JRMP ֥ץȥСѤ륹֥饹ޤϡ\f2\-v1.2\fP ץꤷƱưǤ(5.0 Ǥ \f2\-vcompat\fP ץ󤬥ǥեȤǤäȤաIIOP ץȥѤΥ֤ Tie 饹ˤ \f2\-iiop\fP ץѤޤ +.LP .LP -.SH "オプション" +֤ϥ⡼ȥ󥿥ե⡼ȥ֥Ȥɽꥤ󥿥եϼƤޤJRMP ֤ϥ⡼ȥ֥ȼΤ⡼ȥ󥿥եƱΤƤΤǡ饤Ȥϡ㥹Ȥ䷿å Java ץߥ󥰸Ȥ߹ޤ줿黻ҤѤ뤳ȤǤޤIIOP ξϡ\f2PortableRemoteObject.narrow\fP ᥽åɤȤʤФʤޤ .LP - +.SH "ץ" .LP .RS 3 .TP 3 \-bootclasspath path -ブートストラップクラスファイルの位置をオーバーライドします。 +֡ȥȥåץ饹եΰ֤򥪡С饤ɤޤ .TP 3 \-classpath path -\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。 -.RS 3 - -.LP +\f3rmic\fP 饹õΥѥꤷޤΥץϡǥեȤ CLASSPATH Ķѿ񤭤ޤǥ쥯ȥϥʬ䤷ޤäơ\f2path\fP ΰ̷ϼΤ褦ˤʤޤ .nf \f3 .fl @@ -100,11 +87,7 @@ .fl \fP .fi -.RE -例を示します。 -.RS 3 - -.LP +򼨤ޤ .nf \f3 .fl @@ -112,13 +95,9 @@ .fl \fP .fi -.RE .TP 3 \-d directory -生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。 -.RS 3 - -.LP +줿饹ؤνǥ쥯ȥΥ롼ȤꤷޤΥץȤС֡ȥ󡢤 Tie եǼǥ쥯ȥǤޤȤСΤ褦ˤƻȤޤ .nf \f3 .fl @@ -126,49 +105,43 @@ .fl \fP .fi -.RE -\f2MyClass\fP から取得したスタブとスケルトンクラスを \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた)。 +MyClass \f2֤ȥȥ󥯥饹\fP \f2/java/classes/foo\fP ǥ쥯ȥ֤ޤ\f2\-d\fP ץ󤬻ꤵƤʤϡ\f2\-d\ .\fPꤵƤȸʤޤåȥ饹ΥѥåؤߤΥǥ쥯ȥ˺졢֡Tieӥȥե뤬Υǥ쥯ȥ˳Ǽޤ(ΥС \f3rmic\fP Ǥϡ\f2\-d\fP ꤵƤʤϡѥåؤϺ줺ϥեϤ٤ƸߤΥǥ쥯ȥľܳǼƤ) .br \ .TP 3 \-extdirs path -インストール型拡張機能の位置をオーバーライドします。 +󥹥ȡ뷿ĥǽΰ֤򥪡С饤ɤޤ .TP 3 \-g -局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。 -.LP +ɽѿޤह٤ƤΥǥХåޤǥեȤǤϡֹޤ .TP 3 \-idl -\f2rmic\fP によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。 CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、 +\f2rmic\fP ˤäơꤷ饹ӻȤ줿饹 OMG IDL ޤIDL Ǥϡץߥ󥰸˰¸ˡǥ֥Ȥ API ꤹ뤳ȤǤޤIDL ϡ᥽åɤӥǡλͤȤƻѤޤCORBA Хǥ󥰤󶡤Ǥդθǡ᥽åɤӥǡκӸƤӽФԤȤǤޤθˤϡJava C++ ޤޤƤޤܺ٤ϡ .na \f2Java Language to IDL Mapping\fP @ .fi -http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。 +http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) 򻲾ȤƤ .LP -\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。 +\f2\-idl\fP ץȤȤϡۤΥץǤޤ .RS 3 .TP 3 -\-always または \-alwaysgenerate -既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。 +\-always ޤ \-alwaysgenerate +¸Υ֡Tie IDL ϥ饹꿷ȤǤ⡢Ūľޤ .TP 3 \-factory -生成された IDL で factory キーワードを使います。 +줿 IDL factory ɤȤޤ .TP 3 \-idlModule\ fromJavaPackage[.class]\ toIDLModule -IDLEntity パッケージのマップを指定します。例を示します。 \f2\-idlModule foo.bar my::real::idlmod\fP +IDLEntity ѥåΥޥåפꤷޤ򼨤ޤ \f2\-idlModule foo.bar my::real::idlmod\fP .TP 3 \-idlFile\ fromJavaPackage[.class]\ toIDLFile -IDLEntity ファイルのマップを指定します。例を示します。 \f2\-idlFile test.pkg.X TEST16.idl\fP\ +IDLEntity եΥޥåפꤷޤ򼨤ޤ \f2\-idlFile test.pkg.X TEST16.idl\fP\ .RE -.LP .TP 3 \-iiop -\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。 スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。 +\f2rmic\fP ˤäơJRMP Υ֤ȥȥ󥯥饹ˡIIOP Υ֤ Tie 饹ޤ֥饹ϡ⡼ȥ֥ȤΥץǡ饤Ȥ饵С˸ƤӽФȤ˻Ȥޤƥ⡼ȥ󥿥եˤϥ֥饹ɬפǤ֥饹ˤäƥ⡼ȥ󥿥եޤ饤Ȥǥ⡼ȥ֥Ȥ򻲾ȤȤϡºݤˤϥ֤򻲾Ȥ뤳Ȥˤʤޤ饹ϡС¦ƤθƤӽФŬڤʼ饹˥ǥѥåȤ˻ȤޤƼ饹ˤϡ饹ɬפǤ .LP -\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。 -.RS 3 - -.LP +\f2\-iiop\fP Ȥä \f2rmic\fP ƤӽФȡ̿̾˽򤷤֤ Tie ޤ .nf \f3 .fl @@ -182,66 +155,60 @@ .fl \fP .fi -.RE .LP -\f2\-iiop\fP オプションを使うときは、ほかのオプションも指定できます。 +\f2\-iiop\fP ץȤȤϡۤΥץǤޤ .RS 3 .TP 3 -\-always または \-alwaysgenerate -既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。 +\-always ޤ \-alwaysgenerate +¸Υ֡Tie IDL ϥ饹꿷ȤǤ⡢Ūľޤ .TP 3 \-nolocalstubs -同じプロセスのクライアントとサーバーに対して最適化されたスタブを作成しません。 +ƱץΥ饤ȤȥСФƺŬ줿֤ޤ .TP 3 \-noValueMethods -\f2\-idl\fP オプションとともに使われなければなりません。発行された IDL に、\f2valuetype\fP メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、\f2valuetype\fP の場合はオプションです。 \f2\-idl\fP オプションを使うときは、 \f2\-noValueMethods\fP オプションを指定しない限り生成されます。 + \f2\-idl\fP ץȤȤ˻ȤʤФʤޤȯԤ줿 IDL ˡ\f2valuetype\fP ᥽åɤӽҤɲäޤ󡣤Υ᥽åɤӽҤϡ\f2valuetype\fP ξϥץǤ \f2\-idl\fP ץȤȤϡ \f2\-noValueMethods\fP ץꤷʤ¤ޤ .TP 3 \-poa -継承が \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP から \f2org.omg.PortableServer.Servant\fP に変わります。 +Ѿ \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP \f2org.omg.PortableServer.Servant\fP Ѥޤ .LP .na \f2Portable Object Adapter\fP @ .fi -http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は、Java の \f2org.omg.PortableServer.Servant\fP クラスにマッピングされています。これはあらゆる POA サーバント実装の基底クラスとなり多数のメソッドを提供します。 これらのメソッドはアプリケーションプログラマが呼び出すだけではなく、POA 自身からも呼び出され、場合によってはサーバントの動作を制御するためにユーザーがオーバーライドすることもあります。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) \f2PortableServer\fP ⥸塼ϡͥƥ֤ \f2Servant\fP ޤJava ץߥ󥰸Ǥϡ\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 饹˥ޥåפޤΥ饹ϡ٤Ƥ POA Хȼδ쥯饹ȤƵǽץꥱץޤƤӽФȤΤǤ뤤ĤΥ᥽åɤΤۤˡPOA ΤΤˤäƸƤӽФ졢ХȤư椹뤿˥桼С饤ɤǤ᥽åɤ󶡤ޤOMG IDL to Java Language Mapping SpecificationCORBA V 2.3.1 ptc/00\-01\-08.pdf ˽򤷤Ƥޤ .RE .TP 3 \-J -\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\f2\-J\fP と \f2java\fP オプションの間にスペースは入れない)。 +\f2\-J\fP θ³ץ \f2java\fP 󥿥ץ꥿˰Ϥޤ \f2java\fP ץȤ߹碌ƻȤޤ (\-J java ץδ֤˥ڡʤ) .TP 3 -\-keep または \-keepgenerated -スタブ、スケルトン、または Tie クラスのための \f2.java\fP ソースファイルを \f2.class\fP ファイルと同じディレクトリに残します。 +\-keep ޤ \-keepgenerated +֡ȥ󡢤ޤ Tie 饹Τ \f2.java\fP ե \f2.class\fP եƱǥ쥯ȥ˻Ĥޤ .TP 3 \-nowarn -警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。 -.LP +ٹ򥪥դˤޤΥץꤹȡѥϷٹɽޤ +.TP 3 +\-nowrite +ѥ뤷饹ե륷ƥ˽񤭹ߤޤ .TP 3 \-vcompat -1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(5.0 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。 +1.1 1.2 ξ JRMP ֥ץȥСȸߴΤ륹֤ӥȥ󥯥饹ޤ(5.0 Υ꡼ǤϤΥץϥǥեȡ)줿֥饹ϡJDK 1.1 ۥޥ˥ɤ 1.1 ֥ץȥСѤJDK 1.2 ʹߤβۥޥ˥ɤ 1.2 ֥ץȥСѤޤ줿ȥ󥯥饹Ǥϡ1.1 1.2 ξΥ֥ץȥС򥵥ݡȤޤ줿饹ξ⡼ɤ򥵥ݡȤ뤿ˡ礭ʤޤ .TP 3 \-verbose -コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。 -.LP +ѥ󥫡ѥ뤵Ƥ륯饹ɤƤ륯饹եˤĤƤΥåɽ褦ˤޤ .TP 3 \-v1.1 -1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。 -.LP +1.1 JRMP ֥ץȥСΤߤΥ֤ӥȥ󥯥饹ޤΥץ󤬻ѤǤΤϡJDK 1.1 \f3rmic\fP ġ졢åץ졼ɤǤʤ (˥ʥߥå饹ǥ󥰤ѤƤʤ) ¸Ū줿֥饹Фľ󲽸ߴΤ륹֥饹Ǥ .TP 3 \-v1.2 -(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。 +(ǥե) 1.2 JRMP ֥ץȥСΤߤΥ֥饹ޤȥ󥯥饹 1.2 ֥ץȥСǻѤǤʤᡢΥץǤϥȥ󥯥饹ޤ줿֥饹ϡJDK 1.1 ۥޥ˥ɤƤưޤ .RE .LP -.SH "環境変数" -.LP - +.SH "Ķѿ" .LP .RS 3 .TP 3 CLASSPATH -ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。 -.RS 3 - -.LP +桼饹ؤΥѥ򥷥ƥ˻ꤷޤǥ쥯ȥϥʬ䤷ޤ򼨤ޤ .nf \f3 .fl @@ -250,15 +217,12 @@ \fP .fi .RE -.RE .LP -.SH "関連項目" -.LP - +.SH "Ϣ" .LP .LP -java(1)、javac(1)、 +java(1)javac(1) .na \f2CLASSPATH\fP @ .fi