Package org.mockito.internal.exceptions

Class Reporter

java.lang.Object

org.mockito.internal.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

Modifier and Type	Method	Description
static AssertionError	argumentsAreDifferent(Invocation actualInvocation, MatchableInvocation matchableInvocation, String wanted, List<String> actualCalls, List<Location> actualLocations)
static MockitoException	atMostAndNeverShouldNotBeUsedWithTimeout()
static MockitoException	cannotCallAbstractRealMethod()
static MockitoException	cannotCreateTimerWithNegativeDurationTime(long durationMillis)
static MockitoException	cannotInitializeForInjectMocksAnnotation(String fieldName, String causeMessage)
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 UnnecessaryStubbingException	formatUnncessaryStubbingException(Class<?> testClass, Collection<Invocation> unnecessaryStubbings)
static MockitoException	incorrectUseOfAdditionalMatchers(String additionalMatcherName, int expectedSubMatchersCount, Collection<LocalizedMatcher> matcherStack)
static MockitoException	incorrectUseOfApi()
static MockitoException	inlineClassWithoutUnboxImpl(Class<?> inlineClass, Exception details)
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	invocationListenerThrewException(InvocationListener listener, Throwable listenerThrowable)
static MockitoException	methodDoesNotAcceptParameter(String method, String parameter)
static MockitoException	misplacedArgumentMatcher(List<LocalizedMatcher> lastMatchers)
static void	missingByteBuddyDependency(Throwable t)
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 MockitoException	moreThanOneMockCandidate(Field field, Collection<?> mockCandidates)
static MockitoAssertionError	neverWantedButInvoked(DescribedInvocation wanted, List<Invocation> invocations)
static MockitoException	noArgumentValueWasCaptured()
static MockitoAssertionError	noInteractionsWanted(Object mock, List<VerificationAwareInvocation> invocations)
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 void	potentialStubbingProblem(Invocation actualInvocation, Collection<Invocation> argMismatchStubbings)
static void	redundantMockitoListener(String listenerType)
static MockitoException	reportNoSubMatchersFound(String additionalMatcherName)
static MockitoException	requiresAtLeastOneListener(String method)
static MockitoException	serializableWontWorkForObjectsThatDontImplementSerializable(Class<?> classToMock)
static MockitoException	smartNullPointerException(String invocation, Location location)
static MockitoException	spyAndDelegateAreMutuallyExclusive()
static MockitoException	strictnessDoesNotAcceptNullParameter()
static MockitoException	stubPassedToVerify(Object mock)
static MockitoAssertionError	tooFewActualInvocations(Discrepancy discrepancy, DescribedInvocation wanted, List<Location> allLocations)
static MockitoAssertionError	tooFewActualInvocationsInOrder(Discrepancy discrepancy, DescribedInvocation wanted, List<Location> locations)
static MockitoAssertionError	tooManyActualInvocations(int wantedCount, int actualCount, DescribedInvocation wanted, List<Location> locations)
static MockitoAssertionError	tooManyActualInvocationsInOrder(int wantedCount, int actualCount, DescribedInvocation wanted, List<Location> invocations)
static void	unfinishedMockingSession()
static MockitoException	unfinishedStubbing(Location location)
static MockitoException	unfinishedVerificationException(Location location)
static void	unncessaryStubbingException(List<Invocation> unused)
static MockitoException	unsupportedCombinationOfAnnotations(String undesiredAnnotationOne, String undesiredAnnotationTwo)
static MockitoException	usingConstructorWithFancySerializable(SerializableMode mode)
static MoreThanAllowedActualInvocations	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 Details

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(Object mock)

reportNoSubMatchersFound

public static MockitoException reportNoSubMatchersFound(String additionalMatcherName)

argumentsAreDifferent

public static AssertionError argumentsAreDifferent(Invocation actualInvocation,
 MatchableInvocation matchableInvocation,
 String wanted,
 List<String> actualCalls,
 List<Location> actualLocations)

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,
 List<Location> locations)

neverWantedButInvoked

public static MockitoAssertionError neverWantedButInvoked(DescribedInvocation wanted,
 List<Invocation> invocations)

tooManyActualInvocationsInOrder

public static MockitoAssertionError tooManyActualInvocationsInOrder(int wantedCount,
 int actualCount,
 DescribedInvocation wanted,
 List<Location> invocations)

tooFewActualInvocations

public static MockitoAssertionError tooFewActualInvocations(Discrepancy discrepancy,
 DescribedInvocation wanted,
 List<Location> allLocations)

tooFewActualInvocationsInOrder

public static MockitoAssertionError tooFewActualInvocationsInOrder(Discrepancy discrepancy,
 DescribedInvocation wanted,
 List<Location> locations)

noMoreInteractionsWanted

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

noMoreInteractionsWantedInOrder

public static MockitoAssertionError noMoreInteractionsWantedInOrder(Invocation undesired)

noInteractionsWanted

public static MockitoAssertionError noInteractionsWanted(Object mock,
 List<VerificationAwareInvocation> invocations)

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 MoreThanAllowedActualInvocations 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,
 String causeMessage)

atMostAndNeverShouldNotBeUsedWithTimeout

public static MockitoException atMostAndNeverShouldNotBeUsedWithTimeout()

fieldInitialisationThrewException

public static MockitoException fieldInitialisationThrewException(Field field,
 Throwable details)

methodDoesNotAcceptParameter

public static MockitoException methodDoesNotAcceptParameter(String method,
 String parameter)

requiresAtLeastOneListener

public static MockitoException requiresAtLeastOneListener(String method)

invocationListenerThrewException

public static MockitoException invocationListenerThrewException(InvocationListener listener,
 Throwable listenerThrowable)

cannotInjectDependency

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

moreThanOneMockCandidate

public static MockitoException moreThanOneMockCandidate(Field field,
 Collection<?> mockCandidates)

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()

strictnessDoesNotAcceptNullParameter

public static MockitoException strictnessDoesNotAcceptNullParameter()

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()

inlineClassWithoutUnboxImpl

public static MockitoException inlineClassWithoutUnboxImpl(Class<?> inlineClass,
 Exception details)

formatUnncessaryStubbingException

public static UnnecessaryStubbingException formatUnncessaryStubbingException(Class<?> testClass,
 Collection<Invocation> unnecessaryStubbings)

unncessaryStubbingException

public static void unncessaryStubbingException(List<Invocation> unused)

potentialStubbingProblem

public static void potentialStubbingProblem(Invocation actualInvocation,
 Collection<Invocation> argMismatchStubbings)

redundantMockitoListener

public static void redundantMockitoListener(String listenerType)

unfinishedMockingSession

public static void unfinishedMockingSession()

missingByteBuddyDependency

public static void missingByteBuddyDependency(Throwable t)