| 1 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 7. Try Task</title><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="Antelope Users Guide"><link rel="up" href="bk03.html" title="Additional Ant Tasks"><link rel="prev" href="bk03ch06.html" title="Chapter 6. SwitchTask"><link rel="next" href="bk03ch08.html" title="Chapter 8. Unset Task"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 7. Try Task</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk03ch06.html">Prev</a> </td><th width="60%" align="center">Additional Ant Tasks</th><td width="20%" align="right"> <a accesskey="n" href="bk03ch08.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="TryTask"></a>Chapter 7. Try Task</h2></div></div></div>
|
|---|
| 2 | <STYLE TYPE="text/css"> <!-- @import url(./style.css); --> </STYLE>
|
|---|
| 3 | <p>
|
|---|
| 4 | The "Try" task works similarly to the try/catch/finally construct in Java. This task is useful when a particular task might fail, but the build should not fail if it does. An example is the "mail" task will fail if the mail server is not available, but the build should not fail if the mail message cannot be delivered.
|
|---|
| 5 | </p><p>
|
|---|
| 6 | To use this task in your build files, include a task definition like this:
|
|---|
| 7 | </p><p>
|
|---|
| 8 | </p><pre class="programlisting">
|
|---|
| 9 |
|
|---|
| 10 | <taskdef name="try" classname="ise.antelope.tasks.TryTask"/>
|
|---|
| 11 |
|
|---|
| 12 | </pre><p>
|
|---|
| 13 | </p><p>
|
|---|
| 14 | A quick example is probably all that is necessary:
|
|---|
| 15 | </p><pre class="programlisting">
|
|---|
| 16 |
|
|---|
| 17 | <tempfile property="temp.file" destdir="${java.io.tmpdir}"
|
|---|
| 18 | prefix="delete" suffix=".tmp"/>
|
|---|
| 19 | <try>
|
|---|
| 20 | <!-- use 'get' task to post to the unit test status servlet. It
|
|---|
| 21 | would be better to use a post for this, but this shows a good
|
|---|
| 22 | use of 'finally'. -->
|
|---|
| 23 | <get
|
|---|
| 24 | src="http://mycompany.com/servlet/junit?testnum=${test.num}&status="${status}"
|
|---|
| 25 | dest="${temp.file}"/>
|
|---|
| 26 |
|
|---|
| 27 | <catch>
|
|---|
| 28 | <echo>Unit test servlet update failed.</echo>
|
|---|
| 29 | </catch>
|
|---|
| 30 |
|
|---|
| 31 | <finally>
|
|---|
| 32 | <delete file="${temp.file}"/>
|
|---|
| 33 | </finally>
|
|---|
| 34 | </try>
|
|---|
| 35 |
|
|---|
| 36 | </pre><p>
|
|---|
| 37 | </p><p>
|
|---|
| 38 | Unlike the Java "try", neither the "catch" block nor the "finally" block are required. Also, the order does not matter, the "catch" block may be listed first, followed by the "finally", followed by the tasks that may fail.
|
|---|
| 39 | </p><p>
|
|---|
| 40 | </p><div class="table"><a name="id2520781"></a><p class="title"><b>Table 7.1. Try Task Attributes</b></p><table summary="Try Task Attributes" border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Attribute</th><th>Description</th><th>Default</th><th>Required</th></tr></thead><tbody><tr><td>break</td><td>If true and a nested task fails, no other nested tasks will execute. If false, all nested tasks will execute regardless of whether a previous task failed. Note that for each failed task, the 'catch' block (if defined) will execute.</td><td>true</td><td>No</td></tr><tr><td>printstacktrace</td><td>If true, the exception stack trace from a failed task will be logged. </td><td>false</td><td>No</td></tr><tr><td>stacktraceproperty</td><td>Specify a property to store the stack trace of any exception. </td><td>None</td><td>No</td></tr><tr><td>printmessage</td><td>If true, the exception message from a failed task will be logged. If printstacktrace is set to true, this attribute is ignored as the exception message is printed as part of the stack trace.</td><td>true</td><td>No</td></tr><tr><td>messageproperty</td><td>Specify a property to store the message line of any exception.</td><td>None</td><td>No</td></tr></tbody></table></div><p>
|
|---|
| 41 | </p><p>
|
|---|
| 42 | The next example shows the "break" attribute set to "no". In this case, the second echo task will execute.
|
|---|
| 43 | </p><p>
|
|---|
| 44 | </p><pre class="programlisting">
|
|---|
| 45 |
|
|---|
| 46 | <target name="test" description="This exercises the Try task.">
|
|---|
| 47 | <try break="no">
|
|---|
| 48 | <echo>I am trying...</echo>
|
|---|
| 49 | <fail message=" and I failed..."/>
|
|---|
| 50 | <echo> but I did not die!</echo> <!-- this WILL print -->
|
|---|
| 51 | </try>
|
|---|
| 52 | </target>
|
|---|
| 53 |
|
|---|
| 54 | </pre><p>
|
|---|
| 55 | </p><p>
|
|---|
| 56 | This slightly more practical example uses the <a href="bk03ch09.html" title="Chapter 9. Variable Task">Variable</a> task coupled with "try" to run a series of tests. All tests will run even if a preceding test fails. The "catch" block logs a message of each failed test.
|
|---|
| 57 | </p><p>
|
|---|
| 58 | </p><pre class="programlisting">
|
|---|
| 59 |
|
|---|
| 60 | <target name="runTests" messageproperty="msg">
|
|---|
| 61 | <try catch="testFailed" break="no">
|
|---|
| 62 | <var name="testname" value="fileUtilTests"/>
|
|---|
| 63 | <antcall target="runFileUtilTests"/>
|
|---|
| 64 | <var name="testname" value="imageUtilTests"/>
|
|---|
| 65 | <antcall target="runImageUtilTests"/>
|
|---|
| 66 | <var name="testname" value="imageConversionTests"/>
|
|---|
| 67 | <antcall target="runImageConversionTests"/>
|
|---|
| 68 |
|
|---|
| 69 | <catch>
|
|---|
| 70 | <!-- log a test failure -->
|
|---|
| 71 | <echo file="test.log" append="yes">
|
|---|
| 72 | Test suite ${testname} failed: ${msg}
|
|---|
| 73 | </echo>
|
|---|
| 74 | </catch>
|
|---|
| 75 | </try>
|
|---|
| 76 | </target>
|
|---|
| 77 | </target>
|
|---|
| 78 |
|
|---|
| 79 | </pre><p>
|
|---|
| 80 | </p><p>
|
|---|
| 81 | The following example uses a nested Finally to clean up resources:
|
|---|
| 82 | </p><pre class="programlisting">
|
|---|
| 83 |
|
|---|
| 84 | <tempfile property="temp.file" destdir="${java.io.tmpdir}"
|
|---|
| 85 | prefix="delete" suffix=".tmp"/>
|
|---|
| 86 | <try>
|
|---|
| 87 | <!-- use 'get' task to post to the unit test status servlet. It
|
|---|
| 88 | would be better use use a post for this, but this shows a good
|
|---|
| 89 | use of 'finally'. -->
|
|---|
| 90 | <get
|
|---|
| 91 | src="http://mycompany.com/servlet/junit?testnum=${test.num}&status="${status}"
|
|---|
| 92 | dest="${temp.file}"/>
|
|---|
| 93 |
|
|---|
| 94 | <catch>
|
|---|
| 95 | <echo>Unit test servlet update failed.</echo>
|
|---|
| 96 | </catch>
|
|---|
| 97 |
|
|---|
| 98 | <finally>
|
|---|
| 99 | <delete file="${temp.file}"/>
|
|---|
| 100 | </finally>
|
|---|
| 101 | </try>
|
|---|
| 102 |
|
|---|
| 103 | </pre><p>
|
|---|
| 104 | See the <a href="bk03ch17.html" title="Chapter 17. HTTP Post">post</a> task for a better way to do a post.
|
|---|
| 105 | </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk03ch06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="bk03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bk03ch08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. SwitchTask </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. Unset Task</td></tr></table></div></body></html>
|
|---|
