Package org.powermock.core
Class MockRepository
- java.lang.Object
-
- org.powermock.core.MockRepository
-
public class MockRepository extends Object
Hold mock objects that should be used instead of the concrete implementation. Mock transformers may use this class to gather information on which classes and methods that are mocked.
-
-
Constructor Summary
Constructors Constructor Description MockRepository()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static voidaddAfterMethodRunner(Runnable runnable)Add aRunnablethat will be executed after each teststatic voidaddConstructorToSuppress(Constructor<?> constructor)Add a constructor to suppress.static voidaddFieldToSuppress(Field field)Add a field to suppress.static voidaddFieldTypeToSuppress(String fieldType)Add a field type to suppress.static voidaddMethodToSuppress(Method method)Add a method to suppress.static voidaddObjectsToAutomaticallyReplayAndVerify(Object... objects)Add classes that should be automatically replayed or verified.static voidaddSuppressStaticInitializer(String className)Add a fully qualified class name for a class that should have its static initializers suppressed.static voidclear()Clear all state of the mock repository except for static initializers.static <T> TgetAdditionalState(String key)Retrieve state based on the supplied key.static MethodInvocationControlgetInstanceMethodInvocationControl(Object instance)static InvocationHandlergetMethodProxy(Method method)static ObjectgetMethodToStub(Method method)static NewInvocationControl<?>getNewInstanceControl(Class<?> type)static Set<Object>getObjectsToAutomaticallyReplayAndVerify()static MethodInvocationControlgetStaticMethodInvocationControl(Class<?> type)static booleanhasMethodProxy(Method method)static ObjectputAdditionalState(String key, Object value)When a mock framework API needs to store additional state not applicable for the other methods, it may use this method to do so.static MethodInvocationControlputInstanceMethodInvocationControl(Object instance, MethodInvocationControl invocationControl)static InvocationHandlerputMethodProxy(Method method, InvocationHandler invocationHandler)Set a proxy for a method.static ObjectputMethodToStub(Method method, Object value)Set a substitute return value for a method.static NewInvocationControl<?>putNewInstanceControl(Class<?> type, NewInvocationControl<?> control)static MethodInvocationControlputStaticMethodInvocationControl(Class<?> type, MethodInvocationControl invocationControl)static voidremove(Object mock)Removes an object from the MockRepository if it exists.static ObjectremoveAdditionalState(String key)static MethodInvocationControlremoveClassMethodInvocationControl(Class<?> type)static MethodInvocationControlremoveInstanceMethodInvocationControl(Class<?> type)static InvocationHandlerremoveMethodProxy(Method method)static voidremoveSuppressStaticInitializer(String className)Remove a fully qualified class name for a class that should no longer have its static initializers suppressed.static booleanshouldStubMethod(Method method)static booleanshouldSuppressConstructor(Constructor<?> constructor)static booleanshouldSuppressField(Field field)static booleanshouldSuppressMethod(Method method, Class<?> objectType)static booleanshouldSuppressStaticInitializerFor(String className)Check whether or not a class with the fully qualified name should have its static initializers suppressed.
-
-
-
Method Detail
-
clear
public static void clear()
Clear all state of the mock repository except for static initializers. The reason for not clearing static initializers is that when running in a suite with many tests the clear method is invoked after each test. This means that before the test that needs to suppress the static initializer has been reach the state of the MockRepository would have been wiped out. This is generally not a problem because most state will be added again but suppression of static initializers are different because this state can only be set once per class per CL. That's why we cannot remove this state.
-
remove
public static void remove(Object mock)
Removes an object from the MockRepository if it exists.
-
getStaticMethodInvocationControl
public static MethodInvocationControl getStaticMethodInvocationControl(Class<?> type)
-
putStaticMethodInvocationControl
public static MethodInvocationControl putStaticMethodInvocationControl(Class<?> type, MethodInvocationControl invocationControl)
-
removeClassMethodInvocationControl
public static MethodInvocationControl removeClassMethodInvocationControl(Class<?> type)
-
getInstanceMethodInvocationControl
public static MethodInvocationControl getInstanceMethodInvocationControl(Object instance)
-
putInstanceMethodInvocationControl
public static MethodInvocationControl putInstanceMethodInvocationControl(Object instance, MethodInvocationControl invocationControl)
-
removeInstanceMethodInvocationControl
public static MethodInvocationControl removeInstanceMethodInvocationControl(Class<?> type)
-
getNewInstanceControl
public static NewInvocationControl<?> getNewInstanceControl(Class<?> type)
-
putNewInstanceControl
public static NewInvocationControl<?> putNewInstanceControl(Class<?> type, NewInvocationControl<?> control)
-
addSuppressStaticInitializer
public static void addSuppressStaticInitializer(String className)
Add a fully qualified class name for a class that should have its static initializers suppressed.- Parameters:
className- The fully qualified class name for a class that should have its static initializers suppressed.
-
removeSuppressStaticInitializer
public static void removeSuppressStaticInitializer(String className)
Remove a fully qualified class name for a class that should no longer have its static initializers suppressed.- Parameters:
className- The fully qualified class name for a class that should no longer have its static initializers suppressed.
-
shouldSuppressStaticInitializerFor
public static boolean shouldSuppressStaticInitializerFor(String className)
Check whether or not a class with the fully qualified name should have its static initializers suppressed.- Parameters:
className-trueif class with the fully qualified nameclassNameshould have its static initializers suppressed,falseotherwise.
-
getObjectsToAutomaticallyReplayAndVerify
public static Set<Object> getObjectsToAutomaticallyReplayAndVerify()
- Returns:
- All classes that should be automatically replayed or verified.
-
addObjectsToAutomaticallyReplayAndVerify
public static void addObjectsToAutomaticallyReplayAndVerify(Object... objects)
Add classes that should be automatically replayed or verified.
-
putAdditionalState
public static Object putAdditionalState(String key, Object value)
When a mock framework API needs to store additional state not applicable for the other methods, it may use this method to do so.- Parameters:
key- The key under which the value is stored.value- The value to store under the specified key.- Returns:
- The previous object under the specified key or
null.
-
removeMethodProxy
public static InvocationHandler removeMethodProxy(Method method)
-
getAdditionalState
public static <T> T getAdditionalState(String key)
Retrieve state based on the supplied key.
-
addMethodToSuppress
public static void addMethodToSuppress(Method method)
Add a method to suppress.- Parameters:
method- The method to suppress.
-
addFieldToSuppress
public static void addFieldToSuppress(Field field)
Add a field to suppress.- Parameters:
field- The field to suppress.
-
addFieldTypeToSuppress
public static void addFieldTypeToSuppress(String fieldType)
Add a field type to suppress. All fields of this type will be suppressed.- Parameters:
fieldType- The fully-qualified name to a type. All fields of this type will be suppressed.
-
addConstructorToSuppress
public static void addConstructorToSuppress(Constructor<?> constructor)
Add a constructor to suppress.- Parameters:
constructor- The constructor to suppress.
-
hasMethodProxy
public static boolean hasMethodProxy(Method method)
- Returns:
trueif the method should be proxied.
-
shouldSuppressMethod
public static boolean shouldSuppressMethod(Method method, Class<?> objectType) throws ClassNotFoundException
- Returns:
trueif the method should be suppressed.- Throws:
ClassNotFoundException
-
shouldSuppressField
public static boolean shouldSuppressField(Field field)
- Returns:
trueif the field should be suppressed.
-
shouldSuppressConstructor
public static boolean shouldSuppressConstructor(Constructor<?> constructor)
- Returns:
trueif the constructor should be suppressed.
-
shouldStubMethod
public static boolean shouldStubMethod(Method method)
- Returns:
trueif the method has a substitute return value.
-
getMethodToStub
public static Object getMethodToStub(Method method)
- Returns:
- The substitute return value for a particular method, may be
null.
-
putMethodToStub
public static Object putMethodToStub(Method method, Object value)
Set a substitute return value for a method. Whenever this method will be called thevaluewill be returned instead.- Returns:
- The previous substitute value if any.
-
getMethodProxy
public static InvocationHandler getMethodProxy(Method method)
- Returns:
- The proxy for a particular method, may be
null.
-
putMethodProxy
public static InvocationHandler putMethodProxy(Method method, InvocationHandler invocationHandler)
Set a proxy for a method. Whenever this method is called the invocation handler will be invoked instead.- Returns:
- The method proxy if any.
-
-