2018-12-21 11:20:43 +01:00
|
|
|
<!DOCTYPE html>
|
2006-09-11 04:19:00 +00:00
|
|
|
<!--
|
|
|
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
|
|
|
this work for additional information regarding copyright ownership.
|
|
|
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
|
|
|
(the "License"); you may not use this file except in compliance with
|
|
|
|
|
the License. You may obtain a copy of the License at
|
|
|
|
|
|
2019-05-25 13:41:47 +02:00
|
|
|
https://www.apache.org/licenses/LICENSE-2.0
|
2006-09-11 04:19:00 +00:00
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
|
limitations under the License.
|
|
|
|
|
-->
|
2018-12-21 11:20:43 +01:00
|
|
|
<html lang="en">
|
2001-02-13 12:32:01 +00:00
|
|
|
|
|
|
|
|
<head>
|
2005-04-29 18:58:16 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
|
2002-02-03 22:00:42 +00:00
|
|
|
<title>Rmic Task</title>
|
2001-02-13 12:32:01 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
2018-01-22 23:52:21 +01:00
|
|
|
<h2 id="rmic">Rmic</h2>
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Description</h3>
|
2018-03-10 20:17:33 +01:00
|
|
|
<p>Runs the <kbd>rmic</kbd> compiler for a certain class.</p>
|
2020-05-05 11:53:39 +02:00
|
|
|
|
2020-05-05 12:11:07 +02:00
|
|
|
<p><b>Note</b> <kbd>rmic</kbd> has been deprecated as of Java 13 and
|
2020-05-05 11:53:39 +02:00
|
|
|
removed as of Java 15. Trying to use it with Java15 will fail unless
|
2020-05-22 22:26:12 -05:00
|
|
|
you specify the executable or rmic-adapter explicitly.</p>
|
2020-05-05 11:53:39 +02:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p><code>Rmic</code> can be run on a single class (as specified with the classname attribute) or a
|
|
|
|
|
number of classes at once (all classes below base that are neither <code>_Stub</code>
|
|
|
|
|
nor <code>_Skel</code> classes). If you want to <code>rmic</code> a single class and this class is
|
|
|
|
|
a class nested into another class, you have to specify the classname in the
|
|
|
|
|
form <code>Outer$$Inner</code> instead of <code>Outer.Inner</code>.</p>
|
|
|
|
|
<p>It is possible to refine the set of files that are being <code>rmic</code>ed. This can be done
|
|
|
|
|
with the <var>includes</var>, <var>includesfile</var>, <var>excludes</var>, <var>excludesfile</var>
|
|
|
|
|
and <var>defaultexcludes</var> attributes. With the <var>includes</var> or <var>includesfile</var>
|
|
|
|
|
attribute you specify the files you want to have included by using patterns. The <var>exclude</var>
|
|
|
|
|
or <var>excludesfile</var> attribute is used to specify the files you want to have excluded. This is
|
|
|
|
|
also done with patterns. And finally with the <var>defaultexcludes</var> attribute, you can specify
|
|
|
|
|
whether you want to use default exclusions or not. See the section
|
|
|
|
|
on <a href="../dirtasks.html#directorybasedtasks">directory based tasks</a>, on how the
|
2001-02-13 12:32:01 +00:00
|
|
|
inclusion/exclusion of files works, and how to write patterns.</p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>This task forms an implicit <a href="../Types/fileset.html">FileSet</a> and supports most
|
|
|
|
|
attributes of <code><fileset></code> (<var>dir</var> becomes <var>base</var>) as well as the
|
|
|
|
|
nested <code><include></code>, <code><exclude></code>
|
|
|
|
|
and <code><patternset></code> elements.</p>
|
|
|
|
|
<p id="compilervalues">It is possible to use different compilers. This can be selected with
|
|
|
|
|
the <code>build.rmic</code> property, the <var>compiler</var> attribute, or a nested element. Here
|
|
|
|
|
are the choices:</p>
|
2001-03-16 12:57:16 +00:00
|
|
|
<ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li><q>default</q>—the default compiler (<q>kaffe</q>, <q>sun</q> or <q>forking</q>) for the
|
|
|
|
|
platform.
|
2018-03-11 14:17:46 +01:00
|
|
|
<li><q>sun</q>—the standard compiler prior to JDK 9</li>
|
2019-05-25 15:38:31 +02:00
|
|
|
<li><q>kaffe</q>—the standard compiler of <a href="https://github.com/kaffe/kaffe"
|
2018-02-28 07:58:59 +01:00
|
|
|
target="_top">Kaffe</a></li>
|
|
|
|
|
<li><q>weblogic</q></li>
|
|
|
|
|
<li><q>forking</q>—(<em>since Apache Ant 1.7</em>) the <q>sun</q> compiler forked into a
|
|
|
|
|
separate process. <em>Since Ant 1.9.8</em>, this is the default when running on JDK 9+.</li>
|
|
|
|
|
<li><q>xnew</q>—(<em>since Ant 1.7</em>) the <q>sun</q> compiler forked into a separate
|
2018-03-10 20:17:33 +01:00
|
|
|
process, with the <kbd>-Xnew</kbd> option. This is the most reliable way to
|
|
|
|
|
use <kbd>-Xnew</kbd>.<br/>JDK 9 has removed support for <kbd>-Xnew</kbd> and <em>since Ant
|
|
|
|
|
1.9.8</em> this option will be rejected when running on JDK 9+.</li>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li><q></q> (empty string). This has the same behaviour as not setting the compiler attribute.
|
|
|
|
|
First the value of <code>build.rmic</code> is used if defined, and if not, the default for the
|
|
|
|
|
platform is chosen. If <code>build.rmic</code> is set to this, you get the default.</li>
|
2001-03-16 12:57:16 +00:00
|
|
|
</ul>
|
2002-02-21 12:41:34 +00:00
|
|
|
|
2018-03-08 07:43:53 +01:00
|
|
|
<p>The <a href="https://web.archive.org/web/20131225023602/http://dione.zcu.cz/~toman40/miniRMI/"
|
|
|
|
|
target="_top">miniRMI</a> project contains a compiler implementation for this task as well, please
|
|
|
|
|
consult miniRMI's documentation to learn how to use it.</p>
|
2002-02-21 12:41:34 +00:00
|
|
|
|
2018-03-05 12:45:56 +01:00
|
|
|
<h4>CORBA support</h4>
|
|
|
|
|
|
2019-05-25 15:38:31 +02:00
|
|
|
<p>Java 11 <a href="https://openjdk.java.net/jeps/320" target="_top">removes</a> the Java EE and
|
2018-03-10 20:17:33 +01:00
|
|
|
CORBA packages and <kbd>rmic</kbd> no longer supports either <kbd>-iiop</kbd>
|
|
|
|
|
or <kbd>-idl</kbd> options. Starting with Ant 1.10.3, the <kbd>rmic</kbd> task will fail when using
|
2018-03-08 07:43:53 +01:00
|
|
|
either while running Java 11+ unless you fork the task and explicitly specify an executable.</p>
|
2018-03-05 12:45:56 +01:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Parameters</h3>
|
2018-02-28 07:58:59 +01:00
|
|
|
<table class="attr">
|
2001-02-13 12:32:01 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
2018-03-03 21:26:50 +01:00
|
|
|
<tr id="footnote-1-back">
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>base</td>
|
|
|
|
|
<td>the location to store the compiled files. Also serves as the parent directory for any
|
|
|
|
|
non-Fileset includes, etc. (This functionality has remained unchanged.)</td>
|
|
|
|
|
<td rowspan="2">See <a href="#footnote-1">note</a></td>
|
2009-08-18 08:29:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>destdir</td>
|
|
|
|
|
<td class="left">the location to store the compiled files.</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>classname</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>the class for which to run <kbd>rmic</kbd>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>filtering</td>
|
|
|
|
|
<td>indicates whether token filtering should take place</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>sourcebase</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Pass the <kbd>-keepgenerated</kbd> flag to <kbd>rmic</kbd> and move the generated source
|
2018-02-28 07:58:59 +01:00
|
|
|
file to the given <var>sourcebase</var> directory.</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>stubversion</td>
|
|
|
|
|
<td>Specify the JDK version for the generated stub code. Specify <q>1.1</q> to pass
|
2018-03-10 20:17:33 +01:00
|
|
|
the <kbd>-v1.1</kbd> option to <kbd>rmic</kbd>, <q>1.2</q>
|
|
|
|
|
for <kbd>-v1.2</kbd>, <q>compat</q> for <kbd>-vcompat</kbd>.<br/><em>Since Ant 1.7</em>, if
|
2018-02-28 07:58:59 +01:00
|
|
|
you do not specify a version, and do not ask for <samp>.iiop</samp> or <samp>.idl</samp>
|
|
|
|
|
files, <q>compat</q> is selected.</td>
|
|
|
|
|
<td>No; default is <q>compat</q></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>classpath</td>
|
|
|
|
|
<td>The classpath to use during compilation</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>classpathref</td>
|
|
|
|
|
<td>The classpath to use during compilation, given
|
|
|
|
|
as <a href="../using.html#references">reference</a> to a path defined elsewhere</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>includes</td>
|
|
|
|
|
<td>comma- or space-separated list of patterns of files that must be included.</td>
|
|
|
|
|
<td>No; defaults to all (<q>**</q>)</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>includesfile</td>
|
|
|
|
|
<td>name of a file. Each line of this file is taken to be an include pattern</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>excludes</td>
|
|
|
|
|
<td>comma- or space-separated list of patterns of files that must be excluded.</td>
|
|
|
|
|
<td>No; defaults to default excludes or none if <var>defaultexcludes</var> is <q>no</q></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>excludesfile</td>
|
|
|
|
|
<td>name of a file. Each line of this file is taken to be an exclude pattern</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>defaultexcludes</td>
|
|
|
|
|
<td>indicates whether default excludes should be used or not (<q>yes|no</q>).</td>
|
|
|
|
|
<td>No; defaults to <q>yes</q></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>verify</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>check that classes implement <code>Remote</code> before handing them to <kbd>rmic</kbd></td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; default is <q>false</q></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>iiop</td>
|
2018-03-05 21:01:42 +01:00
|
|
|
<td>indicates that portable (RMI/IIOP) stubs should be generated.<br/> See the note on CORBA
|
|
|
|
|
support above.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>iiopopts</td>
|
|
|
|
|
<td>additional arguments for IIOP class generation</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>idl</td>
|
2018-03-05 21:01:42 +01:00
|
|
|
<td>indicates that IDL output files should be generated.<br/> See the note on CORBA support
|
|
|
|
|
above.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>idlopts</td>
|
|
|
|
|
<td>additional arguments for IDL file generation</td>
|
|
|
|
|
<td>No</td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>debug</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>generate debug info (passes <kbd>-g</kbd> to <kbd>rmic</kbd>)</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No; defaults to <q>false</q></td>
|
2001-02-13 12:32:01 +00:00
|
|
|
</tr>
|
2001-03-16 12:57:16 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>includeAntRuntime</td>
|
|
|
|
|
<td>whether to include the Ant run-time libraries</td>
|
|
|
|
|
<td>No; defaults to <q>yes</q></td>
|
2001-03-16 12:57:16 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>includeJavaRuntime</td>
|
|
|
|
|
<td>whether to include the default run-time libraries from the executing JVM</td>
|
|
|
|
|
<td>No; defaults to <q>no</q></td>
|
2001-03-16 12:57:16 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>extdirs</td>
|
|
|
|
|
<td>location of installed extensions</td>
|
|
|
|
|
<td>No</td>
|
2001-03-16 12:57:16 +00:00
|
|
|
</tr>
|
2002-04-15 13:20:26 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>compiler</td>
|
|
|
|
|
<td>The compiler implementation to use. (See the above <a href="#compilervalues">list</a> of
|
|
|
|
|
valid compilers.)</td>
|
|
|
|
|
<td>No; defaults to the value of the <code>build.rmic</code> property, if set, and the default
|
|
|
|
|
compiler for the current JDK otherwise</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
2009-07-13 15:04:35 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>executable</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>Complete path to the <kbd>rmic</kbd> executable to use in case of the <q>forking</q>
|
2018-02-28 07:58:59 +01:00
|
|
|
or <q>xnew</q> compiler. <em>Since Ant 1.8.0</em>.</td>
|
2018-03-10 20:17:33 +01:00
|
|
|
<td>No; defaults to the <kbd>rmic</kbd> compiler of JDK that is currently running Ant</td>
|
2009-07-13 15:04:35 +00:00
|
|
|
</tr>
|
2009-08-18 10:51:51 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>listfiles</td>
|
|
|
|
|
<td>Indicates whether the source files to be compiled will be listed. <em>Since Ant
|
|
|
|
|
1.8.0</em>.</td>
|
|
|
|
|
<td>No; defaults to <q>no</q></td>
|
2009-08-18 10:51:51 +00:00
|
|
|
</tr>
|
2001-02-13 12:32:01 +00:00
|
|
|
</table>
|
2009-08-18 08:29:01 +00:00
|
|
|
|
2018-03-03 21:26:50 +01:00
|
|
|
<p id="footnote-1"><a href="#footnote-1-back">Note</a>:</p>
|
2009-08-18 08:29:01 +00:00
|
|
|
<ul>
|
2018-02-28 07:58:59 +01:00
|
|
|
<li>Maintaining compatibility, <var>base</var>, when specified by itself, serves as both the
|
|
|
|
|
parent directory for any source files AND the output directory.</li>
|
|
|
|
|
<li><var>destdir</var> can be used to specify the output directory, allowing for <var>base</var>
|
|
|
|
|
to be used as the parent directory for any source files.</li>
|
2018-03-18 07:55:29 +01:00
|
|
|
<li>At least one of either <var>base</var> or <var>destdir</var> must be specified and exist, or
|
|
|
|
|
an error will occur at run time.</li>
|
2009-08-18 08:29:01 +00:00
|
|
|
</ul>
|
|
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Parameters specified as nested elements</h3>
|
2001-03-16 12:57:16 +00:00
|
|
|
<h4>classpath and extdirs</h4>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p><code>Rmic</code>'s <var>classpath</var> and <var>extdirs</var> attributes
|
|
|
|
|
are <a href="../using.html#path">path-like structure</a> and can also be set via a nested
|
|
|
|
|
<code>classpath</code> and <code>extdirs</code> elements.</p>
|
2002-04-15 13:20:26 +00:00
|
|
|
|
|
|
|
|
<h4>compilerarg</h4>
|
|
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>You can specify additional command line arguments for the compiler with
|
|
|
|
|
nested <code><compilerarg></code> elements. These elements are specified
|
|
|
|
|
like <a href="../using.html#arg">Command-line Arguments</a> but have an additional attribute that
|
|
|
|
|
can be used to enable arguments only if a given compiler implementation will be used.</p>
|
|
|
|
|
<table class="attr">
|
2002-04-15 13:20:26 +00:00
|
|
|
<tr>
|
2018-05-15 10:29:27 +02:00
|
|
|
<th scope="col">Attribute</th>
|
|
|
|
|
<th scope="col">Description</th>
|
|
|
|
|
<th scope="col">Required</th>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>value</td>
|
|
|
|
|
<td rowspan="4">See <a href="../using.html#arg">Command-line Arguments</a>.</td>
|
|
|
|
|
<td rowspan="4">Exactly one of these</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td class="var">line</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td class="var">file</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td class="var">path</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
2009-06-26 12:41:50 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>prefix</td>
|
|
|
|
|
<td rowspan="2">See
|
2009-06-26 12:41:50 +00:00
|
|
|
<a href="../using.html#arg">Command-line Arguments</a>.
|
2018-01-24 21:40:28 +01:00
|
|
|
<em>Since Ant 1.8</em>.</td>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>No</td>
|
2009-06-26 12:41:50 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>suffix</td>
|
|
|
|
|
<td>No</td>
|
2009-06-26 12:41:50 +00:00
|
|
|
</tr>
|
2002-04-15 13:20:26 +00:00
|
|
|
<tr>
|
2018-02-28 07:58:59 +01:00
|
|
|
<td>compiler</td>
|
|
|
|
|
<td>Only pass the specified argument if the chosen compiler implementation matches the value of
|
|
|
|
|
this attribute. Legal values are the same as those in the
|
|
|
|
|
above <a href="#compilervalues">list</a> of valid compilers.)</td>
|
|
|
|
|
<td>No</td>
|
2002-04-15 13:20:26 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2018-03-04 15:17:41 +01:00
|
|
|
<h4>compilerclasspath</h4>
|
|
|
|
|
<p><em>Since Ant 1.8.0</em></p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>A <a href="../using.html#path">path-like structure</a> holding the classpath to use when loading
|
|
|
|
|
the compiler implementation if a custom class has been specified. Doesn't have any effect when
|
|
|
|
|
using one of the built-in compilers.</p>
|
2009-07-21 08:52:12 +00:00
|
|
|
|
2018-03-04 15:17:41 +01:00
|
|
|
<h4>Any nested element of a type that implements RmicAdapter</h4>
|
|
|
|
|
<p><em>Since Ant 1.8.0</em></p>
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>If a defined type implements the <code>RmicAdapter</code> interface a nested element of that type
|
|
|
|
|
can be used as an alternative to the <var>compiler</var> attribute.</p>
|
2009-09-04 13:02:02 +00:00
|
|
|
|
2001-02-13 12:32:01 +00:00
|
|
|
<h3>Examples</h3>
|
2018-05-15 09:51:58 +02:00
|
|
|
|
|
|
|
|
<p>Run the <kbd>rmic</kbd> compiler for the class <code>com.xyz.FooBar</code>. The compiled files
|
2018-02-28 07:58:59 +01:00
|
|
|
will be stored in the directory <samp>${build}/classes</samp>.</p>
|
2018-05-15 09:51:58 +02:00
|
|
|
<pre><rmic classname="com.xyz.FooBar" base="${build}/classes"/></pre>
|
|
|
|
|
|
|
|
|
|
<p>Run the <kbd>rmic</kbd> compiler for all classes with <samp>.class</samp> files
|
2018-02-28 07:58:59 +01:00
|
|
|
below <samp>${build}/classes</samp> whose classname starts with <code>Remote</code>. The compiled
|
|
|
|
|
files will be stored in the directory <samp>${build}/classes</samp>.</p>
|
2018-05-15 09:51:58 +02:00
|
|
|
<pre><rmic base="${build}/classes" includes="**/Remote*.class"/></pre>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
2018-02-28 07:58:59 +01:00
|
|
|
<p>If you want to use a custom RmicAdapter <code>org.example.MyAdapter</code> you can either use
|
|
|
|
|
the <var>compiler</var> attribute:</p>
|
2009-09-04 13:02:02 +00:00
|
|
|
<pre>
|
|
|
|
|
<rmic classname="com.xyz.FooBar"
|
|
|
|
|
base="${build}/classes"
|
2018-02-28 07:58:59 +01:00
|
|
|
compiler="org.example.MyAdapter"/></pre>
|
2009-09-04 13:02:02 +00:00
|
|
|
<p>or a define a type and nest this into the task like in:</p>
|
|
|
|
|
<pre>
|
|
|
|
|
<componentdef classname="org.example.MyAdapter"
|
|
|
|
|
name="myadapter"/>
|
|
|
|
|
<rmic classname="com.xyz.FooBar"
|
|
|
|
|
base="${build}/classes">
|
|
|
|
|
<myadapter/>
|
2018-02-28 07:58:59 +01:00
|
|
|
</rmic></pre>
|
|
|
|
|
<p>in which case your compiler adapter can support attributes and nested elements of its own.</p>
|
2001-02-13 12:32:01 +00:00
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
