org.mockito.internal.framework

Class DefaultMockitoSession

java.lang.Object

org.mockito.internal.framework.DefaultMockitoSession

All Implemented Interfaces:

MockitoSession

public class DefaultMockitoSession
extends Object
implements MockitoSession

Constructor Summary

Constructors

Constructor and Description
DefaultMockitoSession(List<Object> testClassInstances, String name, Strictness strictness, MockitoLogger logger)

Method Summary

Modifier and Type	Method and Description
void	finishMocking() Must be invoked when the user is done with mocking for given session (test method).
void	finishMocking(Throwable failure) Must be invoked when the user is done with mocking for given session (test method).
void	setStrictness(Strictness strictness) Changes the strictness of this MockitoSession.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultMockitoSession

public DefaultMockitoSession(List<Object> testClassInstances,
                             String name,
                             Strictness strictness,
                             MockitoLogger logger)

Method Detail

setStrictness

public void setStrictness(Strictness strictness)

Description copied from interface: MockitoSession

Changes the strictness of this MockitoSession. The new strictness will be applied to operations on mocks and checks performed by MockitoSession.finishMocking(). This method is used behind the hood by MockitoRule.strictness(Strictness) method. In most healthy tests, this method is not needed. We keep it for edge cases and when you really need to change strictness in given test method. For use cases see Javadoc for PotentialStubbingProblem class.

Specified by:

setStrictness in interface MockitoSession

Parameters:

strictness - new strictness for this session.

finishMocking

public void finishMocking()

Description copied from interface: MockitoSession

Must be invoked when the user is done with mocking for given session (test method). It detects unused stubbings and may throw UnnecessaryStubbingException or emit warnings (MockitoHint) depending on the Strictness level. The method also detects incorrect Mockito usage via Mockito.validateMockitoUsage().

In order to implement Strictness Mockito session keeps track of mocking using MockitoListener. This method cleans up the listeners and ensures there is no leftover state after the session finishes. It is necessary to invoke this method to conclude mocking session. For more information about session lifecycle see MockitoSessionBuilder.startMocking().

This method is intended to be used in your test framework's 'tear down' method. In the case of JUnit it is the "@After" method.

For example, see javadoc for MockitoSession.

Specified by:

finishMocking in interface MockitoSession

See Also:

MockitoSession.finishMocking(Throwable)

finishMocking

public void finishMocking(Throwable failure)

Description copied from interface: MockitoSession

Must be invoked when the user is done with mocking for given session (test method). When a failure is specified, certain checks are disabled to avoid confusion that may arise because there are multiple competing failures. Other than that, this method behaves exactly like MockitoSession.finishMocking().

This method is intended to be used by framework integrations. When using MockitoSession directly, most users should rather use MockitoSession.finishMocking(). MockitoRule uses this method behind the hood.

Specified by:

finishMocking in interface MockitoSession

Parameters:

failure - the exception that caused the test to fail; passing null is permitted

See Also:

MockitoSession.finishMocking()