org.mockito.MockitoFramework Maven / Gradle / Ivy
Show all versions of mockito-core Show documentation
/*
* Copyright (c) 2016 Mockito contributors
* This program is made available under the terms of the MIT License.
*/
package org.mockito;
import org.mockito.listeners.MockitoListener;
/**
* Mockito framework settings and lifecycle listeners, for advanced users or for integrating with other frameworks.
*
* To get MockitoFramework instance use {@link Mockito#framework()}.
*
* For more info on listeners see {@link #addListener(MockitoListener)}.
*
* @since 2.1.0
*/
@Incubating
public interface MockitoFramework {
/**
* Adds listener to Mockito.
* For a list of supported listeners, see the interfaces that extend {@link MockitoListener}.
*
* Listeners can be useful for engs that extend Mockito framework.
* They are used in the implementation of unused stubbings warnings ({@link org.mockito.quality.MockitoHint}).
*
* Make sure you remove the listener when the job is complete, see {@link #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.
*
* 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);
*
*
* @param listener to add
* @since 2.1.0
*/
@Incubating
MockitoFramework addListener(MockitoListener listener);
/**
* When you add listener using {@link #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.
*
* @param listener to remove
* @since 2.1.0
*/
@Incubating
MockitoFramework removeListener(MockitoListener listener);
}