com.android.dx.util

Class ExceptionWithContext

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.android.dx.util.ExceptionWithContext

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

DexException, MutabilityException

public class ExceptionWithContext
extends RuntimeException

Exception which carries around structured context.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ExceptionWithContext(String message) Constructs an instance.
ExceptionWithContext(String message, Throwable cause) Constructs an instance.
ExceptionWithContext(Throwable cause) Constructs an instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	addContext(String str) Adds a line of context to this instance.
String	getContext() Gets the context.
void	printContext(PrintStream out) Prints the message and context.
void	printContext(PrintWriter out) Prints the message and context.
void	printStackTrace(PrintStream out)
void	printStackTrace(PrintWriter out)
static ExceptionWithContext	withContext(Throwable ex, String str) Augments the given exception with the given context, and return the result.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionWithContext

public ExceptionWithContext(String message)

Constructs an instance.

Parameters:

message - human-oriented message

ExceptionWithContext

public ExceptionWithContext(Throwable cause)

Constructs an instance.

Parameters:

cause - null-ok; exception that caused this one

ExceptionWithContext

public ExceptionWithContext(String message,
                    Throwable cause)

Constructs an instance.

Parameters:

message - human-oriented message

cause - null-ok; exception that caused this one

Method Detail

withContext

public static ExceptionWithContext withContext(Throwable ex,
                               String str)

Augments the given exception with the given context, and return the result. The result is either the given exception if it was an ExceptionWithContext, or a newly-constructed exception if it was not.

Parameters:

ex - non-null; the exception to augment

str - non-null; context to add

Returns:

non-null; an appropriate instance

printStackTrace

public void printStackTrace(PrintStream out)

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter out)

Overrides:

printStackTrace in class Throwable

addContext

public void addContext(String str)

Adds a line of context to this instance.

Parameters:

str - non-null; new context

getContext

public String getContext()

Gets the context.

Returns:

non-null; the context

printContext

public void printContext(PrintStream out)

Prints the message and context.

Parameters:

out - non-null; where to print to

printContext

public void printContext(PrintWriter out)

Prints the message and context.

Parameters:

out - non-null; where to print to