Ant-contrib.unkrig.de: Difference between revisions
m (→Conditions) |
(→Tasks) |
||
Line 4: | Line 4: | ||
== Tasks == | == Tasks == | ||
;[[Ant-contrib.unkrig.de / Tasks / break|<code><break></code>]] | |||
:Terminates the execution of the enclosing [[Ant-contrib.unkrig.de / Tasks / forEach2|<code><forEach2></code>]]. | |||
;[[Ant-contrib.unkrig.de / Tasks / continue|<code><continue></code>]] | |||
:Causes the enclosing [[Ant-contrib.unkrig.de / Tasks / forEach2|<code><forEach2></code>]] task to continue with the next iteration element. | |||
;[[Ant-contrib.unkrig.de / Tasks / follow|<code><follow></code>]] | ;[[Ant-contrib.unkrig.de / Tasks / follow|<code><follow></code>]] | ||
:Waits until a file grows. | :Waits until a file grows. | ||
;[[Ant-contrib.unkrig.de / Tasks / forEach2|<code><forEach2></code>]] | |||
:An enhanced version of <a href="http://ant-contrib.sourceforge.net/tasks/tasks/for.html">the FOR task of ant-contrib</a>. | |||
;[[Ant-contrib.unkrig.de / Tasks / jsonProperty|<code><jsonProperty></code>]] | ;[[Ant-contrib.unkrig.de / Tasks / jsonProperty|<code><jsonProperty></code>]] | ||
Line 13: | Line 22: | ||
;[[Ant-contrib.unkrig.de / Tasks / nslookup|<code><nslookup></code>]] | ;[[Ant-contrib.unkrig.de / Tasks / nslookup|<code><nslookup></code>]] | ||
:Resolves a host name or IP address. | :Resolves a host name or IP address. | ||
;[[Ant-contrib.unkrig.de / Tasks / retry2|<code><retry2></code>]] | |||
:An enhanced version of the <a href="http://ant.apache.org/manual/Tasks/retry.html">RETRY task</a>. | |||
;[[Ant-contrib.unkrig.de / Tasks / setAuthenticator|<code><setAuthenticator></code>]] | ;[[Ant-contrib.unkrig.de / Tasks / setAuthenticator|<code><setAuthenticator></code>]] |
Revision as of 15:56, 11 March 2014
Abstract
This library contributes useful tasks and types to APACHE ANT. It integrates seamlessly with other libraries like ant-contrib (which is not to be confused with this one).
Tasks
<break>
- Terminates the execution of the enclosing
<forEach2>
.
<continue>
- Causes the enclosing
<forEach2>
task to continue with the next iteration element.
<follow>
- Waits until a file grows.
<forEach2>
- An enhanced version of <a href="http://ant-contrib.sourceforge.net/tasks/tasks/for.html">the FOR task of ant-contrib</a>.
<jsonProperty>
- Parses a JSON document into a set of properties, in analogy with the standard ANT
<xmlproperty>
task.
<nslookup>
- Resolves a host name or IP address.
<retry2>
- An enhanced version of the <a href="http://ant.apache.org/manual/Tasks/retry.html">RETRY task</a>.
<setAuthenticator>
- Configures the authentication for all following
java.net.URLConnection
s, including the<urlConnection>
task.
<setCookieHandler>
- Enables or disables cookie handling for Java's
java.net.HttpURLConnection
, including the<urlConnection>
task.
<swingDialog>
- Pops up a highly configurable dialog and invites the user to fill in form fields.
<throughput>
- Measures expired time and calculates and displays throughput rates and estimated remaining times.
<urlConnection>
- Connects to a resource and writes data to it and/or reads data from it.
Resource Collections
A resource collection represents a group of resources. A resource is an entity that has a name and a value. An often-used example of a resource collection is the <fileSet>
type, where each resource is a file with its name and its contents.
<resourceCollectionDelta>
- Selects the subset of resources that was added, deleted or modified since the last check.
<resourceNames>
- Replaces the resources' values with their names.
Filter Readers
filter readers are an ANT concept that mimics the functionality of UNIX' pipes: A stream of bytes is read through a chain of filter readers, where each filter reader modifies the byte stream and/or performs some additional actions.
<progress>
- Prints dots (".") to STDERR as data is read through it. This implements a kind of 'progress monitoring' for slow tasks that read some data.
Conditions
Conditions are nested elements of the <condition>
, <waitfor>
and several other tasks.
<true>
,<false>
- Always evaluate to
true
resp.false
.
<every>
- Evaluates to
true
when it is evaluated for the first time, and when the last evaluation totrue
has been more than a configured interval ago.
<successful>
- Executes the tasks configured as subelements sequentially and evaluates to whether all subtasks have completed successfully.
Download and installation
The JAR file can be downloaded from http://ant-contrib.unkrig.de/download/.
To make the contributions available in your ANT scripts, write
<taskdef resource="de/unkrig/antcontrib/ant.xml" classpath="path/to/de.unkrig.ant-contrib.jar" />
, or, if you put the JAR file on ANT's default classpath, just
<taskdef resource="de/unkrig/antcontrib/ant.xml" />
Source code
The source code is available in the SUBVERSION repository. The repository URL is
https://svn.code.sf.net/p/loggifier/code
License
ANT-CONTRIB is published under the "New BSD License".