Package org.aspectj.bridge

Class AbortException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.aspectj.bridge.AbortException

All Implemented Interfaces:

Serializable

public class AbortException
extends RuntimeException

Signal that a process was aborted before completion. This may contain a structured IMessage which indicates why the process was aborted (e.g., the underlying exception). For processes using try/catch to complete a method abruptly but complete the process normally (e.g., a test failure causes the test to abort but the reporting and testing continues normally), use the static methods to borrow and return a "porter" to avoid the expense of constructing a stack trace each time. A porter stack trace is invalid, and it should only be used to convey a message. E.g., to print the stack of the AbortException and any contained message:

 catch (AbortException ae) {
     IMessage m = ae.getMessage();
     if (!ae.isPorter()) ae.printStackTrace(System.err);
     Throwable thrown = ae.getThrown();
     if (null != thrown) thrown.printStackTrace(System.err);
 }
 

Author:

PARC, Andy Clement

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	isPorter	true if this is a porter exception - only used to hold message
protected IMessage	message	structured message abort
static final String	NO_MESSAGE_TEXT	used when message text is null

Constructor Summary

Constructors

Constructor	Description
AbortException()	abort with default String message
AbortException(String s)	abort with message
AbortException(IMessage message)	abort with structured message

Method Summary

Modifier and Type	Method	Description
static AbortException	borrowPorter(IMessage message)	Get a porter exception from the pool.
IMessage	getIMessage()
String	getMessage()	Get message for this AbortException, either associated explicitly as message or implicitly as IMessage message or its thrown message.
Throwable	getThrown()
boolean	isPorter()	The stack trace of a porter is invalid; it is only used to carry a message (which may itself have a wrapped exception).
boolean	isSilent()
void	printStackTrace()
void	printStackTrace(PrintStream s)	Print the stack trace of any enclosed thrown or this otherwise.
void	printStackTrace(PrintWriter s)	Print the stack trace of any enclosed thrown or this otherwise.
static void	returnPorter(AbortException porter)	Return (or add) a porter exception to the pool.
void	setIsSilent(boolean isSilent)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Details

NO_MESSAGE_TEXT

public static final String NO_MESSAGE_TEXT

used when message text is null

See Also:

• Constant Field Values

message

protected IMessage message

structured message abort

isPorter

protected boolean isPorter

true if this is a porter exception - only used to hold message

Constructor Details

AbortException

public AbortException()

abort with default String message

AbortException

public AbortException(String s)

abort with message

AbortException

public AbortException(IMessage message)

abort with structured message

Method Details

borrowPorter

public static AbortException borrowPorter(IMessage message)

Get a porter exception from the pool. Porter exceptions do not have valid stack traces. They are used only to avoid generating stack traces when using throw/catch to abruptly complete but continue.

returnPorter

public static void returnPorter(AbortException porter)

Return (or add) a porter exception to the pool.

getIMessage

public IMessage getIMessage()

Returns:

IMessage structured message, if set

isPorter

public boolean isPorter()

The stack trace of a porter is invalid; it is only used to carry a message (which may itself have a wrapped exception).

Returns:

true if this exception is only to carry exception

getThrown

public Throwable getThrown()

Returns:

Throwable at bottom of IMessage chain, if any

getMessage

public String getMessage()

Get message for this AbortException, either associated explicitly as message or implicitly as IMessage message or its thrown message.

Overrides:

getMessage in class Throwable

See Also:

• Throwable.getMessage()

printStackTrace

public void printStackTrace()

Overrides:

printStackTrace in class Throwable

See Also:

• Throwable.printStackTrace()

printStackTrace

public void printStackTrace(PrintStream s)

Print the stack trace of any enclosed thrown or this otherwise.

Overrides:

printStackTrace in class Throwable

See Also:

• Throwable.printStackTrace(PrintStream)

printStackTrace

public void printStackTrace(PrintWriter s)

Print the stack trace of any enclosed thrown or this otherwise.

Overrides:

printStackTrace in class Throwable

See Also:

• Throwable.printStackTrace(PrintWriter)

isSilent

public boolean isSilent()

setIsSilent

public void setIsSilent(boolean isSilent)