org.apache.juneau.serializer

Class SerializeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.apache.juneau.FormattedException

org.apache.juneau.serializer.SerializeException

All Implemented Interfaces:

Serializable

public class SerializeException
extends FormattedException

General exception thrown whenever an error occurs during serialization.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SerializeException(SerializerSession session, Exception causedBy) Constructor.
SerializeException(SerializerSession session, String message, Object... args) Constructor.
SerializeException(String message, Object... args) Constructor.
SerializeException(Throwable causedBy) Constructor.

Method Summary

Modifier and Type	Method and Description
static SerializeException	create(Throwable e) Creator method.
SerializeException	getRootCause() Returns the highest-level ParseException in the stack trace.
SerializeException	initCause(Throwable cause) Sets the inner cause for this exception.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

SerializeException

public SerializeException(SerializerSession session,
                          String message,
                          Object... args)

Constructor.

Parameters:

session - The serializer session to extract information from.

message - The exception message containing MessageFormat-style arguments.

args - Optional MessageFormat-style arguments.

SerializeException

public SerializeException(String message,
                          Object... args)

Constructor.

Parameters:

message - The exception message containing MessageFormat-style arguments.

args - Optional MessageFormat-style arguments.

SerializeException

public SerializeException(SerializerSession session,
                          Exception causedBy)

Constructor.

Parameters:

session - The serializer session to extract information from.

causedBy - The inner exception.

SerializeException

public SerializeException(Throwable causedBy)

Constructor.

Parameters:

causedBy - The inner exception.

Method Detail

create

public static SerializeException create(Throwable e)

Creator method.

If the throwable is already a SerializeException, we simply return that exception as-is. If the throwable is an InvocationTargetException, we unwrap the thrown exception. Otherwise we create a new SerializeException.

Parameters:

e - The exception being wrapped or unwrapped.

Returns:

A new SerializeException.

getRootCause

public SerializeException getRootCause()

Returns the highest-level ParseException in the stack trace. Useful for JUnit testing of error conditions.

Returns:

The root parse exception, or this exception if there isn't one.

initCause

public SerializeException initCause(Throwable cause)

Sets the inner cause for this exception.

Overrides:

initCause in class Throwable

Parameters:

cause - The inner cause.

Returns:

This object (for method chaining).