com.googlecode.catchexception.internal

Class AbstractExceptionProcessingInvocationHandler<E extends Exception>

java.lang.Object

com.googlecode.catchexception.internal.AbstractExceptionProcessingInvocationHandler<E>

Type Parameters:

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

Direct Known Subclasses:

ExceptionProcessingInterceptor

 class AbstractExceptionProcessingInvocationHandler<E extends Exception>
extends Object

This abstract method invocation interceptor

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

Since:

16.09.2011

Author:

rwoo

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
AbstractExceptionProcessingInvocationHandler(Object target, Class<E> clazz, boolean assertException)

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 exception.
protected Object	afterInvocationThrowsException(Exception e, Method method) Must be called by the subclass after the intercepted method invocation that has thrown a exception.
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 Exception> clazz

See AbstractExceptionProcessingInvocationHandler(Object, Class, boolean) .

target

protected Object target

See AbstractExceptionProcessingInvocationHandler(Object, Class, boolean) .

assertException

protected boolean assertException

See AbstractExceptionProcessingInvocationHandler(Object, Class, boolean) .

Constructor Detail

AbstractExceptionProcessingInvocationHandler

public AbstractExceptionProcessingInvocationHandler(Object target,
                                            Class<E> clazz,
                                            boolean assertException)

Parameters:

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

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

assertException - True if the interceptor shall throw an ExceptionNotThrownAssertionError if the method has not thrown an exception 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 exception.

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.

afterInvocationThrowsException

protected Object afterInvocationThrowsException(Exception e,
                                    Method method)
                                         throws Error,
                                                Exception

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

Parameters:

e - the exception thrown by the intercepted method invocation.

method - the method that was proxied

Returns:

Always returns null.

Throws:

Error - Thrown if the verification failed.

Exception - The given exception. (Re-)thrown if the thrown exception 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