Class DefaultMockitoSessionBuilder
- All Implemented Interfaces:
MockitoSessionBuilder
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAdds the test class instance for initialization of fields annotated with Mockito annotations likeMock
.Adds the test class instances for initialization of fields annotated with Mockito annotations likeMock
.logger
(MockitoSessionLogger logger) Configures logger used byMockitoSession
for emitting warnings when finishing the session.Configures the name of theMockitoSession
instance.Starts new mocking session! Creates newMockitoSession
instance to initialize the session.strictness
(Strictness strictness) Configures strictness ofMockitoSession
instance.
-
Constructor Details
-
DefaultMockitoSessionBuilder
public DefaultMockitoSessionBuilder()
-
-
Method Details
-
initMocks
Description copied from interface:MockitoSessionBuilder
Adds the test class instance for initialization of fields annotated with Mockito annotations likeMock
. When this method is invoked it does not perform initialization of mocks on the spot! Only whenMockitoSessionBuilder.startMocking()
is invoked then annotated fields will be initialized. Traditional API to initialize mocks, theMockitoAnnotations.openMocks(Object)
method has limited support for driving cleaner tests because it does not support configuringStrictness
. Want cleaner tests and better productivity? Migrate fromMockitoAnnotations.openMocks(Object)
toMockitoSession
!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 interfaceMockitoSessionBuilder
- Parameters:
testClassInstance
- test class instance that contains fields with Mockito annotations to be initialized. Passingnull
is permitted but will be ignored.- Returns:
- the same builder instance for fluent configuration of
MockitoSession
.
-
initMocks
Description copied from interface:MockitoSessionBuilder
Adds the test class instances for initialization of fields annotated with Mockito annotations likeMock
.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 interfaceMockitoSessionBuilder
- Parameters:
testClassInstances
- test class instances that contains fields with Mockito annotations to be initialized. Passingnull
or an empty array is permitted but will be ignored.- Returns:
- the same builder instance for fluent configuration of
MockitoSession
. - See Also:
-
name
Description copied from interface:MockitoSessionBuilder
Configures the name of theMockitoSession
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 interfaceMockitoSessionBuilder
- Parameters:
name
- ofMockitoSession
instance. Passingnull
is permitted and will make the session use a default value. The current default is the name of the last test class instance passed toMockitoSessionBuilder.initMocks(Object)
orMockitoSessionBuilder.initMocks(Object...)
, if available; otherwise,"<Unnamed Session>"
is used.- Returns:
- the same builder instance for fluent configuration of
MockitoSession
. - See Also:
-
strictness
Description copied from interface:MockitoSessionBuilder
Configures strictness ofMockitoSession
instance. See examples inMockitoSession
.- Specified by:
strictness
in interfaceMockitoSessionBuilder
- Parameters:
strictness
- forMockitoSession
instance. Passingnull
is permitted and will make the session use a default value. The current default isStrictness.STRICT_STUBS
.- Returns:
- the same builder instance for fluent configuration of
MockitoSession
.
-
logger
Description copied from interface:MockitoSessionBuilder
Configures logger used byMockitoSession
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 interfaceMockitoSessionBuilder
- Parameters:
logger
- for warnings emitted when finishingMockitoSession
. Passingnull
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:
-
startMocking
Description copied from interface:MockitoSessionBuilder
Starts new mocking session! Creates newMockitoSession
instance to initialize the session. At this point annotated fields are initialized perMockitoSessionBuilder.initMocks(Object)
method. When you are done with the session it is required to invokeMockitoSession.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 sessionUnfinishedMockingSessionException
will be triggered.See examples in
MockitoSession
.- Specified by:
startMocking
in interfaceMockitoSessionBuilder
- Returns:
- new
MockitoSession
instance
-