Package org.apache.tools.ant.taskdefs
Class Exit
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.Exit
- All Implemented Interfaces:
Cloneable
Exits the active build, giving an additional message
if available.
The
if and unless attributes make the
failure conditional -both probe for the named property being defined.
The if tests for the property being defined, the
unless for a property being undefined.
If both attributes are set, then the test fails only if both tests
are true. i.e.
fail := defined(ifProperty) && !defined(unlessProperty)A single nested
<condition> element can be specified
instead of using if/unless (a combined
effect can be achieved using isset conditions).- Since:
- Ant 1.2
-
Field Summary
Fields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidSet a multiline message.Add a condition element.voidexecute()Throw aBuildExceptionto exit (fail) the build.voidOnly fail if the given expression evaluates to true or the name of an existing property.voidOnly fail if the given expression evaluates to true or the name of an existing property.voidsetMessage(String value) A message giving further information on why the build exited.voidsetStatus(int i) Set the status code to associate with the thrown Exception.voidOnly fail if the given expression evaluates to false or tno property of the given name exists.voidOnly fail if the given expression evaluates to false or tno property of the given name exists.Methods inherited from class org.apache.tools.ant.Task
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
-
Constructor Details
-
Exit
public Exit()
-
-
Method Details
-
setMessage
A message giving further information on why the build exited.- Parameters:
value- message to output
-
setIf
Only fail if the given expression evaluates to true or the name of an existing property.- Parameters:
c- property name or evaluated expression- Since:
- Ant 1.8.0
-
setIf
Only fail if the given expression evaluates to true or the name of an existing property.- Parameters:
c- property name or evaluated expression
-
setUnless
Only fail if the given expression evaluates to false or tno property of the given name exists.- Parameters:
c- property name or evaluated expression- Since:
- Ant 1.8.0
-
setUnless
Only fail if the given expression evaluates to false or tno property of the given name exists.- Parameters:
c- property name or evaluated expression
-
setStatus
public void setStatus(int i) Set the status code to associate with the thrown Exception.- Parameters:
i- theintstatus
-
execute
Throw aBuildExceptionto exit (fail) the build. If specified, evaluate conditions: A single nested condition is accepted, but requires that theif/unlessattributes be omitted. If the nested condition evaluates to true, or the ifCondition is true or unlessCondition is false, the build will exit. The error message is constructed from the text fields, from the nested condition (if specified), or finally from the if and unless parameters (if present).- Overrides:
executein classTask- Throws:
BuildException- on error
-
addText
Set a multiline message.- Parameters:
msg- the message to display
-
createCondition
Add a condition element.- Returns:
ConditionBase.- Since:
- Ant 1.6.2
-