此任務用於停止當前構建並拋出BuildException。它從當前構建退出並向控制臺顯示異常消息。
message屬性用於為此元素設置異常消息。
1. Apache Ant失敗任務屬性
| 屬性 | 描述 | 必需 |
|---|---|---|
message |
顯示失敗原因的消息 | 否 |
if |
僅當當前目錄中存在屬性時才會失敗 | 否 |
unless |
僅在當前專案中不存在屬性時才會失敗 | 否 |
下麵來看一下Ant Fail Task的一些例子，如下所示。
2. Apache Ant失敗任務示例
無消息
<project name="fail-project-example" default="fail">
<target name="fail">
<fail/>
</target>
</project>
設置消息
<project name="fail-project-example" default="fail">
<target name="fail">
<fail message="something went wrong"/>
</target>
</project>
使用unless
<project name="fail-project-example" default="fail">
<target name="fail">
<fail unless="it is unless message"/>
</target>
</project>
輸出結果為:
fail:
BUILD FAILED
unless=it is unless message