org.mockito.internal.framework

Class DefaultMockitoFramework

java.lang.Object

org.mockito.internal.framework.DefaultMockitoFramework

All Implemented Interfaces:

MockitoFramework

public class DefaultMockitoFramework
extends Object
implements MockitoFramework

Constructor Summary

Constructors

Constructor and Description
DefaultMockitoFramework()

Method Summary

Modifier and Type	Method and Description
MockitoFramework	addListener(MockitoListener listener) Adds listener to Mockito.
InvocationFactory	getInvocationFactory() Returns a factory that can create instances of Invocation.
MockitoPlugins	getPlugins() Returns an object that has access to Mockito plugins.
MockitoFramework	removeListener(MockitoListener listener) When you add listener using MockitoFramework.addListener(MockitoListener) make sure to remove it.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultMockitoFramework

public DefaultMockitoFramework()

Method Detail

addListener

public MockitoFramework addListener(MockitoListener listener)

Description copied from interface: MockitoFramework

Adds listener to Mockito. For a list of supported listeners, see the interfaces that extend MockitoListener.

Listeners can be useful for engs that extend Mockito framework. They are used in the implementation of unused stubbings warnings (MockitoHint).

Make sure you remove the listener when the job is complete, see MockitoFramework.removeListener(MockitoListener). Currently the listeners list is thread local so you need to remove listener from the same thread otherwise remove is ineffectual. In typical scenarios, it is not a problem, because adding & removing listeners typically happens in the same thread.

If you are trying to add the listener but a listener of the same type was already added (and not removed) this method will throw RedundantListenerException. This is a safeguard to ensure users actually remove the listeners via MockitoFramework.removeListener(MockitoListener). We do not anticipate the use case where adding the same listener type multiple times is useful. If this safeguard is problematic, please contact us via Mockito issue tracker.

For usage examples, see Mockito codebase. If you have ideas and feature requests about Mockito listeners API we are very happy to hear about it via our issue tracker or mailing list.

   Mockito.framework().addListener(myListener);
 

Specified by:

addListener in interface MockitoFramework

Parameters:

listener - to add to Mockito

Returns:

this instance of mockito framework (fluent builder pattern)

removeListener

public MockitoFramework removeListener(MockitoListener listener)

Description copied from interface: MockitoFramework

When you add listener using MockitoFramework.addListener(MockitoListener) make sure to remove it. Currently the listeners list is thread local so you need to remove listener from the same thread otherwise remove is ineffectual. In typical scenarios, it is not a problem, because adding & removing listeners typically happens in the same thread.

For usage examples, see Mockito codebase. If you have ideas and feature requests about Mockito listeners API we are very happy to hear about it via our issue tracker or mailing list.

Specified by:

removeListener in interface MockitoFramework

Parameters:

listener - to remove

Returns:

this instance of mockito framework (fluent builder pattern)

getPlugins

public MockitoPlugins getPlugins()

Description copied from interface: MockitoFramework

Returns an object that has access to Mockito plugins. An example plugin is MockMaker. For information why and how to use this method see MockitoPlugins.

Specified by:

getPlugins in interface MockitoFramework

Returns:

object that gives access to mockito plugins

getInvocationFactory

public InvocationFactory getInvocationFactory()

Description copied from interface: MockitoFramework

Returns a factory that can create instances of Invocation. It is useful for framework integrations, because Invocation is NotExtensible.

Specified by:

getInvocationFactory in interface MockitoFramework

Returns:

object that can construct invocations