org.unitils.mock.argumentmatcher.impl

Class SameArgumentMatcher

java.lang.Object

org.unitils.mock.argumentmatcher.impl.SameArgumentMatcher

All Implemented Interfaces:

ArgumentMatcher

public class SameArgumentMatcher
extends Object
implements ArgumentMatcher

A matcher that will check whether an argument is the same instance (object identical) as the given value.

Author:

Kenny Claes, Filip Neven, Tim Ducheyne

Nested Class Summary

Nested classes/interfaces inherited from interface org.unitils.mock.argumentmatcher.ArgumentMatcher

ArgumentMatcher.MatchResult

Constructor Summary

Constructors

Constructor and Description
SameArgumentMatcher(Object value) Creates a matcher for the given value.

Method Summary

Methods

Modifier and Type	Method and Description
ArgumentMatcher.MatchResult	matches(Object argument, Object argumentAtInvocationTime) Returns true if the given object matches the expected argument, false otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

SameArgumentMatcher

public SameArgumentMatcher(Object value)

Creates a matcher for the given value.

Parameters:

value - The expected value

Method Detail

matches

public ArgumentMatcher.MatchResult matches(Object argument,
                                  Object argumentAtInvocationTime)

Returns true if the given object matches the expected argument, false otherwise. The argumentAtInvocationTime is a copy (deep clone) of the arguments at the time of the invocation. This way the original values can still be used later-on even when changes occur to the original values (pass-by-value vs pass-by-reference).

Specified by:

matches in interface ArgumentMatcher

Parameters:

argument - The argument that were used by reference, not null

argumentAtInvocationTime - Copy of the argument, taken at the time that the invocation was performed, not null

Returns:

The match result, not null