org.opendaylight.yangtools.util.concurrent

Class ExceptionMapper<X extends Exception>

java.lang.Object

org.opendaylight.yangtools.util.concurrent.ExceptionMapper<X>

Type Parameters:

X - the exception type

All Implemented Interfaces:

com.google.common.base.Function<Exception,X>

Direct Known Subclasses:

ReflectiveExceptionMapper

public abstract class ExceptionMapper<X extends Exception>
extends Object
implements com.google.common.base.Function<Exception,X>

Utility exception mapper which translates an Exception to a specified type of Exception. This mapper is intended to be used with Futures.makeChecked(com.google.common.util.concurrent.ListenableFuture, Function)

• if exception is the specified type or one of its subclasses, it returns original exception.
• if exception is ExecutionException and the cause is of the specified type, it returns the cause
• otherwise returns an instance of the specified exception type with original exception as the cause.

Author:

Thomas Pantelis

Constructor Summary

Constructors

Constructor and Description
ExceptionMapper(String opName, Class<X> exceptionType) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
X	apply(Exception e)
protected Class<X>	getExceptionType() Return the exception class produced by this instance.
protected abstract X	newWithCause(String message, Throwable cause) Invoked to create a new exception instance of the specified type.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.common.base.Function

equals

Constructor Detail

ExceptionMapper

public ExceptionMapper(String opName,
               Class<X> exceptionType)

Constructor.

Parameters:

opName - the String prefix for exception messages.

exceptionType - the exception type to which to translate.

Method Detail

getExceptionType

protected final Class<X> getExceptionType()

Return the exception class produced by this instance.

Returns:

Exception class.

newWithCause

protected abstract X newWithCause(String message,
             Throwable cause)

Invoked to create a new exception instance of the specified type.

Parameters:

message - the message for the new exception.

cause - the cause for the new exception.

Returns:

an instance of the exception type.

apply

public X apply(Exception e)

Specified by:

apply in interface com.google.common.base.Function<Exception,X extends Exception>