|
|
|
@@ -26,18 +26,29 @@ |
|
|
|
|
|
|
|
<h2><a name="script">Script</a></h2> |
|
|
|
<h3>Description</h3> |
|
|
|
<p>Execute a script in a |
|
|
|
<a href="http://jakarta.apache.org/bsf" target="_top">Apache BSF</a> supported language.</p> |
|
|
|
<p><b>Note:</b> This task depends on external libraries not included in the Ant distribution. |
|
|
|
See <a href="../install.html#librarydependencies">Library Dependencies</a> for more information.</p> |
|
|
|
<p>All items (tasks, targets, etc) of the running project are |
|
|
|
accessible from the script, using either their <code>name</code> or |
|
|
|
<code>id</code> attributes (as long as their names are considered |
|
|
|
valid Java identifiers, that is). |
|
|
|
This is controlled by the "setbeans" attribute of the task. |
|
|
|
The name "project" is a pre-defined reference to the Project, which can be |
|
|
|
used instead of the project name. The name "self" is a pre-defined reference to the actual |
|
|
|
<code><script></code>-Task instance.<br>From these objects you have access to the Ant Java API, see the |
|
|
|
<p>Execute a script in a |
|
|
|
<a href="http://jakarta.apache.org/bsf" target="_top">Apache BSF</a> |
|
|
|
or |
|
|
|
<a href="https//scripting.dev.java.net">JSR 233</a> supported language. |
|
|
|
</p> |
|
|
|
<p><b>Note:</b> |
|
|
|
This task depends on external libraries not included in the Ant distribution. |
|
|
|
See <a href="../install.html#librarydependencies">Library Dependencies</a> |
|
|
|
for more information. |
|
|
|
</p> |
|
|
|
<p> |
|
|
|
The task may use the BSF scripting manager or the JSR 233 manager that |
|
|
|
is included in JDK6 and higher. This is controlled by the <code>manager</code> |
|
|
|
attribute. The JSR 233 scripting manager is indicated by "javax". |
|
|
|
</p> |
|
|
|
<p>All items (tasks, targets, etc) of the running project are |
|
|
|
accessible from the script, using either their <code>name</code> or |
|
|
|
<code>id</code> attributes (as long as their names are considered |
|
|
|
valid Java identifiers, that is). |
|
|
|
This is controlled by the "setbeans" attribute of the task. |
|
|
|
The name "project" is a pre-defined reference to the Project, which can be |
|
|
|
used instead of the project name. The name "self" is a pre-defined reference to the actual |
|
|
|
<code><script></code>-Task instance.<br>From these objects you have access to the Ant Java API, see the |
|
|
|
<a href="../api/index.html">JavaDoc</a> (especially for |
|
|
|
<a href="../api/org/apache/tools/ant/Project.html">Project</a> and |
|
|
|
<a href="../api/org/apache/tools/ant/taskdefs/optional/Script.html">Script</a>) for more information.</p> |
|
|
|
@@ -63,9 +74,27 @@ Groups@Google: "Rhino, enum.js, JavaAdapter?"</a> by Norris Boyd in the newsgrou |
|
|
|
<tr> |
|
|
|
<td valign="top">language</td> |
|
|
|
<td valign="top">The programming language the script is written in. |
|
|
|
Must be a supported Apache BSF language</td> |
|
|
|
Must be a supported Apache BSF or JSR 223 language</td> |
|
|
|
<td valign="top" align="center">Yes</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">manager</td> |
|
|
|
<td valign="top"> |
|
|
|
<em>Since: Ant 1.7. </em> |
|
|
|
The script engine manager to use. This can have |
|
|
|
one of three values ("auto", "bsf" or "javax"). |
|
|
|
The default value is "auto". |
|
|
|
<dl> |
|
|
|
<li>"bsf" use the BSF scripting manager to run |
|
|
|
the language.</li> |
|
|
|
<li>"javax" use the <em>javax.scripting</em> manager |
|
|
|
to run the language. (This will only work for JDK6 and higher).</li> |
|
|
|
<li>"auto" use the BSF engine if it exists, |
|
|
|
otherwise use the <em>javax.scripting</em> manager.</li> |
|
|
|
</dl> |
|
|
|
</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">src</td> |
|
|
|
<td valign="top">The location of the script as a file, if not inline</td> |
|
|
|
|
Peter Reilly
18 years ago