ant/docs/manual/CoreTasks/retry.html
Kevin Jackson 943fa3a975 -retry task container
git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@539309 13f79535-47bb-0310-9956-ffa450edef68
2007-05-18 08:25:32 +00:00

56 lines
2.1 KiB
HTML

<!--
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
http://www.apache.org/licenses/LICENSE-2.0
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.
-->
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
<title>Retry Task</title>
</head>
<body>
<h2>Retry</h2>
<h3>Description</h3>
<p>Retry is a container task - it can contain an Ant task. The nested
task is executed, if an error occurs, the task can be executed again without
the build failing. The amount of times that the nested task can be 'retried'
is configurable.</p>
<h3>Parameters</h3>
<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">retrycount</td>
<td valign="top">number of times to attempt to execute the nested task</td>
<td valign="top" align="center">Yes</td>
</tr>
</table>
<p>Any valid Ant task may be embedded within the retry task.</p>
<h3>Example</h3>
<pre>
&lt;retry retrycount="3"&gt;
&lt;get src="http://www.unreliable-server.com/unreliable.tar.gz"
dest="/home/retry/unreliable.tar.gz"/&gt;
&lt;/retry&gt;
</pre>
<p>This example shows how to use <code>&lt;retry&gt;</code> to wrap a task which must interact with an unreliable network resource.</p>
</body>
</html>