Rmic

説明

特定のクラスに対して rmic コンパイラを実行します。

注意 rmic は Java 13 で非推奨となり、Java 15 で削除されました。Java 15 で使用するには、実行可能ファイルまたは rmic-adapter を明示的に指定する必要があります。

Rmic は、単一のクラス (classname 属性で指定) または複数のクラス (base 以下のすべてのクラスで、_Stub クラスでも _Skel クラスでもないもの) に対して実行できます。単一のクラスを rmic し、そのクラスが別のクラスにネストされている場合は、classname を Outer.Inner ではなく Outer$$Inner の形式で指定する必要があります。

rmic されるファイルのセットを絞り込むことができます。これは、includes、includesfile、excludes、excludesfile、および defaultexcludes 属性を使用して行います。includes または includesfile 属性を使用して、パターンを使用して含めるファイルを指定します。exclude または excludesfile 属性は、除外するファイルを指定するために使用されます。これもパターンを使用して行います。最後に、defaultexcludes 属性を使用して、デフォルトの除外を使用するかどうかを指定できます。ファイルの包含/除外の仕組み、およびパターンの記述方法については、ディレクトリベースのタスクのセクションを参照してください。

このタスクは暗黙的な FileSet を形成し、<fileset> のほとんどの属性 (dir は base になる) と、ネストされた <include>、<exclude>、および <patternset> 要素をサポートします。

異なるコンパイラを使用することができます。これは、build.rmic プロパティ、compiler 属性、またはネストされた要素で選択できます。選択肢は次のとおりです。

• default—プラットフォームのデフォルトコンパイラ (kaffe、sun、または forking)。
• sun—JDK 9 より前の標準コンパイラ
• kaffe—Kaffe の標準コンパイラ
• weblogic
• forking—(Apache Ant 1.7 以降) sun コンパイラを別のプロセスにフォークします。Ant 1.9.8 以降、JDK 9 以降で実行する場合のデフォルトです。
• xnew—(Ant 1.7 以降) sun コンパイラを別のプロセスにフォークし、-Xnew オプションを指定します。これは、-Xnew を使用する最も信頼性の高い方法です。
  JDK 9 では -Xnew のサポートが削除されており、Ant 1.9.8 以降、JDK 9 以降で実行するとこのオプションは拒否されます。
• (空文字列)。これは、compiler 属性を設定しない場合と同じ動作になります。最初に、build.rmic の値が定義されている場合は使用され、定義されていない場合はプラットフォームのデフォルトが選択されます。build.rmic がこれに設定されている場合、デフォルトが取得されます。

miniRMI プロジェクトには、このタスクのコンパイラ実装も含まれています。使用方法については、miniRMI のドキュメントを参照してください。

CORBA サポート

Java 11 は Java EE および CORBA パッケージを削除 し、rmic は -iiop オプションも -idl オプションもサポートしなくなりました。Ant 1.10.3 以降、タスクをフォークして実行可能ファイルを明示的に指定しない限り、Java 11 以降で実行しているときに rmic タスクはいずれかを使用すると失敗します。

パラメータ

注記:

• 互換性を維持するために、base は、単独で指定された場合、ソースファイルと出力ディレクトリの両方の親ディレクトリとして機能します。
• destdir を使用して出力ディレクトリを指定することで、base をソースファイルの親ディレクトリとして使用できます。
• base または destdir の少なくともいずれかを指定し、存在する必要があります。そうでない場合、実行時にエラーが発生します。

ネストされた要素として指定されたパラメータ

classpath と extdirs

Rmic の classpath 属性と extdirs 属性は、パスのような構造 であり、ネストされた classpath 要素と extdirs 要素を使用して設定することもできます。

compilerarg

ネストされた <compilerarg> 要素を使用して、コンパイラの追加のコマンドライン引数を指定できます。これらの要素は コマンドライン引数 のように指定されますが、指定されたコンパイラ実装が使用される場合にのみ引数を有効にするために使用できる追加の属性があります。

compilerclasspath

Ant 1.8.0 以降

カスタムクラスが指定されている場合にコンパイラ実装のロード時に使用するクラスパスを保持する パスのような構造。組み込みコンパイラのいずれかを使用している場合は効果がありません。

RmicAdapter を実装するタイプのネストされた要素

Ant 1.8.0 以降

定義されたタイプが RmicAdapter インターフェースを実装している場合、そのタイプのネストされた要素を compiler 属性の代わりに使用できます。

例

クラス com.xyz.FooBar に対して rmic コンパイラを実行します。コンパイルされたファイルは ${build}/classes ディレクトリに格納されます。

<rmic classname="com.xyz.FooBar" base="${build}/classes"/>

${build}/classes 以下の .class ファイルを持つすべてのクラスで、クラス名が Remote で始まるものに対して rmic コンパイラを実行します。コンパイルされたファイルは ${build}/classes ディレクトリに格納されます。

<rmic base="${build}/classes" includes="**/Remote*.class"/>

カスタム RmicAdapter org.example.MyAdapter を使用する場合、compiler 属性を使用できます。

<rmic classname="com.xyz.FooBar"
      base="${build}/classes"
      compiler="org.example.MyAdapter"/>

または、タイプを定義し、これをタスクにネストすることもできます。

<componentdef classname="org.example.MyAdapter"
              name="myadapter"/>
<rmic classname="com.xyz.FooBar"
      base="${build}/classes">
  <myadapter/>
</rmic>

この場合、コンパイラアダプタは独自の属性とネストされた要素をサポートできます。