org.mockito.exceptions

Class Reporter

java.lang.Object

org.mockito.exceptions.Reporter

public class Reporter
extends Object

Reports verification and misusing errors.

One of the key points of mocking library is proper verification/exception messages. All messages in one place makes it easier to tune and amend them.

Reporter can be injected and therefore is easily testable.

Generally, exception messages are full of line breaks to make them easy to read (xunit plugins take only fraction of screen on modern IDEs).

Method Summary

Methods

Modifier and Type	Method and Description
static AssertionError	argumentsAreDifferent(String wanted, String actual, Location actualLocation)
static MockitoException	atMostAndNeverShouldNotBeUsedWithTimeout()
static MockitoException	cannotCallAbstractRealMethod()
static MockitoException	cannotCreateTimerWithNegativeDurationTime(long durationMillis)
static MockitoException	cannotInitializeForInjectMocksAnnotation(String fieldName, Exception details)
static MockitoException	cannotInitializeForSpyAnnotation(String fieldName, Exception details)
static MockitoException	cannotInjectDependency(Field field, Object matchingMock, Exception details)
static MockitoException	cannotMockClass(Class<?> clazz, String reason)
static MockitoException	cannotStubVoidMethodWithAReturnValue(String methodName)
static MockitoException	cannotStubWithNullThrowable()
static MockitoException	cannotVerifyToString()
static MockitoException	checkedExceptionInvalid(Throwable t)
static MockitoException	defaultAnswerDoesNotAcceptNullParameter()
static MockitoException	delegatedMethodDoesNotExistOnDelegate(Method mockMethod, Object mock, Object delegate)
static MockitoException	delegatedMethodHasWrongReturnType(Method mockMethod, Method delegateMethod, Object mock, Object delegate)
static MockitoException	extraInterfacesAcceptsOnlyInterfaces(Class<?> wrongType)
static MockitoException	extraInterfacesCannotContainMockedType(Class<?> wrongType)
static MockitoException	extraInterfacesDoesNotAcceptNullParameters()
static MockitoException	extraInterfacesRequiresAtLeastOneInterface()
static MockitoException	fieldInitialisationThrewException(Field field, Throwable details)
static MockitoException	incorrectUseOfAdditionalMatchers(String additionalMatcherName, int expectedSubMatchersCount, Collection<LocalizedMatcher> matcherStack)
static MockitoException	incorrectUseOfApi()
static MockitoException	inOrderRequiresFamiliarMock()
static MockitoException	invalidArgumentPositionRangeAtInvocationTime(InvocationOnMock invocation, boolean willReturnLastParameter, int argumentIndex)
static MockitoException	invalidArgumentRangeAtIdentityAnswerCreationTime()
static MockitoException	invalidUseOfMatchers(int expectedMatchersCount, List<LocalizedMatcher> recordedMatchers)
static MockitoException	invocationListenerDoesNotAcceptNullParameters()
static MockitoException	invocationListenersRequiresAtLeastOneListener()
static MockitoException	invocationListenerThrewException(InvocationListener listener, Throwable listenerThrowable)
static MockitoException	misplacedArgumentMatcher(List<LocalizedMatcher> lastMatchers)
static MockitoException	missingMethodInvocation()
static MockitoException	mockedTypeIsInconsistentWithDelegatedInstanceType(Class mockedType, Object delegatedInstance)
static MockitoException	mockedTypeIsInconsistentWithSpiedInstanceType(Class<?> mockedType, Object spiedInstance)
static MockitoException	mocksHaveToBePassedToVerifyNoMoreInteractions()
static MockitoException	mocksHaveToBePassedWhenCreatingInOrder()
static MockitoException	moreThanOneAnnotationNotAllowed(String fieldName)
static MockitoAssertionError	neverWantedButInvoked(DescribedInvocation wanted, Location firstUndesired)
static MockitoException	noArgumentValueWasCaptured()
static MockitoAssertionError	noMoreInteractionsWanted(Invocation undesired, List<VerificationAwareInvocation> invocations)
static MockitoAssertionError	noMoreInteractionsWantedInOrder(Invocation undesired)
static MockitoException	notAMockPassedToVerify(Class type)
static MockitoException	notAMockPassedToVerifyNoMoreInteractions()
static MockitoException	notAMockPassedToWhenMethod()
static MockitoException	notAMockPassedWhenCreatingInOrder()
static MockitoException	notAnException()
static MockitoException	nullPassedToVerify()
static MockitoException	nullPassedToVerifyNoMoreInteractions()
static MockitoException	nullPassedToWhenMethod()
static MockitoException	nullPassedWhenCreatingInOrder()
static MockitoException	onlyVoidMethodsCanBeSetToDoNothing()
static MockitoException	reportNoSubMatchersFound(String additionalMatcherName)
static MockitoException	serializableWontWorkForObjectsThatDontImplementSerializable(Class classToMock)
static MockitoException	smartNullPointerException(String invocation, Location location)
static MockitoException	spyAndDelegateAreMutuallyExclusive()
static MockitoException	stubPassedToVerify()
static MockitoAssertionError	tooLittleActualInvocations(Discrepancy discrepancy, DescribedInvocation wanted, Location lastActualLocation)
static MockitoAssertionError	tooLittleActualInvocationsInOrder(Discrepancy discrepancy, DescribedInvocation wanted, Location lastActualLocation)
static MockitoAssertionError	tooManyActualInvocations(int wantedCount, int actualCount, DescribedInvocation wanted, Location firstUndesired)
static MockitoAssertionError	tooManyActualInvocationsInOrder(int wantedCount, int actualCount, DescribedInvocation wanted, Location firstUndesired)
static MockitoException	unfinishedStubbing(Location location)
static MockitoException	unfinishedVerificationException(Location location)
static MockitoException	unsupportedCombinationOfAnnotations(String undesiredAnnotationOne, String undesiredAnnotationTwo)
static MockitoException	usingConstructorWithFancySerializable(SerializableMode mode)
static MockitoAssertionError	wantedAtMostX(int maxNumberOfInvocations, int foundSize)
static MockitoAssertionError	wantedButNotInvoked(DescribedInvocation wanted)
static MockitoAssertionError	wantedButNotInvoked(DescribedInvocation wanted, List<? extends DescribedInvocation> invocations)
static MockitoAssertionError	wantedButNotInvokedInOrder(DescribedInvocation wanted, DescribedInvocation previous)
static MockitoException	wrongTypeOfArgumentToReturn(InvocationOnMock invocation, String expectedType, Class actualType, int argumentIndex)
static MockitoException	wrongTypeOfReturnValue(String expectedType, String actualType, String methodName)
static MockitoException	wrongTypeReturnedByDefaultAnswer(Object mock, String expectedType, String actualType, String methodName)

Methods inherited from class java.lang.Object

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

Method Detail

checkedExceptionInvalid

public static MockitoException checkedExceptionInvalid(Throwable t)

cannotStubWithNullThrowable

public static MockitoException cannotStubWithNullThrowable()

unfinishedStubbing

public static MockitoException unfinishedStubbing(Location location)

incorrectUseOfApi

public static MockitoException incorrectUseOfApi()

missingMethodInvocation

public static MockitoException missingMethodInvocation()

unfinishedVerificationException

public static MockitoException unfinishedVerificationException(Location location)

notAMockPassedToVerify

public static MockitoException notAMockPassedToVerify(Class type)

nullPassedToVerify

public static MockitoException nullPassedToVerify()

notAMockPassedToWhenMethod

public static MockitoException notAMockPassedToWhenMethod()

nullPassedToWhenMethod

public static MockitoException nullPassedToWhenMethod()

mocksHaveToBePassedToVerifyNoMoreInteractions

public static MockitoException mocksHaveToBePassedToVerifyNoMoreInteractions()

notAMockPassedToVerifyNoMoreInteractions

public static MockitoException notAMockPassedToVerifyNoMoreInteractions()

nullPassedToVerifyNoMoreInteractions

public static MockitoException nullPassedToVerifyNoMoreInteractions()

notAMockPassedWhenCreatingInOrder

public static MockitoException notAMockPassedWhenCreatingInOrder()

nullPassedWhenCreatingInOrder

public static MockitoException nullPassedWhenCreatingInOrder()

mocksHaveToBePassedWhenCreatingInOrder

public static MockitoException mocksHaveToBePassedWhenCreatingInOrder()

inOrderRequiresFamiliarMock

public static MockitoException inOrderRequiresFamiliarMock()

invalidUseOfMatchers

public static MockitoException invalidUseOfMatchers(int expectedMatchersCount,
                                    List<LocalizedMatcher> recordedMatchers)

incorrectUseOfAdditionalMatchers

public static MockitoException incorrectUseOfAdditionalMatchers(String additionalMatcherName,
                                                int expectedSubMatchersCount,
                                                Collection<LocalizedMatcher> matcherStack)

stubPassedToVerify

public static MockitoException stubPassedToVerify()

reportNoSubMatchersFound

public static MockitoException reportNoSubMatchersFound(String additionalMatcherName)

argumentsAreDifferent

public static AssertionError argumentsAreDifferent(String wanted,
                                   String actual,
                                   Location actualLocation)

wantedButNotInvoked

public static MockitoAssertionError wantedButNotInvoked(DescribedInvocation wanted)

wantedButNotInvoked

public static MockitoAssertionError wantedButNotInvoked(DescribedInvocation wanted,
                                        List<? extends DescribedInvocation> invocations)

wantedButNotInvokedInOrder

public static MockitoAssertionError wantedButNotInvokedInOrder(DescribedInvocation wanted,
                                               DescribedInvocation previous)

tooManyActualInvocations

public static MockitoAssertionError tooManyActualInvocations(int wantedCount,
                                             int actualCount,
                                             DescribedInvocation wanted,
                                             Location firstUndesired)

neverWantedButInvoked

public static MockitoAssertionError neverWantedButInvoked(DescribedInvocation wanted,
                                          Location firstUndesired)

tooManyActualInvocationsInOrder

public static MockitoAssertionError tooManyActualInvocationsInOrder(int wantedCount,
                                                    int actualCount,
                                                    DescribedInvocation wanted,
                                                    Location firstUndesired)

tooLittleActualInvocations

public static MockitoAssertionError tooLittleActualInvocations(Discrepancy discrepancy,
                                               DescribedInvocation wanted,
                                               Location lastActualLocation)

tooLittleActualInvocationsInOrder

public static MockitoAssertionError tooLittleActualInvocationsInOrder(Discrepancy discrepancy,
                                                      DescribedInvocation wanted,
                                                      Location lastActualLocation)

noMoreInteractionsWanted

public static MockitoAssertionError noMoreInteractionsWanted(Invocation undesired,
                                             List<VerificationAwareInvocation> invocations)

noMoreInteractionsWantedInOrder

public static MockitoAssertionError noMoreInteractionsWantedInOrder(Invocation undesired)

cannotMockClass

public static MockitoException cannotMockClass(Class<?> clazz,
                               String reason)

cannotStubVoidMethodWithAReturnValue

public static MockitoException cannotStubVoidMethodWithAReturnValue(String methodName)

onlyVoidMethodsCanBeSetToDoNothing

public static MockitoException onlyVoidMethodsCanBeSetToDoNothing()

wrongTypeOfReturnValue

public static MockitoException wrongTypeOfReturnValue(String expectedType,
                                      String actualType,
                                      String methodName)

wrongTypeReturnedByDefaultAnswer

public static MockitoException wrongTypeReturnedByDefaultAnswer(Object mock,
                                                String expectedType,
                                                String actualType,
                                                String methodName)

wantedAtMostX

public static MockitoAssertionError wantedAtMostX(int maxNumberOfInvocations,
                                  int foundSize)

misplacedArgumentMatcher

public static MockitoException misplacedArgumentMatcher(List<LocalizedMatcher> lastMatchers)

smartNullPointerException

public static MockitoException smartNullPointerException(String invocation,
                                         Location location)

noArgumentValueWasCaptured

public static MockitoException noArgumentValueWasCaptured()

extraInterfacesDoesNotAcceptNullParameters

public static MockitoException extraInterfacesDoesNotAcceptNullParameters()

extraInterfacesAcceptsOnlyInterfaces

public static MockitoException extraInterfacesAcceptsOnlyInterfaces(Class<?> wrongType)

extraInterfacesCannotContainMockedType

public static MockitoException extraInterfacesCannotContainMockedType(Class<?> wrongType)

extraInterfacesRequiresAtLeastOneInterface

public static MockitoException extraInterfacesRequiresAtLeastOneInterface()

mockedTypeIsInconsistentWithSpiedInstanceType

public static MockitoException mockedTypeIsInconsistentWithSpiedInstanceType(Class<?> mockedType,
                                                             Object spiedInstance)

cannotCallAbstractRealMethod

public static MockitoException cannotCallAbstractRealMethod()

cannotVerifyToString

public static MockitoException cannotVerifyToString()

moreThanOneAnnotationNotAllowed

public static MockitoException moreThanOneAnnotationNotAllowed(String fieldName)

unsupportedCombinationOfAnnotations

public static MockitoException unsupportedCombinationOfAnnotations(String undesiredAnnotationOne,
                                                   String undesiredAnnotationTwo)

cannotInitializeForSpyAnnotation

public static MockitoException cannotInitializeForSpyAnnotation(String fieldName,
                                                Exception details)

cannotInitializeForInjectMocksAnnotation

public static MockitoException cannotInitializeForInjectMocksAnnotation(String fieldName,
                                                        Exception details)

atMostAndNeverShouldNotBeUsedWithTimeout

public static MockitoException atMostAndNeverShouldNotBeUsedWithTimeout()

fieldInitialisationThrewException

public static MockitoException fieldInitialisationThrewException(Field field,
                                                 Throwable details)

invocationListenerDoesNotAcceptNullParameters

public static MockitoException invocationListenerDoesNotAcceptNullParameters()

invocationListenersRequiresAtLeastOneListener

public static MockitoException invocationListenersRequiresAtLeastOneListener()

invocationListenerThrewException

public static MockitoException invocationListenerThrewException(InvocationListener listener,
                                                Throwable listenerThrowable)

cannotInjectDependency

public static MockitoException cannotInjectDependency(Field field,
                                      Object matchingMock,
                                      Exception details)

mockedTypeIsInconsistentWithDelegatedInstanceType

public static MockitoException mockedTypeIsInconsistentWithDelegatedInstanceType(Class mockedType,
                                                                 Object delegatedInstance)

spyAndDelegateAreMutuallyExclusive

public static MockitoException spyAndDelegateAreMutuallyExclusive()

invalidArgumentRangeAtIdentityAnswerCreationTime

public static MockitoException invalidArgumentRangeAtIdentityAnswerCreationTime()

invalidArgumentPositionRangeAtInvocationTime

public static MockitoException invalidArgumentPositionRangeAtInvocationTime(InvocationOnMock invocation,
                                                            boolean willReturnLastParameter,
                                                            int argumentIndex)

wrongTypeOfArgumentToReturn

public static MockitoException wrongTypeOfArgumentToReturn(InvocationOnMock invocation,
                                           String expectedType,
                                           Class actualType,
                                           int argumentIndex)

defaultAnswerDoesNotAcceptNullParameter

public static MockitoException defaultAnswerDoesNotAcceptNullParameter()

serializableWontWorkForObjectsThatDontImplementSerializable

public static MockitoException serializableWontWorkForObjectsThatDontImplementSerializable(Class classToMock)

delegatedMethodHasWrongReturnType

public static MockitoException delegatedMethodHasWrongReturnType(Method mockMethod,
                                                 Method delegateMethod,
                                                 Object mock,
                                                 Object delegate)

delegatedMethodDoesNotExistOnDelegate

public static MockitoException delegatedMethodDoesNotExistOnDelegate(Method mockMethod,
                                                     Object mock,
                                                     Object delegate)

usingConstructorWithFancySerializable

public static MockitoException usingConstructorWithFancySerializable(SerializableMode mode)

cannotCreateTimerWithNegativeDurationTime

public static MockitoException cannotCreateTimerWithNegativeDurationTime(long durationMillis)

notAnException

public static MockitoException notAnException()