Deprecated API

Contents

• Packages
• Interfaces
• Classes
• Exceptions
• Errors
• Methods

Deprecated Packages

Package	Description
org.mockito.runners

Deprecated Interfaces

Interface	Description
org.mockito.configuration.AnnotationEngine	Please use AnnotationEngine instead, this interface will probably be removed in mockito 4.
org.mockito.internal.creation.instance.Instantiator	since 2.15.4 because this internal class was leaking from the public API. For more information why deprecated, see InstantiatorProvider2. Use Instantiator instead. Provides instances of classes.
org.mockito.internal.InternalMockHandler
org.mockito.MockitoDebugger	- please use MockingDetails.printInvocations() instead. An instance of MockingDetails can be retrieved via Mockito.mockingDetails(Object).
org.mockito.plugins.InstantiatorProvider	since 2.15.4 because this internal class was leaking from the public API. For more information why deprecated, see InstantiatorProvider2 and Issue 1303 Mockito will invoke this interface in order to fetch an instance instantiator provider. By default, an internal byte-buddy/asm/objenesis based implementation is used. Using the extension point The plugin mechanism of mockito works in a similar way as the ServiceLoader, however instead of looking in the META-INF directory, Mockito will look in mockito-extensions directory. The reason for that is that Android SDK strips jar from the META-INF directory when creating an APK. The implementation itself, for example org.awesome.mockito.AwesomeInstantiatorProvider that implements the InstantiatorProvider. A file "mockito-extensions/org.mockito.plugins.InstantiatorProvider". The content of this file is exactly a one line with the qualified name: org.awesome.mockito.AwesomeInstantiatorProvider. Note that if several mockito-extensions/org.mockito.plugins.InstantiatorProvider files exists in the classpath, Mockito will only use the first returned by the standard ClassLoader.getResource(java.lang.String) mechanism. So just create a custom implementation of InstantiatorProvider and place the qualified name in the following file mockito-extensions/org.mockito.plugins.InstantiatorProvider. This class is deprecated and was replaced by InstantiatorProvider2. Hence if there is both a mockito-extensions/org.mockito.plugins.InstantiatorProvider and mockito-extensions/org.mockito.plugins.InstantiatorProvider2 the second one takes preference.

Deprecated Classes

Class	Description
org.mockito.internal.debugging.WarningsCollector
org.mockito.internal.invocation.UnusedStubsFinder
org.mockito.internal.junit.util.JUnitFailureHacker
org.mockito.Matchers	Use ArgumentMatchers. This class is now deprecated in order to avoid a name clash with Hamcrest org.hamcrest.Matchers class. This class will likely be removed in version 4.0.
org.mockito.runners.ConsoleSpammingMockitoJUnitRunner	as of 2.1.0. Use the MockitoJUnitRunner runner instead which contains support for detecting unused stubs. If you still prefer using this runner, tell us why (create ticket in our issue tracker).
org.mockito.runners.MockitoJUnitRunner	Moved to MockitoJUnitRunner, this class will be removed with Mockito 4
org.mockito.runners.MockitoJUnitRunner.Silent	Moved to MockitoJUnitRunner.Silent, this class will be removed with Mockito 4
org.mockito.runners.MockitoJUnitRunner.Strict	Moved to MockitoJUnitRunner.Strict, this class will be removed with Mockito 4
org.mockito.runners.VerboseMockitoJUnitRunner	as of 2.1.0. Use the MockitoJUnitRunner runner instead which contains support for detecting unused stubs. If you still prefer using this runner, tell us why (create ticket in our issue tracker).

Deprecated Exceptions

Exceptions	Description
org.mockito.internal.creation.instance.InstantiationException	since 2.15.4 because this internal class was leaking from the public API. For information why deprecated, see InstantiatorProvider2. Use Instantiator and InstantiationException types instead. Exception generated when Instantiator.newInstance(Class) failed.

Deprecated Errors

Errors	Description
org.mockito.exceptions.verification.TooLittleActualInvocations	as of 2.27.5. Please use TooFewActualInvocations instead.

Deprecated Methods

Method	Description
org.mockito.Answers.get()	as of 2.1.0 Use the enum-constant directly, instead of this getter. This method will be removed in a future release E.g. instead of Answers.CALLS_REAL_METHODS.get() use Answers.CALLS_REAL_METHODS .
org.mockito.ArgumentMatchers.anyCollectionOf(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anyIterableOf(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anyListOf(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anyMapOf(Class<K>, Class<V>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anyObject()	This will be removed in Mockito 4.0 This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anySetOf(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.anyVararg()	as of 2.1.0 use ArgumentMatchers.any()
org.mockito.ArgumentMatchers.isNotNull(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.isNull(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.ArgumentMatchers.notNull(Class<T>)	With Java 8 this method will be removed in Mockito 4.0. This method is only used for generic friendliness to avoid casting, this is not anymore needed in Java 8.
org.mockito.BDDMockito.BDDStubber.willNothing()	as of 2.1.0 please use BDDMockito.BDDStubber.willDoNothing() instead
org.mockito.BDDMockito.BDDStubberImpl.willNothing()	please use BDDMockito.BDDStubberImpl.willDoNothing() instead
org.mockito.BDDMockito.Then.shouldHaveZeroInteractions()	Since 3.0.1. Please migrate your code to BDDMockito.Then.shouldHaveNoInteractions()
org.mockito.configuration.IMockitoConfiguration.getAnnotationEngine()	Please use the extension mechanism AnnotationEngine instead, this method will probably be removed in mockito 4.
org.mockito.internal.configuration.InjectingAnnotationEngine.injectMocks(Object)	Use InjectingAnnotationEngine.injectCloseableMocks(Object).
org.mockito.internal.debugging.MockitoDebuggerImpl.printInvocations(Object...)
org.mockito.internal.invocation.InterceptedInvocation.getMockitoMethod()	Not used by Mockito but by mockito-scala
org.mockito.internal.invocation.InterceptedInvocation.getMockRef()	Not used by Mockito but by mockito-scala
org.mockito.internal.invocation.InterceptedInvocation.getRealMethod()	Not used by Mockito but by mockito-scala
org.mockito.internal.verification.api.VerificationData.getWanted()	- This internal method leaks internal class InvocationMatcher. Please use VerificationData.getTarget() instead. Deprecated since 2.2.12
org.mockito.invocation.InvocationFactory.createInvocation(Object, MockCreationSettings, Method, Callable, Object...)	Use InvocationFactory.createInvocation(Object, MockCreationSettings, Method, RealMethodBehavior, Object...) instead. Why deprecated? We found use cases where we need to handle Throwable and ensure correct stack trace filtering (removing Mockito internals from the stack trace). Hence the introduction of InvocationFactory.RealMethodBehavior. Creates instance of an Invocation object. This method is useful for framework integrators to programmatically simulate method calls on mocks using MockHandler. It enables advanced framework integrations.
org.mockito.MockedStatic.verify(VerificationMode, MockedStatic.Verification)	Please use instead
org.mockito.Mockito.debug()	- please use MockingDetails.printInvocations() instead. An instance of MockingDetails can be retrieved via Mockito.mockingDetails(Object).
org.mockito.Mockito.verifyZeroInteractions(Object...)	Since 3.0.1. Please migrate your code to Mockito.verifyNoInteractions(Object...)
org.mockito.MockitoAnnotations.initMocks(Object)	Use MockitoAnnotations.openMocks(Object) instead. This method is equivalent to openMocks(testClass).close(). The close method should however only be called after completed usage of testClass. If using static-mocks or custom MockMakers, using this method might cause misbehavior of mocks injected into the test class.
org.mockito.MockitoDebugger.printInvocations(Object...)	- please use MockingDetails.printInvocations() instead. An instance of MockingDetails can be retrieved via Mockito.mockingDetails(Object).
org.mockito.plugins.InstantiatorProvider.getInstantiator(MockCreationSettings<?>)	, see InstantiatorProvider. Returns an instantiator, used to create new class instances.
org.mockito.runners.MockitoJUnitRunner.filter(Filter)
org.mockito.runners.MockitoJUnitRunner.getDescription()
org.mockito.runners.MockitoJUnitRunner.run(RunNotifier)