ANT Tasks – Fail


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:tutorialspointant>ant
Buildfile: F:tutorialspointantbuild.xml

info:

BUILD FAILED
F:tutorialspointantbuild.xml:5: unless=src.dir

Total time: 0 seconds

Advertisements

”;

Leave a Reply

Your email address will not be published. Required fields are marked *