Package org.mockito.internal.invocation

Class InvocationMatcher

java.lang.Object

org.mockito.internal.invocation.InvocationMatcher

All Implemented Interfaces:

java.io.Serializable, DescribedInvocation, MatchableInvocation

Direct Known Subclasses:

StubbedInvocationMatcher

public class InvocationMatcher
extends java.lang.Object
implements MatchableInvocation, DescribedInvocation, java.io.Serializable

In addition to all content of the invocation, the invocation matcher contains the argument matchers. Invocation matcher is used during verification and stubbing. In those cases, the user can provide argument matchers instead of 'raw' arguments. Raw arguments are converted to 'equals' matchers anyway.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private Invocation	invocation
private java.util.List<ArgumentMatcher<?>>	matchers

Constructor Summary

Constructors

Constructor	Description
InvocationMatcher(Invocation invocation)
InvocationMatcher(Invocation invocation, java.util.List<ArgumentMatcher> matchers)

Method Summary

Modifier and Type	Method	Description
private boolean	argumentsMatch(Invocation actual)
private ArgumentMatcherAction	captureArgument()
void	captureArgumentsFrom(Invocation invocation)	This method is used by Mockito to implement argument captor functionality (see ArgumentCaptor.
static java.util.List<InvocationMatcher>	createFrom(java.util.List<Invocation> invocations)
Invocation	getInvocation()	The actual invocation Mockito will match against.
Location	getLocation()	The place in the code where the invocation happened.
java.util.List<ArgumentMatcher>	getMatchers()	The argument matchers of this invocation.
java.lang.reflect.Method	getMethod()
boolean	hasSameMethod(Invocation candidate)	Returns true if the candidate invocation has the same method (method name and parameter types)
boolean	hasSimilarMethod(Invocation candidate)	similar means the same method name, same mock, unverified and: if arguments are the same cannot be overloaded
boolean	matches(Invocation candidate)	Same method, mock and all arguments match.
java.lang.String	toString()	Describes the invocation in the human friendly way.

Methods inherited from class java.lang.Object

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

Field Detail

invocation

private final Invocation invocation

matchers

private final java.util.List<ArgumentMatcher<?>> matchers

Constructor Detail

InvocationMatcher

public InvocationMatcher(Invocation invocation,
                         java.util.List<ArgumentMatcher> matchers)

InvocationMatcher

public InvocationMatcher(Invocation invocation)

Method Detail

createFrom

public static java.util.List<InvocationMatcher> createFrom(java.util.List<Invocation> invocations)

getMethod

public java.lang.reflect.Method getMethod()

getInvocation

public Invocation getInvocation()

Description copied from interface: MatchableInvocation

The actual invocation Mockito will match against.

Specified by:

getInvocation in interface MatchableInvocation

getMatchers

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

Description copied from interface: MatchableInvocation

The argument matchers of this invocation. When the invocation is declared without argument matchers (e.g. using plain arguments) Mockito still converts them into ArgumentMatcher instances that use 'eq' matching via ArgumentMatchers.eq(Object).

Specified by:

getMatchers in interface MatchableInvocation

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.

matches

public boolean matches(Invocation candidate)

Description copied from interface: MatchableInvocation

Same method, mock and all arguments match.

Specified by:

matches in interface MatchableInvocation

hasSimilarMethod

public boolean hasSimilarMethod(Invocation candidate)

similar means the same method name, same mock, unverified and: if arguments are the same cannot be overloaded

Specified by:

hasSimilarMethod in interface MatchableInvocation

hasSameMethod

public boolean hasSameMethod(Invocation candidate)

Description copied from interface: MatchableInvocation

Returns true if the candidate invocation has the same method (method name and parameter types)

Specified by:

hasSameMethod in interface MatchableInvocation

getLocation

public Location getLocation()

Description copied from interface: DescribedInvocation

The place in the code where the invocation happened.

Specified by:

getLocation in interface DescribedInvocation

Returns:

the location of the invocation.

captureArgumentsFrom

public void captureArgumentsFrom(Invocation invocation)

Description copied from interface: MatchableInvocation

This method is used by Mockito to implement argument captor functionality (see ArgumentCaptor.

Makes this instance of matchable invocation capture all arguments of provided invocation.

Specified by:

captureArgumentsFrom in interface MatchableInvocation

Parameters:

invocation - the invocation to capture the arguments from

captureArgument

private ArgumentMatcherAction captureArgument()

argumentsMatch

private boolean argumentsMatch(Invocation actual)