org.apache.tools.ant

Class BuildException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.tools.ant.BuildException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BuildTimeoutException, ExitStatusException, UnsupportedAttributeException, UnsupportedElementException

public class BuildException
extends RuntimeException

Signals an error condition during a build

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
BuildException() Constructs a build exception with no descriptive information.
BuildException(String message) Constructs an exception with the given descriptive message.
BuildException(String message, Location location) Constructs an exception with the given descriptive message and a location in a file.
BuildException(String message, Throwable cause) Constructs an exception with the given message and exception as a root cause.
BuildException(String msg, Throwable cause, Location location) Constructs an exception with the given message and exception as a root cause and a location in a file.
BuildException(Throwable cause) Constructs an exception with the given exception as a root cause.
BuildException(Throwable cause, Location location) Constructs an exception with the given exception as a root cause and a location in a file.

Method Summary

Modifier and Type	Method and Description
Location	getLocation() Returns the file location where the error occurred.
void	setLocation(Location location) Sets the file location where the error occurred.
String	toString() Returns the location of the error and the error message.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BuildException

public BuildException()

Constructs a build exception with no descriptive information.

BuildException

public BuildException(String message)

Constructs an exception with the given descriptive message.

Parameters:

message - A description of or information about the exception. Should not be null.

BuildException

public BuildException(String message,
                      Location location)

Constructs an exception with the given descriptive message and a location in a file.

Parameters:

message - A description of or information about the exception. Should not be null.

location - The location in the project file where the error occurred. Must not be null.

BuildException

public BuildException(String message,
                      Throwable cause)

Constructs an exception with the given message and exception as a root cause.

Parameters:

message - A description of or information about the exception. Should not be null unless a cause is specified.

cause - The exception that might have caused this one. May be null.

BuildException

public BuildException(String msg,
                      Throwable cause,
                      Location location)

Constructs an exception with the given message and exception as a root cause and a location in a file.

Parameters:

msg - A description of or information about the exception. Should not be null unless a cause is specified.

cause - The exception that might have caused this one. May be null.

location - The location in the project file where the error occurred. Must not be null.

BuildException

public BuildException(Throwable cause)

Constructs an exception with the given exception as a root cause.

Parameters:

cause - The exception that might have caused this one. Should not be null.

BuildException

public BuildException(Throwable cause,
                      Location location)

Constructs an exception with the given exception as a root cause and a location in a file.

Parameters:

cause - The exception that might have caused this one. Should not be null.

location - The location in the project file where the error occurred. Must not be null.

Method Detail

getLocation

public Location getLocation()

Returns the file location where the error occurred.

Returns:

the file location where the error occurred.

setLocation

public void setLocation(Location location)

Sets the file location where the error occurred.

Parameters:

location - The file location where the error occurred. Must not be null.

toString

public String toString()

Returns the location of the error and the error message.

Overrides:

toString in class Throwable

Returns:

the location of the error and the error message