org.unitils.mock.argumentmatcher.impl
Class RefEqArgumentMatcher

java.lang.Object
  org.unitils.mock.argumentmatcher.impl.RefEqArgumentMatcher

All Implemented Interfaces:

ArgumentMatcher

public class RefEqArgumentMatcher
extends java.lang.Object
implements ArgumentMatcher

A matcher for checking whether an argument equals a given value. Reflection is used to compare all fields of these values.

Author:

Kenny Claes, Filip Neven, Tim Ducheyne

Constructor Summary

RefEqArgumentMatcher(java.lang.Object value)
Creates a matcher for the given value.

Method Summary

boolean

matches(java.lang.Object argument, java.lang.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

RefEqArgumentMatcher

public RefEqArgumentMatcher(java.lang.Object value)

Creates a matcher for the given value. A copy of the value is taken so that it can be compared even when the value itself was modified later-on.

Parameters:

value - The expected value

Method Detail

matches

public boolean matches(java.lang.Object argument,
                       java.lang.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:

True when passed object matches, false otherwise.