Package org.mockito.internal.session

Class DefaultMockitoSessionBuilder

java.lang.Object

org.mockito.internal.session.DefaultMockitoSessionBuilder

All Implemented Interfaces:

MockitoSessionBuilder

public class DefaultMockitoSessionBuilder
extends java.lang.Object
implements MockitoSessionBuilder

Field Summary

Fields

Modifier and Type	Field	Description
private MockitoSessionLogger	logger
private java.lang.String	name
private Strictness	strictness
private java.util.List<java.lang.Object>	testClassInstances

Constructor Summary

Constructors

Constructor	Description
DefaultMockitoSessionBuilder()

Method Summary

Modifier and Type	Method	Description
MockitoSessionBuilder	initMocks(java.lang.Object testClassInstance)	Adds the test class instance for initialization of fields annotated with Mockito annotations like Mock.
MockitoSessionBuilder	initMocks(java.lang.Object... testClassInstances)	Adds the test class instances for initialization of fields annotated with Mockito annotations like Mock.
MockitoSessionBuilder	logger(MockitoSessionLogger logger)	Configures logger used by MockitoSession for emitting warnings when finishing the session.
MockitoSessionBuilder	name(java.lang.String name)	Configures the name of the MockitoSession instance.
MockitoSession	startMocking()	Starts new mocking session! Creates new MockitoSession instance to initialize the session.
MockitoSessionBuilder	strictness(Strictness strictness)	Configures strictness of MockitoSession instance.

Methods inherited from class java.lang.Object

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

Field Detail

testClassInstances

private final java.util.List<java.lang.Object> testClassInstances

name

private java.lang.String name

strictness

private Strictness strictness

logger

private MockitoSessionLogger logger

Constructor Detail

DefaultMockitoSessionBuilder

public DefaultMockitoSessionBuilder()

Method Detail

initMocks

public MockitoSessionBuilder initMocks(java.lang.Object testClassInstance)

Description copied from interface: MockitoSessionBuilder

Adds the test class instance for initialization of fields annotated with Mockito annotations like Mock. When this method is invoked it does not perform initialization of mocks on the spot! Only when MockitoSessionBuilder.startMocking() is invoked then annotated fields will be initialized. Traditional API to initialize mocks, the MockitoAnnotations.openMocks(Object) method has limited support for driving cleaner tests because it does not support configuring Strictness. Want cleaner tests and better productivity? Migrate from MockitoAnnotations.openMocks(Object) to MockitoSession!

This method may be called multiple times to add multiple, e.g. nested, test class instances.

See code sample in MockitoSession.

Specified by:

initMocks in interface MockitoSessionBuilder

Parameters:

testClassInstance - test class instance that contains fields with Mockito annotations to be initialized. Passing null is permitted but will be ignored.

Returns:

the same builder instance for fluent configuration of MockitoSession.

initMocks

public MockitoSessionBuilder initMocks(java.lang.Object... testClassInstances)

Description copied from interface: MockitoSessionBuilder

Adds the test class instances for initialization of fields annotated with Mockito annotations like Mock.

In most scenarios, you only need to init mocks on a single test class instance. This method is useful for advanced framework integrations (like JUnit Jupiter), when a test uses multiple, e.g. nested, test class instances.

This method calls MockitoSessionBuilder.initMocks(Object) for each passed test class instance.

Specified by:

initMocks in interface MockitoSessionBuilder

Parameters:

testClassInstances - test class instances that contains fields with Mockito annotations to be initialized. Passing null or an empty array is permitted but will be ignored.

Returns:

the same builder instance for fluent configuration of MockitoSession.

See Also:

MockitoSessionBuilder.initMocks(Object)

name

public MockitoSessionBuilder name(java.lang.String name)

Description copied from interface: MockitoSessionBuilder

Configures the name of the MockitoSession instance.

The name is used to output hints when finishing a session.

This method is intended to be used by framework integrations, e.g. JUnit. When building a MockitoSession for direct use, users are not expected to call it.

Specified by:

name in interface MockitoSessionBuilder

Parameters:

name - of MockitoSession instance. Passing null is permitted and will make the session use a default value. The current default is the name of the last test class instance passed to MockitoSessionBuilder.initMocks(Object) or MockitoSessionBuilder.initMocks(Object...), if available; otherwise, "<Unnamed Session>" is used.

Returns:

the same builder instance for fluent configuration of MockitoSession.

See Also:

MockitoHint

strictness

public MockitoSessionBuilder strictness(Strictness strictness)

Description copied from interface: MockitoSessionBuilder

Configures strictness of MockitoSession instance. See examples in MockitoSession.

Specified by:

strictness in interface MockitoSessionBuilder

Parameters:

strictness - for MockitoSession instance. Passing null is permitted and will make the session use a default value. The current default is Strictness.STRICT_STUBS.

Returns:

the same builder instance for fluent configuration of MockitoSession.

logger

public MockitoSessionBuilder logger(MockitoSessionLogger logger)

Description copied from interface: MockitoSessionBuilder

Configures logger used by MockitoSession for emitting warnings when finishing the session.

Please note that the use of strict stubs is recommended over emitting warnings because warnings are easily ignored and spoil the log output. Instead of using this method, please consider setting strictness with MockitoSessionBuilder.strictness(Strictness).

Specified by:

logger in interface MockitoSessionBuilder

Parameters:

logger - for warnings emitted when finishing MockitoSession. Passing null is permitted and will make the session use a default value. By default, warnings will be logged to the console.

Returns:

the same builder instance for fluent configuration of MockitoSession.

See Also:

MockitoHint

startMocking

public MockitoSession startMocking()

Description copied from interface: MockitoSessionBuilder

Starts new mocking session! Creates new MockitoSession instance to initialize the session. At this point annotated fields are initialized per MockitoSessionBuilder.initMocks(Object) method. When you are done with the session it is required to invoke MockitoSession.finishMocking(). This will trigger stubbing validation, cleaning up the internal state like removal of internal listeners.

Mockito tracks created sessions internally and prevents the user from creating new sessions without using MockitoSession.finishMocking(). When you run tests concurrently in multiple threads, it is legal for each thread to have single active Mockito session. When you attempt to start new session in a thread that already has an unfinished session UnfinishedMockingSessionException will be triggered.

See examples in MockitoSession.

Specified by:

startMocking in interface MockitoSessionBuilder

Returns:

new MockitoSession instance