## 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:
  java.io.Serializable

Direct Known Subclasses:
  VAJBuildInfo.BuildInterruptedException

public class BuildException
extends java.lang.RuntimeException

Signals an error condition during a build

Author:
  James Duncan Davidson
See Also:
  Serialized Form

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

Method Summary
`java.lang.Throwable` `getCause()` Returns the nested exception, if any.
`java.lang.Throwable` `getException()` Returns the nested exception, if any.
`Location` `getLocation()` Returns the file location where the error occurred.
`void` `printStackTrace()` Prints the stack trace for this exception and any nested exception to `System.err`.
`void` `printStackTrace(java.io.PrintStream ps)` Prints the stack trace of this exception and any nested exception to the specified PrintStream.
`void` `printStackTrace(java.io.PrintWriter pw)` Prints the stack trace of this exception and any nested exception to the specified PrintWriter.
`void` `setLocation(Location location)` Sets the file location where the error occurred.
`java.lang.String` `toString()` Returns the location of the error and the error message.

Methods inherited from class java.lang.Throwable
`fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### BuildException

    public BuildException()

  Constructs a build exception with no descriptive information.

### BuildException

    public BuildException(java.lang.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(java.lang.String message,
                          java.lang.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(java.lang.String msg,
                          java.lang.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(java.lang.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(java.lang.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(java.lang.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

### getCause

    public java.lang.Throwable getCause()

  Returns the nested exception, if any.

  Returns:
    the nested exception, or `null` if no exception is associated with this one

### getException

    public java.lang.Throwable getException()

  Returns the nested exception, if any.

  Returns:
    the nested exception, or `null` if no exception is associated with this one

### toString

    public java.lang.String toString()

  Returns the location of the error and the error message.

  Returns:
    the location of the error and the error message

### 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`.

### getLocation

    public Location getLocation()

  Returns the file location where the error occurred.

  Returns:
    the file location where the error occurred.

### printStackTrace

    public void printStackTrace()

  Prints the stack trace for this exception and any nested exception to `System.err`.

### printStackTrace

    public void printStackTrace(java.io.PrintStream ps)

  Prints the stack trace of this exception and any nested exception to the specified PrintStream.

  Parameters:
    `ps` - The PrintStream to print the stack trace to. Must not be `null`.

### printStackTrace

    public void printStackTrace(java.io.PrintWriter pw)

  Prints the stack trace of this exception and any nested exception to the specified PrintWriter.

  Parameters:
    `pw` - The PrintWriter to print the stack trace to. Must not be `null`.

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.