2001-11-30 12:05:27 +00:00
|
|
|
<html>
|
|
|
|
|
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Language" content="en-us">
|
2005-03-07 18:09:10 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css"/>
|
2002-02-03 22:00:42 +00:00
|
|
|
<title>Conditions Task</title>
|
2001-11-30 12:05:27 +00:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<h2><a name="Conditions">Conditions</a></h2>
|
2003-08-14 14:06:54 +00:00
|
|
|
<p>Conditions are nested elements of the
|
|
|
|
|
<a href="condition.html"><code><condition></code></a> and
|
|
|
|
|
<a href="waitfor.html"><code><waitfor></code></a> tasks.
|
|
|
|
|
There are core conditions and custom conditions. Custom
|
|
|
|
|
conditions are described in
|
|
|
|
|
<a href="../CoreTypes/custom-programming.html#customconditions">
|
|
|
|
|
Custom Conditions</a>.
|
|
|
|
|
Core Conditions are described below.
|
|
|
|
|
</p>
|
|
|
|
|
<h3><a name="coreconditions">Core Conditions</a></h3>
|
2001-11-30 12:05:27 +00:00
|
|
|
|
|
|
|
|
<p>These are the nested elements that can be used as conditions in the
|
2002-02-01 07:24:49 +00:00
|
|
|
<a href="condition.html"><code><condition></code></a> and
|
2001-11-30 12:05:27 +00:00
|
|
|
<a href="waitfor.html"><code><waitfor></code></a> tasks.</p>
|
|
|
|
|
|
|
|
|
|
<h4>not</h4>
|
|
|
|
|
<p>The <code><not></code> element expects exactly one other
|
|
|
|
|
condition to be nested into this element, negating the result of the
|
|
|
|
|
condition. It doesn't have any attributes and accepts all nested
|
|
|
|
|
elements of the condition task as nested elements as well.</p>
|
|
|
|
|
|
|
|
|
|
<h4>and</h4> <p>
|
|
|
|
|
The <code><and></code> element doesn't have any attributes and
|
|
|
|
|
accepts an arbitrary number of conditions as nested elements - all
|
|
|
|
|
nested elements of the condition task are supported. This condition
|
|
|
|
|
is true if all of its contained conditions are, conditions will be
|
|
|
|
|
evaluated in the order they have been specified in the build file.</p>
|
|
|
|
|
<p>The <code><and></code> condition has the same shortcut
|
|
|
|
|
semantics as the Java && operator, as soon as one of the
|
|
|
|
|
nested conditions is false, no other condition will be evaluated.</p>
|
|
|
|
|
|
|
|
|
|
<h4>or</h4> <p>
|
|
|
|
|
The <code><or></code> element doesn't have any attributes and
|
|
|
|
|
accepts an arbitrary number of conditions as nested elements - all
|
|
|
|
|
nested elements of the condition task are supported. This condition
|
|
|
|
|
is true if at least one of its contained conditions is, conditions
|
|
|
|
|
will be evaluated in the order they have been specified in the build
|
|
|
|
|
file.</p> <p>The <code><or></code> condition has the same
|
|
|
|
|
shortcut semantics as the Java || operator, as soon as one of the
|
|
|
|
|
nested conditions is true, no other condition will be evaluated.</p>
|
|
|
|
|
|
2005-01-22 22:01:15 +00:00
|
|
|
<h4>xor</h4>
|
|
|
|
|
<p>The <code><xor></code> element performs an exclusive
|
|
|
|
|
or on all nested elements, similar to the <code>^</code> operator
|
|
|
|
|
in Java. It only evaluates to true if an odd number of nested conditions
|
|
|
|
|
are true. There is no shortcutting of evaluation, unlike the <code><and></code>
|
|
|
|
|
and <code><or></code> tests.
|
|
|
|
|
It doesn't have any attributes and accepts all nested
|
|
|
|
|
elements of the condition task as nested elements as well.</p>
|
|
|
|
|
|
2001-11-30 12:05:27 +00:00
|
|
|
<h4>available</h4>
|
|
|
|
|
<p>This condition is identical to the <a
|
|
|
|
|
href="available.html">Available</a> task, all attributes and nested
|
|
|
|
|
elements of that task are supported, the property and value attributes
|
|
|
|
|
are redundant and will be ignored.</p>
|
|
|
|
|
|
|
|
|
|
<h4>uptodate</h4>
|
|
|
|
|
<p>This condition is identical to the <a
|
|
|
|
|
href="uptodate.html">Uptodate</a> task, all attributes and nested
|
|
|
|
|
elements of that task are supported, the property and value attributes
|
|
|
|
|
are redundant and will be ignored.</p>
|
|
|
|
|
|
|
|
|
|
<h4>os</h4>
|
|
|
|
|
<p>Test whether the current operating system is of a given type. Each
|
|
|
|
|
defined attribute is tested and the result is true only if <i>all</i>
|
|
|
|
|
the tests succeed.
|
|
|
|
|
</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">family</td>
|
|
|
|
|
<td valign="top">The name of the operating system family to expect.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">name</td>
|
|
|
|
|
<td valign="top">The name of the operating system to expect.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">arch</td>
|
|
|
|
|
<td valign="top">The architecture of the operating system to expect.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">version</td>
|
|
|
|
|
<td valign="top">The version of the operating system to expect.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<p>Supported values for the family attribute are:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>windows (for all versions of Microsoft Windows)</li>
|
|
|
|
|
<li>dos (for all Microsoft DOS based operating systems including
|
|
|
|
|
Microsoft Windows and OS/2)</li>
|
|
|
|
|
<li>mac (for all Apple Macintosh systems)</li>
|
|
|
|
|
<li>unix (for all Unix and Unix-like operating systems)</li>
|
|
|
|
|
<li>netware (for Novell NetWare)</li>
|
|
|
|
|
<li>os/2 (for OS/2)</li>
|
2003-05-23 13:40:37 +00:00
|
|
|
<li>tandem (for HP's NonStop Kernel - formerly Tandem)</li>
|
2002-01-29 17:22:56 +00:00
|
|
|
<li>win9x for Microsoft Windows 95 and 98</li>
|
2002-06-01 12:26:43 +00:00
|
|
|
<li>z/os for z/OS and OS/390</li>
|
2002-09-27 08:18:51 +00:00
|
|
|
<li>os/400 for OS/400</li>
|
2003-07-10 11:52:50 +00:00
|
|
|
<li>openvms for OpenVMS</li>
|
2001-11-30 12:05:27 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<h4>equals</h4>
|
|
|
|
|
<p>Tests whether the two given Strings are identical</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">arg1</td>
|
|
|
|
|
<td valign="top">First string to test.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">arg2</td>
|
|
|
|
|
<td valign="top">Second string to test.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
2002-01-08 08:52:32 +00:00
|
|
|
<tr>
|
|
|
|
|
<td valign="top">casesensitive</td>
|
|
|
|
|
<td valign="top">Perform a case sensitive comparision. Default is
|
|
|
|
|
true.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">trim</td>
|
|
|
|
|
<td valign="top">Trim whitespace from arguments before comparing
|
|
|
|
|
them. Default is false.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>isset</h4>
|
|
|
|
|
<p>Test whether a given property has been set in this project.</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">property</td>
|
|
|
|
|
<td valign="top">The name of the property to test.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>checksum</h4>
|
2002-02-01 07:24:49 +00:00
|
|
|
<p>This condition is identical to the <a href="checksum.html">Checksum</a>
|
2001-11-30 12:05:27 +00:00
|
|
|
task, all attributes and nested elements of that task are supported,
|
|
|
|
|
the property and overwrite attributes are redundant and will be
|
|
|
|
|
ignored.</p>
|
|
|
|
|
|
|
|
|
|
<h4>http</h4>
|
|
|
|
|
<p>The <code>http</code> condition checks for a valid response from a
|
2002-06-01 12:26:43 +00:00
|
|
|
web server of the specified url. By default, HTTP responses errors
|
|
|
|
|
of 400 or greater are viewed as invalid.</p>
|
2001-11-30 12:05:27 +00:00
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td width="12%" valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td width="78%" valign="top"><b>Description</b></td>
|
|
|
|
|
<td width="10%" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td valign="top">url</td>
|
2002-02-01 07:24:49 +00:00
|
|
|
<td valign="top">The full URL of the page to request. The web server must
|
2002-12-01 01:30:08 +00:00
|
|
|
return a status code below the value of <tt>errorsBeginAt</tt></td>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td align="center">Yes.</td>
|
|
|
|
|
</tr>
|
2002-07-09 21:06:15 +00:00
|
|
|
<tr>
|
|
|
|
|
<td valign="top">errorsBeginAt</td>
|
|
|
|
|
<td valign="top">The lowest HTTP response code that signals an error;
|
|
|
|
|
by default '400'; server errors, not-authorized, not-found and the like
|
|
|
|
|
are detected</td>
|
|
|
|
|
<td align="center">No</td>
|
|
|
|
|
</tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>socket</h4>
|
|
|
|
|
<p>The <code>socket</code> condition checks for the existence of a
|
|
|
|
|
TCP/IP listener at the specified host and port.</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td width="12%" valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td width="78%" valign="top"><b>Description</b></td>
|
|
|
|
|
<td width="10%" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td valign="top">server</td>
|
|
|
|
|
<td valign="top">The DNS name or IP address of the server.</td>
|
|
|
|
|
<td align="center">Yes.</td>
|
|
|
|
|
</tr>
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2001-11-30 12:05:27 +00:00
|
|
|
<td valign="top">port</td>
|
|
|
|
|
<td valign="top">The port number to connect to.</td>
|
|
|
|
|
<td align="center">Yes.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2002-01-14 00:06:07 +00:00
|
|
|
<h4>filesmatch</h4>
|
2002-02-01 07:24:49 +00:00
|
|
|
<p>Test two files for matching. Nonexistence of either file results in "false".
|
2002-01-14 00:06:07 +00:00
|
|
|
This test does a byte for byte comparision, so test time scales with
|
2002-02-01 07:24:49 +00:00
|
|
|
byte size. NB: if the files are different sizes , one of them is missing
|
|
|
|
|
or the filenames match the answer is so obvious the detailed test is omitted.
|
|
|
|
|
|
|
|
|
|
|
2002-01-14 00:06:07 +00:00
|
|
|
</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2002-01-14 00:06:07 +00:00
|
|
|
<td width="12%" valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td width="78%" valign="top"><b>Description</b></td>
|
|
|
|
|
<td width="10%" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2002-01-14 00:06:07 +00:00
|
|
|
<td valign="top">file1</td>
|
|
|
|
|
<td valign="top">First file to test</td>
|
|
|
|
|
<td align="center">Yes.</td>
|
|
|
|
|
</tr>
|
2002-02-01 07:24:49 +00:00
|
|
|
<tr>
|
2002-01-14 00:06:07 +00:00
|
|
|
<td valign="top">file2</td>
|
|
|
|
|
<td valign="top">Second file to test</td>
|
|
|
|
|
<td align="center">Yes.</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2002-02-20 08:36:27 +00:00
|
|
|
<h4>contains</h4>
|
2002-04-19 07:15:44 +00:00
|
|
|
<p>Tests whether a string contains another one.</p>
|
2002-02-20 08:36:27 +00:00
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">string</td>
|
|
|
|
|
<td valign="top">The string to search in.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">substring</td>
|
|
|
|
|
<td valign="top">The string to search for.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">casesensitive</td>
|
|
|
|
|
<td valign="top">Perform a case sensitive comparision. Default is
|
|
|
|
|
true.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2002-04-19 07:15:44 +00:00
|
|
|
<h4>istrue</h4>
|
|
|
|
|
<p>Tests whether a string equals any of the ant definitions of true,
|
|
|
|
|
that is "true","yes", or "on"</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">value</td>
|
|
|
|
|
<td valign="top">value to test</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<pre>
|
2002-09-04 11:05:19 +00:00
|
|
|
<istrue value="${someproperty}"/>
|
|
|
|
|
<istrue value="false"/>
|
2002-07-09 21:06:15 +00:00
|
|
|
</pre>
|
|
|
|
|
|
2002-04-19 07:15:44 +00:00
|
|
|
<h4>isfalse</h4>
|
|
|
|
|
<p>Tests whether a string is not true, the negation of <istrue>
|
|
|
|
|
</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">value</td>
|
|
|
|
|
<td valign="top">value to test</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<pre>
|
2002-09-04 11:05:19 +00:00
|
|
|
<isfalse value="${someproperty}"/>
|
|
|
|
|
<isfalse value="false"/>
|
2002-07-09 21:06:15 +00:00
|
|
|
</pre>
|
|
|
|
|
|
2002-09-09 08:21:39 +00:00
|
|
|
<h4>isreference</h4>
|
|
|
|
|
|
|
|
|
|
<p>Test whether a given reference has been defined in this project and
|
|
|
|
|
- optionally - is of an expected type.</p>
|
|
|
|
|
|
|
|
|
|
<p>This condition has been added in Apache Ant 1.6.</p>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">refid</td>
|
|
|
|
|
<td valign="top">The id of the reference to test.</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">type</td>
|
|
|
|
|
<td valign="top">Name of the data type or task this reference is
|
|
|
|
|
expected to be.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
2004-11-26 13:42:43 +00:00
|
|
|
<h4>issigned</h4>
|
|
|
|
|
<p>
|
|
|
|
|
Test whether a jarfile is signed.
|
|
|
|
|
If the name of the
|
|
|
|
|
signature is passed, the file is checked for presence of that
|
|
|
|
|
particular signature; otherwise the file is checked for the
|
2005-02-07 23:42:21 +00:00
|
|
|
existence of any signature. It does not perform rigorous
|
|
|
|
|
signature validation; it only looks for the presence of a signature.
|
2004-11-26 13:42:43 +00:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2005-01-17 21:54:34 +00:00
|
|
|
This condition was added in Apache Ant 1.7.
|
2004-11-26 13:42:43 +00:00
|
|
|
</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">file</td>
|
|
|
|
|
<td valign="top">
|
|
|
|
|
The jarfile that is to be tested for the presence
|
|
|
|
|
of a signature.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">name</td>
|
|
|
|
|
<td valign="top"> The signature name to check for.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
2004-12-01 11:25:47 +00:00
|
|
|
<h4>isfileselected</h4>
|
|
|
|
|
<p>
|
2005-03-04 17:57:24 +00:00
|
|
|
Test whether a file passes an embedded
|
|
|
|
|
<a href="../CoreTypes/selectors.html">selector</a>.
|
2004-12-01 11:25:47 +00:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2005-03-03 17:26:32 +00:00
|
|
|
This condition was added in Apache Ant 1.6.3.
|
2004-12-01 11:25:47 +00:00
|
|
|
</p>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">file</td>
|
|
|
|
|
<td valign="top">
|
|
|
|
|
The file to check if is passes the embedded selector.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">basedir</td>
|
|
|
|
|
<td valign="top">The base directory to use for name based selectors. It this is not set,
|
|
|
|
|
the project's basedirectory will be used.</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<p>
|
|
|
|
|
Example usage:
|
|
|
|
|
</p>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<pre>
|
|
|
|
|
<isfileselected file="a.xml">
|
|
|
|
|
<date datetime="06/28/2000 2:02 pm" when="equal"/>
|
|
|
|
|
</isfileselected>
|
|
|
|
|
</pre></blockquote>
|
2004-01-22 18:02:57 +00:00
|
|
|
<h4>typefound</h4>
|
|
|
|
|
|
|
|
|
|
<p>Test whether a given type is defined, and that
|
|
|
|
|
its implementation class can be loaded. Types include
|
|
|
|
|
tasks, datatypes, scriptdefs, macrodefs and presetdefs.</p>
|
|
|
|
|
|
2005-01-17 21:54:34 +00:00
|
|
|
<p>This condition was added in Apache Ant 1.7.</p>
|
2004-01-22 18:02:57 +00:00
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">name</td>
|
|
|
|
|
<td valign="top">name of the type</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2005-01-17 21:54:34 +00:00
|
|
|
<h4>scriptcondition</h4>
|
|
|
|
|
|
|
|
|
|
<p>Evaluate a condition based on a script in any
|
|
|
|
|
<a href="http://jakarta.apache.org/bsf" target="_top">Apache BSF</a>
|
|
|
|
|
supported language.</p>
|
|
|
|
|
<p>
|
|
|
|
|
See the <a href="../OptionalTasks/script.html">Script</a> task for
|
|
|
|
|
an explanation of scripts and dependencies.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>This condition was added in Apache Ant 1.7.</p>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">language</td>
|
|
|
|
|
<td valign="top">script language</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">value</td>
|
|
|
|
|
<td valign="top">default boolean value</td>
|
|
|
|
|
<td valign="top" align="center">No -default is "false"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">src</td>
|
|
|
|
|
<td valign="top">filename of script source</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<p>
|
|
|
|
|
The script supports script language inline, this script has access to the
|
|
|
|
|
same beans as the <code><script></code> task, and to the <code>
|
|
|
|
|
self</code> bean, which refers back to the condition itself. The
|
|
|
|
|
<code>value</code> property of this bean sets the return value:
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Example:
|
|
|
|
|
</p>
|
|
|
|
|
<pre>
|
|
|
|
|
<scriptcondition language="javascript"
|
|
|
|
|
value="true">
|
|
|
|
|
self.setValue(false);
|
|
|
|
|
</scriptcondition>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
Sets the default value of the condition to true, then in the script,
|
|
|
|
|
sets the value to false. This condition always evaluates to "false"
|
2005-02-25 11:32:35 +00:00
|
|
|
|
|
|
|
|
<h4>parsersupports</h4>
|
|
|
|
|
|
|
|
|
|
<p>Tests whether Ant's XML parser supports a given
|
|
|
|
|
feature or property, as per the SAX/JAXP specifications, by
|
|
|
|
|
attempting to set the appropriate property/feature/</p>
|
|
|
|
|
|
|
|
|
|
<p>This condition was added in Apache Ant 1.7.</p>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">property</td>
|
|
|
|
|
<td valign="top">property to set</td>
|
|
|
|
|
<td valign="top" align="center">one of property or feature</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">feature</td>
|
|
|
|
|
<td valign="top">feature to set</td>
|
|
|
|
|
<td valign="top" align="center">one of property or feature</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">value</td>
|
|
|
|
|
<td valign="top">string (property) or boolean (feature)</td>
|
|
|
|
|
<td valign="top" align="center">For property tests, but not for feature tests</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
<parsersupports feature="http://xml.org/sax/features/namespaces"/>
|
|
|
|
|
</pre>
|
|
|
|
|
Check for namespace support. All SAX2 parsers should have this.
|
|
|
|
|
<pre>
|
|
|
|
|
<or>
|
|
|
|
|
<parsersupports
|
|
|
|
|
feature="http://apache.org/xml/features/validation/schema"/>
|
|
|
|
|
<parsersupports
|
|
|
|
|
feature="http://java.sun.com/xml/jaxp/properties/schemaSource"/>
|
|
|
|
|
</or>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
Check for XML Schema support.
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
|
|
|
|
<parsersupports
|
|
|
|
|
property="http://apache.org/xml/properties/schema/external-noNamespaceSchemaLocation"
|
|
|
|
|
value="document.xsd"/>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
Check for Xerces-specific definition of the location of the no namespace schema.
|
|
|
|
|
|
2005-03-10 14:09:39 +00:00
|
|
|
<h4>isreachable</h4>
|
|
|
|
|
|
|
|
|
|
<p>Uses Java1.5+ networking APIs to probe for a (remote) system being
|
|
|
|
|
reachable. Exactly what probe mechanisms are used is an implementation
|
2005-03-10 23:20:04 +00:00
|
|
|
feature of the JVM. They may include ICMP "ping" packets, UDP or TCP connections
|
|
|
|
|
to port 7 "echo service" or other means. On Java1.4 and earlier, being able
|
|
|
|
|
to resolve the hostname is considered success. This means that if DNS is not
|
|
|
|
|
working or a URL/hostname is bad, the test will fail, but otherwise succeed
|
|
|
|
|
even if the remote host is actually absent.
|
2005-03-10 14:09:39 +00:00
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
This condition turns unknown host exceptions into false conditions. This is
|
|
|
|
|
because on a laptop, DNS is one of the first services when the network goes; you
|
|
|
|
|
are implicitly offline.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
If a URL is supplied instead of a host, the hostname is extracted
|
|
|
|
|
and used in the test - all other parts of the URL are discarded.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
The test may not work through firewalls, that is, something may be reachable
|
|
|
|
|
using a protocol such as HTTP, while the lower level ICMP packets get dropped
|
|
|
|
|
on the floor. Similarly, a host may detected as reachable with ICMP, but
|
|
|
|
|
not reachable on other ports (i.e. port 80), because of firewalls.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
This condition was added in Apache Ant 1.7.</p>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">host</td>
|
|
|
|
|
<td valign="top">host to check for</td>
|
|
|
|
|
<td valign="top" align="center">one of url or host</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">url</td>
|
|
|
|
|
<td valign="top">URL containing hostname</td>
|
|
|
|
|
<td valign="top" align="center">one of url or host</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">timeout</td>
|
|
|
|
|
<td valign="top">timeout in seconds</td>
|
|
|
|
|
<td valign="top" align="center">no, default is 30s</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
<condition property="offline">
|
|
|
|
|
<isreachable url="http://ibiblio.org/maven/" />
|
|
|
|
|
</condition>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Probe for the maven repository being reachable.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
<condition property="offline">
|
|
|
|
|
<isreachable host="ibiblio.org" timeout="10" />
|
|
|
|
|
</condition>
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Probe for the maven repository being reachable using the hostname, ten second timeout..
|
|
|
|
|
</p>
|
2001-11-30 12:05:27 +00:00
|
|
|
<hr>
|
2005-01-17 21:54:34 +00:00
|
|
|
<p align="center">Copyright © 2001-2005 Apache Software
|
2001-11-30 12:05:27 +00:00
|
|
|
Foundation. All rights Reserved.</p>
|
|
|
|
|
|
|
|
|
|
</body>
|
2002-01-14 00:06:07 +00:00
|
|
|
</html>
|
