Package org.mockito.internal.invocation

Class InvocationImpl

java.lang.Object

org.mockito.internal.invocation.InvocationImpl

All Implemented Interfaces:

Serializable, PrintableInvocation, VerificationAwareInvocation, DescribedInvocation, Invocation, InvocationOnMock

public class InvocationImpl
extends Object
implements Invocation, VerificationAwareInvocation

Method call on a mock object.

Contains sequence number which should be globally unique and is used for verification in order.

Contains stack trace of invocation

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
InvocationImpl(Object mock, MockitoMethod mockitoMethod, Object[] args, int sequenceNumber, RealMethod realMethod)

Method Summary

Modifier and Type	Method	Description
Object	callRealMethod()	calls real method
boolean	equals(Object o)
<T> T	getArgumentAt(int index, Class<T> clazz)	Returns casted argument using position
Object[]	getArguments()	returns arguments passed to the method
Location	getLocation()	The place in the code where the invocation happened.
Method	getMethod()	returns the method
Object	getMock()	returns the mock object
Object[]	getRawArguments()	Returns unprocessed arguments whereas InvocationOnMock.getArguments() returns arguments already processed (e.g.
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()
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

Constructor Details

InvocationImpl

public InvocationImpl(Object mock,
 MockitoMethod mockitoMethod,
 Object[] args,
 int sequenceNumber,
 RealMethod realMethod)

Method Details

getMock

public Object getMock()

Description copied from interface: InvocationOnMock

returns the mock object

Specified by:

getMock in interface InvocationOnMock

Returns:

mock object

getMethod

public Method getMethod()

Description copied from interface: InvocationOnMock

returns the method

Specified by:

getMethod in interface InvocationOnMock

Returns:

method

getArguments

public Object[] getArguments()

Description copied from interface: InvocationOnMock

returns arguments passed to the method

Specified by:

getArguments in interface InvocationOnMock

Returns:

arguments

getArgumentAt

public <T> T getArgumentAt(int index,
 Class<T> clazz)

Description copied from interface: InvocationOnMock

Returns casted argument using position

Specified by:

getArgumentAt in interface InvocationOnMock

Parameters:

index - argument position

clazz - argument type

Returns:

casted argument on position

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.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Description copied from interface: DescribedInvocation

Describes the invocation in the human friendly way.

Specified by:

toString in interface DescribedInvocation

Specified by:

toString in interface PrintableInvocation

Overrides:

toString in class Object

Returns:

the description of this invocation.

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

Specified by:

getLocation in interface PrintableInvocation

Returns:

the location in code of this invocation.

getRawArguments

public Object[] getRawArguments()

Description copied from interface: Invocation

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

Specified by:

getRawArguments in interface Invocation

Returns:

unprocessed arguments, exactly as provided to this invocation.

callRealMethod

public Object callRealMethod()
                      throws 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:

Throwable - in case real method throws

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