com.googlecode.catchexception.throwable.internal

Class AbstractThrowableProcessingInvocationHandler<E extends Throwable>

java.lang.Object

com.googlecode.catchexception.throwable.internal.AbstractThrowableProcessingInvocationHandler<E>

Type Parameters:

E - The type of the throwable that is caught and ,optionally, verified.

Direct Known Subclasses:

ThrowableProcessingInterceptor

 class AbstractThrowableProcessingInvocationHandler<E extends Throwable>
extends Object

This abstract method invocation interceptor

• delegates all method calls to the 'underlying object',
• catches throwables of a given type, and
• (optionally) asserts that an throwable of a specific type is thrown.

Since:

16.09.2011

Author:

rwoo

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	assertThrowable See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .
protected Class<E>	clazz See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .
protected Object	target See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .

Constructor Summary

Constructors

Constructor and Description
AbstractThrowableProcessingInvocationHandler(Object target, Class<E> clazz, boolean assertThrowable)

Method Summary

Methods

Modifier and Type	Method and Description
protected Object	afterInvocation(Object retval) Must be called by the subclass after the method invocation that has not thrown a throwable.
protected Object	afterInvocationThrowsThrowable(Throwable e, Method method) Must be called by the subclass after the intercepted method invocation that has thrown a throwable.
protected void	beforeInvocation() Must be called by the subclass before the intercepted method invocation.
(package private) Object	safeReturnValue(Class<?> type)

Methods inherited from class java.lang.Object

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

Field Detail

clazz

protected Class<E extends Throwable> clazz

See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .

target

protected Object target

See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .

assertThrowable

protected boolean assertThrowable

See AbstractThrowableProcessingInvocationHandler(Object, Class, boolean) .

Constructor Detail

AbstractThrowableProcessingInvocationHandler

public AbstractThrowableProcessingInvocationHandler(Object target,
                                            Class<E> clazz,
                                            boolean assertThrowable)

Parameters:

target - The object all method calls are delegated to. Must not be null.

clazz - the type of the throwable that is to catch. Must not be null.

assertThrowable - True if the interceptor shall throw an ThrowableNotThrownAssertionError if the method has not thrown an throwable of the expected type.

Method Detail

beforeInvocation

protected void beforeInvocation()

Must be called by the subclass before the intercepted method invocation.

afterInvocation

protected Object afterInvocation(Object retval)
                          throws Error

Must be called by the subclass after the method invocation that has not thrown a throwable.

Parameters:

retval - The value returned by the intercepted method invocation.

Returns:

The value that shall be returned by the proxy.

Throws:

Error - (optionally) Thrown if the verification failed.

afterInvocationThrowsThrowable

protected Object afterInvocationThrowsThrowable(Throwable e,
                                    Method method)
                                         throws Error,
                                                Throwable

Must be called by the subclass after the intercepted method invocation that has thrown a throwable.

Parameters:

e - the throwable thrown by the intercepted method invocation.

method - the method that was proxied

Returns:

Always returns null.

Throws:

Error - Thrown if the verification failed.

Throwable - The given throwable. (Re-)thrown if the thrown throwable shall not be caught and verification is not required.

safeReturnValue

Object safeReturnValue(Class<?> type)

Parameters:

type - a type

Returns:

Returns a value of the given type