+ + Extensible library download mechanism, integrated with the + Maven repository hosted + at ibiblio.org. + +
+ ++ This task can: +
+| Attribute | +Description | +Required | +
| destDir | +Destination directory for all downloads + | +Yes | +
| offline | +Flag to indicate that the system is offline, and that + no downloads should take place. + | +No | +
| flatten | +flag to indicate that files should be flattened when downloaded + | +No -default false | +
| pathID | +Name of a path to create containing all + libraries in this declaration. + | +No | +
| repositoryRef | +Reference to a predefined repository + | +Only if no repository is defined inline | +
| Attribute | +Description | +Required | +
| project | +Name of the project + | +Yes | +
| version | ++ | +Yes | +
| archive | +Name of the archive + | +No | +
| destinationName | +Filename of downloaded file + | +No, default remote name | +
| suffix | +Suffix of the archive + | +No -default ".jar" | +
| enabled | +flag to turn on or off specific download/use + of an archive + | +No -default "true" | +
Repository type.
+Ant only ships with one: the mavenrepository;
+
+| Attribute | +Description | +Required | +
| url | +URL of the repository + | +No | +
| + | + | +No | +
Example:
++ <repository ref="predefined.repository" /> ++ +
| Attribute | +Description | +Required | +
| url | +URL of the repository + | +No | +
| checkMD5 | +Flag to turn on MD5 checking + (unimplemented) + | +No | +
| username | +HTTP authentication username + | +No | +
| password | +HTTP authentication password + | +Only if username is set | +
Update policies are an (extensible) means of tuning the download, running +code before and possibly after a download. They can enable or disable +checks for individual files, skip the download process, or perform some +post-download validation. +
+ +All policies have at least the common set of attributes; some may have more, +in which case an updated attribute list is shown.
+ +| Attribute | +Description | +Required | +
| enabled | +Enabled flag + | +No -default "true" | +
Policies can be chained by listing them in order. Before an update/download +takes place, all policies will be executed in order. After the download, the +policies will be invoked in reverse order. The compound policy in such a +situation is left to the experimentor, though reading the source will help. +
+ +
+Developers may add new polices (such
+as signing incoming files) by adding new datatypes extending the
+LibraryPolicy class.
This policy will disable remote downloads when enabled. It is the policy +equivalent of the offline flag.
+ + +Example:
++ <noupdate /> ++ +
This policy forces all libraries to be downloaded. If any download failed, +the build will halt.
+Example:
++ <forceupdate /> ++ +
This policy tells Ant to check the repository to see if the files have changed +using timestamp checks. Any files which are up to date will not be downloaded again.
+ +Example:
++ <timestamp /> ++ +
| Attribute | +Description | +Required | +
| enabled | +Enabled flag + | +No -default "true" | +
| markerFile | +Name of a file to cache download history + | +Yes | +
| Days | +number of days between update checks + | +No | +
| Hours | +number of hours between update checks + | +No | +
| Minutes | +number of minutes between update checks + | +No | +
Example:
++ <scheduledupdate days="1" hours="3" minutes="17" /> ++ +
Check for an update every 27 hours, 17 minutes.
+ + +This policy is really for testing the library. It does not +alter the download policy, but after any download has taken place, +it verifies that the number of files downloaded matches the number +expected.
+ +| Attribute | +Description | +Required | +
| count | +number of downloaded files expected. + | +Yes | +
| enabled | +Enabled flag + | +No -default "true" | +
Example:
++ <assertdownloaded cound="4" /> ++ +
+ <!--
+ versions.properties says
+ xdoclet.version=2.0
+ commons-logging.version=1.0.3
+ commons-collections.version=3.1
+ -->
+ <property file="versions.properties" />
+
+ <libraries destDir="${lib.dir}" pathid="xdoclet.lib" >
+ <mavenrepository />
+ <library project="xdoclet"
+ version="${xdoclet.version}" />
+ <library project="commons-logging"
+ version="${commons-logging.version}" />
+ <library project="commons-collections"
+ version="${commons-collections.version}" />
+ </libraries>
+
+
+Load in versions from a file, then download the relevant archives. No +update schedule is defined, but a path is created for insertion into a +classpath. This property file driven dependency model is what we recommend +over hard coding versions in a build file. +
+ <libraries destDir="build/lib" offline="${offline}" flatten="true">
+ <mavenrepository url="${private.server}"/>
+ <library project="doomed" archive="dead-code"
+ suffix=".war"
+ destinationName="product.war"
+ version="LATEST"
+ />
+ <scheduledupdate markerfile="build/lib/marker.properties"
+ hours="11" />
+ </libraries>
+
+
+Download doomed/dead-code.LATEST.war from a private repository, save it to +build/lib/product.war with an update schedule of every eleven hours. +
+ +Copyright © 2005 The Apache Software Foundation. All rights +Reserved.
+ + + + diff --git a/docs/manual/CoreTasks/nice.html b/docs/manual/CoreTasks/nice.html index 4403b089a..7c871d32a 100644 --- a/docs/manual/CoreTasks/nice.html +++ b/docs/manual/CoreTasks/nice.html @@ -36,19 +36,19 @@<nice newpriority="10"/>-Set the Thread priority to 10. +Set the Thread priority to 10 (highest).
<nice currentpriority="priority"/>Store the current Thread priority in the user property "priority".
<nice currentpriority="currentpriority" newpriority="1"/>
-Set the current Thread priority to 1, storing the original +
Set the current Thread priority to 1 (lowest), storing the original priority in the user property "currentpriority". This can be used to set the priority back to its original value later.
Copyright © 2004 The Apache Software Foundation. All rights +
Copyright © 2004-2005 The Apache Software Foundation. All rights Reserved.