- Apache ANT Tasks Tutorial
- ANT Tasks - Home
- ANT Tasks - Introduction
- ANT Tasks - Environment Setup
- Apache ANT Tasks Examples
- ANT Tasks - BaseName
- ANT Tasks - GZip
- ANT Tasks - GUnzip
- ANT Tasks - Chmod
- ANT Tasks - Concat
- ANT Tasks - Condition
- ANT Tasks - Copy
- ANT Tasks - Delete
- ANT Tasks - EAR
- ANT Tasks - Fail
- ANT Tasks - Import
- ANT Tasks - Java
- ANT Tasks - Javac
- ANT Tasks - Length
- ANT Tasks - LoadFile
- ANT Tasks - MkDir
- ANT Tasks - Move
- ANT Tasks - Sleep
- ANT Tasks - WAR
- ANT Tasks - Zip
- ANT Tasks -JAR
- Apache ANT Tasks Useful Resources
- Ant Tasks - Quick Guide
- Ant Tasks - Useful Resources
- Ant Tasks - Discussion
Apache Ant Tasks - Fail
Description
Fail task is used to exit the current build by throwing a BuildException, optionally printing additional information. The message of the Exception can be set via the message attribute or character data nested into the element.
Properties
Sr.No | Attributes & Description |
---|---|
1 | Message A message giving further information on why the build exited. |
2 | If Only fail if a property of the given name exists in the current project |
3 | Unless Only fail if a property of the given name doesn't exist in the current project |
4 | Status Exit using the specified status code; assuming the generated Exception is not caught, the JVM will exit with this status. |
Example
Usage
Create build.xml with the following content −
<?xml version="1.0"?> <project name="TutorialPoint" default="info"> <property name="build.dir" value="build" /> <target name="info"> <fail unless="src.dir"/> </target> </project>
Above script will fail the build as src.dir is not set.
Output
Running Ant on the above build file produces the following output −
F:\tutorialspoint\ant>ant Buildfile: F:\tutorialspoint\ant\build.xml info: BUILD FAILED F:\tutorialspoint\ant\build.xml:5: unless=src.dir Total time: 0 seconds
Advertisements