net.sf.kdgcommons.test

Class ExceptionMock

java.lang.Object

net.sf.kdgcommons.test.ExceptionMock

All Implemented Interfaces:

InvocationHandler

public class ExceptionMock
extends Object
implements InvocationHandler

Instances of this class act as factories for stub objects that always throw. It can be used in one of two ways: throwing an explicit exception instance, or creating a new exception of a given class. The latter is useful when you just need to verify that an exception was thrown, the former when you need to verify that a certain path threw (use assertSame()).

To use, construct around the desired exception, and call getInstance(java.lang.Class<T>) to create the stub. Since this class does not maintain any state (other than the configured exception), you can create many stubs from a single mock.

Constructor Summary

Constructors

Constructor and Description
ExceptionMock(Class<? extends Throwable> klass) Creates a factory for stub objects that will throw new instances of the specified exception class.
ExceptionMock(Throwable ex) Creates a factory for stub objects that will always throw a specific exception.

Method Summary

Modifier and Type	Method and Description
<T> T	getInstance(Class<T> classToMock)
Object	invoke(Object proxy, Method method, Object[] args)

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionMock

public ExceptionMock(Throwable ex)

Creates a factory for stub objects that will always throw a specific exception.

ExceptionMock

public ExceptionMock(Class<? extends Throwable> klass)

Creates a factory for stub objects that will throw new instances of the specified exception class.

Note: instances are created by reflection. If unable to create an exception instance (typically due to protection/missing class), will throw a reflection exception instead (and this will potentially be captured by the proxy and wrapped in a proxy exception).

Method Detail

getInstance

public <T> T getInstance(Class<T> classToMock)

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

Specified by:

invoke in interface InvocationHandler

Throws:

Throwable