Package org.apache.openjpa.util

Class OpenJPAException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.apache.openjpa.util.OpenJPAException

All Implemented Interfaces:

Serializable, ExceptionInfo

Direct Known Subclasses:

GeneralException, InternalException, StoreException, UnsupportedException, UserException, ValidationUnavailableException, WrappedException

public abstract class OpenJPAException
extends RuntimeException
implements Serializable, ExceptionInfo

Exception type for all OpenJPA exceptions. Meant to be easily transformed into an appropriate exception at the API layer, since most APIs define their own exception types.

Since:

0.4.0

Author:

Abe White

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.apache.openjpa.util.ExceptionInfo

GENERAL, INTERNAL, STORE, UNAVAILABLE, UNSUPPORTED, USER, WRAPPED

Constructor Summary

Constructors

Constructor	Description
OpenJPAException()	Default constructor.
OpenJPAException(String msg)	Constructor; supply message.
OpenJPAException(String msg, Throwable cause)	Construct with message and cause.
OpenJPAException(Throwable cause)	Construct with cause.
OpenJPAException(Localizer.Message msg)	Constructor; supply message.
OpenJPAException(Localizer.Message msg, Throwable cause)	Construct with message and cause.

Method Summary

Modifier and Type	Method	Description
Throwable	getCause()	Returns the first Throwable from getNestedThrowables() in order to conform to Throwable.getCause() in Java 1.4+.
Object	getFailedObject()	The failed object.
Throwable[]	getNestedThrowables()	The nested throwables.
int	getSubtype()	Exception subtype.
abstract int	getType()	Exception type.
boolean	isFatal()	Whether this error is fatal.
void	printStackTrace()	Stack.
void	printStackTrace(PrintStream out)
void	printStackTrace(PrintWriter out)
OpenJPAException	setCause(Throwable nested)	The first nested throwable.
OpenJPAException	setFailedObject(Object failed)	The failed object.
OpenJPAException	setFatal(boolean fatal)	Whether this error is fatal.
OpenJPAException	setNestedThrowables(Throwable[] nested)	The nested throwables.
String	toString()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, setStackTrace

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.openjpa.util.ExceptionInfo

getMessage

Constructor Detail

OpenJPAException

public OpenJPAException()

Default constructor.

OpenJPAException

public OpenJPAException(String msg)

Constructor; supply message.

OpenJPAException

public OpenJPAException(Localizer.Message msg)

Constructor; supply message.

OpenJPAException

public OpenJPAException(Throwable cause)

Construct with cause.

OpenJPAException

public OpenJPAException(String msg,
                        Throwable cause)

Construct with message and cause.

OpenJPAException

public OpenJPAException(Localizer.Message msg,
                        Throwable cause)

Construct with message and cause.

Method Detail

getType

public abstract int getType()

Exception type.

Specified by:

getType in interface ExceptionInfo

getSubtype

public int getSubtype()

Exception subtype.

Specified by:

getSubtype in interface ExceptionInfo

isFatal

public boolean isFatal()

Whether this error is fatal.

Specified by:

isFatal in interface ExceptionInfo

setFatal

public OpenJPAException setFatal(boolean fatal)

Whether this error is fatal.

getCause

public Throwable getCause()

Returns the first Throwable from getNestedThrowables() in order to conform to Throwable.getCause() in Java 1.4+.

Specified by:

getCause in interface ExceptionInfo

Overrides:

getCause in class Throwable

See Also:

Throwable.getCause()

setCause

public OpenJPAException setCause(Throwable nested)

The first nested throwable.

getNestedThrowables

public Throwable[] getNestedThrowables()

The nested throwables.

Specified by:

getNestedThrowables in interface ExceptionInfo

setNestedThrowables

public OpenJPAException setNestedThrowables(Throwable[] nested)

The nested throwables.

getFailedObject

public Object getFailedObject()

The failed object.

Specified by:

getFailedObject in interface ExceptionInfo

setFailedObject

public OpenJPAException setFailedObject(Object failed)

The failed object.

toString

public String toString()

Overrides:

toString in class Throwable

printStackTrace

public void printStackTrace()

Description copied from interface: ExceptionInfo

Stack.

Specified by:

printStackTrace in interface ExceptionInfo

Overrides:

printStackTrace in class Throwable

See Also:

Throwable.printStackTrace()

printStackTrace

public void printStackTrace(PrintStream out)

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter out)

Overrides:

printStackTrace in class Throwable