de.apaxo.test

Class CachingSpy

java.lang.Object

de.apaxo.test.CachingSpy

All Implemented Interfaces:

org.mockito.stubbing.Answer<Object>

public class CachingSpy
extends Object
implements org.mockito.stubbing.Answer<Object>

This class can spy on an arbitrary Object and will intercept all given methods. It will search in the test directory for the given method return and return it. If it is not found the original call will be executed and cached in the test directory. With this method a unit test can be generated out of an integration test. The files will be placed directly at the root level of the executed folder. If you want to keep them you have to copy them into the src folder e.g. in a meven project: cp target/test-classes/*.dat src/test/resources

Author:

Manue Blechschmidt

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CachingSpy.FileNameConstructor This can be implemented by someone who wants to change how the files are named for a certain method.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addFileNameConstructor(Method method, CachingSpy.FileNameConstructor fileNameConstructor) This can be used to define an own file name constructor for naming files in case hashCode is implemented in a bad way.
Object	answer(org.mockito.invocation.InvocationOnMock invocation) Implement answer for caching spy.
static <T> T	cachingSpy(T object) This method intercepts all calls to object and returns if available a serialized object from the cache in the test directory.
static <T> T	cachingSpy(T object, Method[] methodsToCache) This method intercepts all calls to object and returns if available a serialized object from the cache in the test directory.
static <T extends K,K> K	cachingSpyForFinalClass(Class<K> clazz, T object) This function creates a decorator for an object that has a final class.
static <T extends K,K> K	cachingSpyForFinalClass(Class<K> clazz, T object, Method[] methodsToCache) This function creates a decorator for an object that has a final class.
static void	removeFileNameConstructor(Method method) This can be used to remove an own file name constructor for naming files in case hashCode is implemented in a bad way.

Methods inherited from class java.lang.Object

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

Method Detail

cachingSpy

public static <T> T cachingSpy(T object)

This method intercepts all calls to object and returns if available a serialized object from the cache in the test directory. If not available the normal flow is executed and the result is cached for further calls. All method calls including methods of super classes will be intercepted. All parameters and return values must be serializable.

Parameters:

object - the object to spy on

methods - list of methods which should be cached

Returns:

the object wrapped in a spy

cachingSpy

public static <T> T cachingSpy(T object,
               Method[] methodsToCache)

This method intercepts all calls to object and returns if available a serialized object from the cache in the test directory. If not available the normal flow is executed and the result is cached for further calls. All parameters and return values must be serializable. You can supply a list of methods that should be cached. If none is supplied all methods of the class including super classes will be intercepted.

Parameters:

object - the object to spy on

methodsToCache - list of methods which should be cached

Returns:

the object wrapped in a spy

cachingSpyForFinalClass

public static <T extends K,K> K cachingSpyForFinalClass(Class<K> clazz,
                                        T object)

This function creates a decorator for an object that has a final class.

Parameters:

clazz -

object -

Returns:

cachingSpyForFinalClass

public static <T extends K,K> K cachingSpyForFinalClass(Class<K> clazz,
                                        T object,
                                        Method[] methodsToCache)

This function creates a decorator for an object that has a final class.

Parameters:

clazz -

object -

Returns:

answer

public Object answer(org.mockito.invocation.InvocationOnMock invocation)
              throws Throwable

Implement answer for caching spy.

Specified by:

answer in interface org.mockito.stubbing.Answer<Object>

Parameters:

invocation - the invocation

Throws:

Throwable

addFileNameConstructor

public static void addFileNameConstructor(Method method,
                          CachingSpy.FileNameConstructor fileNameConstructor)

This can be used to define an own file name constructor for naming files in case hashCode is implemented in a bad way.

Parameters:

method -

fileNameConstructor -

removeFileNameConstructor

public static void removeFileNameConstructor(Method method)

This can be used to remove an own file name constructor for naming files in case hashCode is implemented in a bad way.

Parameters:

method -