Package org.mockito.internal.invocation

Class InterceptedInvocation

java.lang.Object

org.mockito.internal.invocation.InterceptedInvocation

All Implemented Interfaces:

java.io.Serializable, VerificationAwareInvocation, DescribedInvocation, Invocation, InvocationOnMock

public class InterceptedInvocation
extends java.lang.Object
implements Invocation, VerificationAwareInvocation

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.Object[]	arguments
private boolean	isIgnoredForVerification
private Location	location
private MockitoMethod	mockitoMethod
private MockReference<java.lang.Object>	mockRef
static RealMethod	NO_OP
private java.lang.Object[]	rawArguments
private RealMethod	realMethod
private int	sequenceNumber
private static long	serialVersionUID
private StubInfo	stubInfo
private boolean	verified

Constructor Summary

Constructors

Constructor	Description
InterceptedInvocation(MockReference<java.lang.Object> mockRef, MockitoMethod mockitoMethod, java.lang.Object[] arguments, RealMethod realMethod, Location location, int sequenceNumber)

Method Summary

Modifier and Type	Method	Description
java.lang.Object	callRealMethod()	calls real method
private boolean	equalArguments(java.lang.Object[] arguments)
boolean	equals(java.lang.Object o)
<T> T	getArgument(int index)	Returns casted argument at the given index.
<T> T	getArgument(int index, java.lang.Class<T> clazz)	Returns casted argument at the given index.
java.lang.Object[]	getArguments()	Returns arguments passed to the method.
java.util.List<ArgumentMatcher>	getArgumentsAsMatchers()	Wraps each argument using ArgumentMatchers.eq(Object) or AdditionalMatchers.aryEq(Object[]) Used internally for the purposes of human-readable invocation printing.
Location	getLocation()	The place in the code where the invocation happened.
java.lang.reflect.Method	getMethod()	returns the method
java.lang.Object	getMock()	returns the mock object
MockitoMethod	getMockitoMethod()	Deprecated. Not used by Mockito but by mockito-scala
MockReference<java.lang.Object>	getMockRef()	Deprecated. Not used by Mockito but by mockito-scala
java.lang.Object[]	getRawArguments()	Returns unprocessed arguments whereas InvocationOnMock.getArguments() returns arguments already processed (e.g.
java.lang.Class<?>	getRawReturnType()	Returns unprocessed arguments whereas InvocationOnMock.getArguments() returns arguments already processed (e.g.
RealMethod	getRealMethod()	Deprecated. Not used by Mockito but by mockito-scala
int	getSequenceNumber()
int	hashCode()
void	ignoreForVerification()	Configures this invocation to be ignored for verify-no-more-invocations or verification in order.
boolean	isIgnoredForVerification()	Informs if the invocation participates in verify-no-more-invocations or verification in order.
boolean	isVerified()
void	markStubbed(StubInfo stubInfo)	Marks this invocation as stubbed.
void	markVerified()	Marks this invocation as verified so that it will not cause verification error at Mockito.verifyNoMoreInteractions(Object...)
StubInfo	stubInfo()
java.lang.String	toString()	Describes the invocation in the human friendly way.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

mockRef

private final MockReference<java.lang.Object> mockRef

mockitoMethod

private final MockitoMethod mockitoMethod

arguments

private final java.lang.Object[] arguments

rawArguments

private final java.lang.Object[] rawArguments

realMethod

private final RealMethod realMethod

sequenceNumber

private final int sequenceNumber

location

private final Location location

verified

private boolean verified

isIgnoredForVerification

private boolean isIgnoredForVerification

stubInfo

private StubInfo stubInfo

NO_OP

public static final RealMethod NO_OP

Constructor Detail

InterceptedInvocation

public InterceptedInvocation(MockReference<java.lang.Object> mockRef,
                             MockitoMethod mockitoMethod,
                             java.lang.Object[] arguments,
                             RealMethod realMethod,
                             Location location,
                             int sequenceNumber)

Method Detail

isVerified

public boolean isVerified()

Specified by:

isVerified in interface Invocation

Specified by:

isVerified in interface VerificationAwareInvocation

Returns:

whether the invocation has been already verified. Needed for Mockito.verifyNoMoreInteractions(Object...)

getSequenceNumber

public int getSequenceNumber()

Specified by:

getSequenceNumber in interface Invocation

Returns:

the sequence number of the Invocation. Useful to determine the order of invocations. Used by verification in order.

getLocation

public Location getLocation()

Description copied from interface: DescribedInvocation

The place in the code where the invocation happened.

Specified by:

getLocation in interface DescribedInvocation

Specified by:

getLocation in interface Invocation

Returns:

the location in code of this invocation.

getRawArguments

public java.lang.Object[] getRawArguments()

Description copied from interface: InvocationOnMock

Returns unprocessed arguments whereas InvocationOnMock.getArguments() returns arguments already processed (e.g. varargs expended, etc.).

Specified by:

getRawArguments in interface InvocationOnMock

Returns:

unprocessed arguments, exactly as provided to this invocation.

getRawReturnType

public java.lang.Class<?> getRawReturnType()

Description copied from interface: Invocation

Returns unprocessed arguments whereas InvocationOnMock.getArguments() returns arguments already processed (e.g. varargs expended, etc.).

Specified by:

getRawReturnType in interface Invocation

Returns:

unprocessed arguments, exactly as provided to this invocation.

markVerified

public void markVerified()

Description copied from interface: Invocation

Marks this invocation as verified so that it will not cause verification error at Mockito.verifyNoMoreInteractions(Object...)

Specified by:

markVerified in interface Invocation

stubInfo

public StubInfo stubInfo()

Specified by:

stubInfo in interface Invocation

Returns:

the stubbing information for this invocation. May return null - this means the invocation was not stubbed.

markStubbed

public void markStubbed(StubInfo stubInfo)

Description copied from interface: Invocation

Marks this invocation as stubbed.

Specified by:

markStubbed in interface Invocation

Parameters:

stubInfo - the information about stubbing.

isIgnoredForVerification

public boolean isIgnoredForVerification()

Description copied from interface: Invocation

Informs if the invocation participates in verify-no-more-invocations or verification in order.

Specified by:

isIgnoredForVerification in interface Invocation

Returns:

whether this invocation should be ignored for the purposes of verify-no-more-invocations or verification in order.

ignoreForVerification

public void ignoreForVerification()

Description copied from interface: Invocation

Configures this invocation to be ignored for verify-no-more-invocations or verification in order. See also Invocation.isIgnoredForVerification()

Specified by:

ignoreForVerification in interface Invocation

getMock

public java.lang.Object getMock()

Description copied from interface: InvocationOnMock

returns the mock object

Specified by:

getMock in interface InvocationOnMock

Returns:

mock object

getMethod

public java.lang.reflect.Method getMethod()

Description copied from interface: InvocationOnMock

returns the method

Specified by:

getMethod in interface InvocationOnMock

Returns:

method

getArguments

public java.lang.Object[] getArguments()

Description copied from interface: InvocationOnMock

Returns arguments passed to the method. Vararg are expanded in this array.

Specified by:

getArguments in interface InvocationOnMock

Returns:

arguments

getArgument

public <T> T getArgument(int index)

Description copied from interface: InvocationOnMock

Returns casted argument at the given index. Can lookup in expanded arguments form InvocationOnMock.getArguments(). This method is preferred over InvocationOnMock.getArgument(int, Class) for readability. Please read the documentation of InvocationOnMock.getArgument(int, Class) for an overview of situations when that method is preferred over this one.

Specified by:

getArgument in interface InvocationOnMock

Parameters:

index - argument index

Returns:

casted argument at the given index

getArgument

public <T> T getArgument(int index,
                         java.lang.Class<T> clazz)

Description copied from interface: InvocationOnMock

Returns casted argument at the given index. This method is analogous to InvocationOnMock.getArgument(int), but is necessary to circumvent issues when dealing with generics. In general, InvocationOnMock.getArgument(int) is the appropriate function to use. This particular function is only necessary if you are doing one of the following things:

1. You want to directly invoke a method on the result of InvocationOnMock.getArgument(int).
2. You want to directly pass the result of the invocation into a function that accepts a generic parameter.

If you prefer to use InvocationOnMock.getArgument(int) instead, you can circumvent the compilation issues by storing the intermediate result into a local variable with the correct type.

Specified by:

getArgument in interface InvocationOnMock

Parameters:

index - argument index

clazz - class to cast the argument to

Returns:

casted argument at the given index

getArgumentsAsMatchers

public java.util.List<ArgumentMatcher> getArgumentsAsMatchers()

Description copied from interface: Invocation

Wraps each argument using ArgumentMatchers.eq(Object) or AdditionalMatchers.aryEq(Object[]) Used internally for the purposes of human-readable invocation printing.

Specified by:

getArgumentsAsMatchers in interface Invocation

Returns:

a list of ArgumentMatcher wrapping each of this invocation arguments

callRealMethod

public java.lang.Object callRealMethod()
                                throws java.lang.Throwable

Description copied from interface: InvocationOnMock

calls real method

Warning: depending on the real implementation it might throw exceptions

Specified by:

callRealMethod in interface InvocationOnMock

Returns:

whatever the real method returns / throws

Throws:

java.lang.Throwable - in case real method throws

getMockRef

@Deprecated
public MockReference<java.lang.Object> getMockRef()

Deprecated.

Not used by Mockito but by mockito-scala

getMockitoMethod

@Deprecated
public MockitoMethod getMockitoMethod()

Deprecated.

Not used by Mockito but by mockito-scala

getRealMethod

@Deprecated
public RealMethod getRealMethod()

Deprecated.

Not used by Mockito but by mockito-scala

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

equalArguments

private boolean equalArguments(java.lang.Object[] arguments)

toString

public java.lang.String toString()

Description copied from interface: DescribedInvocation

Describes the invocation in the human friendly way.

Specified by:

toString in interface DescribedInvocation

Overrides:

toString in class java.lang.Object

Returns:

the description of this invocation.