com.amazon.carbonado.spi

Class ExceptionTransformer

java.lang.Object

com.amazon.carbonado.spi.ExceptionTransformer

public class ExceptionTransformer
extends java.lang.Object

Supports transforming arbitrary exceptions into appropriate repository exceptions. Repositories will likely extend this class, providing custom transformation rules.

Author:

Brian S O'Neill

Constructor Summary

Constructors

Constructor and Description
ExceptionTransformer()

Method Summary

Methods

Modifier and Type	Method and Description
static ExceptionTransformer	getInstance() Returns a generic instance.
FetchException	toFetchException(java.lang.Throwable e) Transforms the given throwable into an appropriate fetch exception.
PersistException	toPersistException(java.lang.Throwable e) Transforms the given throwable into an appropriate persist exception.
RepositoryException	toRepositoryException(java.lang.Throwable e) Transforms the given throwable into an appropriate repository exception.
protected FetchException	transformIntoFetchException(java.lang.Throwable e) Override to support custom transformations, returning null if none is applicable.
protected PersistException	transformIntoPersistException(java.lang.Throwable e) Override to support custom transformations, returning null if none is applicable.
protected RepositoryException	transformIntoRepositoryException(java.lang.Throwable e) Override to support custom transformations, returning null if none is applicable.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionTransformer

public ExceptionTransformer()

Method Detail

getInstance

public static ExceptionTransformer getInstance()

Returns a generic instance.

toFetchException

public FetchException toFetchException(java.lang.Throwable e)

Transforms the given throwable into an appropriate fetch exception. If it already is a fetch exception, it is simply casted.

Parameters:

e - required exception to transform

Returns:

FetchException, never null

toPersistException

public PersistException toPersistException(java.lang.Throwable e)

Transforms the given throwable into an appropriate persist exception. If it already is a persist exception, it is simply casted.

Parameters:

e - required exception to transform

Returns:

PersistException, never null

toRepositoryException

public RepositoryException toRepositoryException(java.lang.Throwable e)

Transforms the given throwable into an appropriate repository exception. If it already is a repository exception, it is simply casted.

Parameters:

e - required exception to transform

Returns:

RepositoryException, never null

transformIntoFetchException

protected FetchException transformIntoFetchException(java.lang.Throwable e)

Override to support custom transformations, returning null if none is applicable. Be sure to call super first. If it returns non-null, return that result.

Parameters:

e - required exception to transform

Returns:

FetchException, or null if no applicable transform

transformIntoPersistException

protected PersistException transformIntoPersistException(java.lang.Throwable e)

Override to support custom transformations, returning null if none is applicable. Be sure to call super first. If it returns non-null, return that result.

Parameters:

e - required exception to transform

Returns:

PersistException, or null if no applicable transform

transformIntoRepositoryException

protected RepositoryException transformIntoRepositoryException(java.lang.Throwable e)

Override to support custom transformations, returning null if none is applicable. Be sure to call super first. If it returns non-null, return that result.

Parameters:

e - required exception to transform

Returns:

RepositoryException, or null if no applicable transform