Package com.google.common.testing

Class EquivalenceTester<T>

java.lang.Object

com.google.common.testing.EquivalenceTester<T>

@Beta
@GwtCompatible
public final class EquivalenceTester<T>
extends java.lang.Object

Tester for Equivalence relationships between groups of objects.

To use, create a new EquivalenceTester and add equivalence groups where each group contains objects that are supposed to be equal to each other. Objects of different groups are expected to be unequal. For example:

 EquivalenceTester.of(someStringEquivalence)
     .addEquivalenceGroup("hello", "h" + "ello")
     .addEquivalenceGroup("world", "wor" + "ld")
     .test();
 

Note that testing Object.equals(Object) is more simply done using the EqualsTester. It includes an extra test against an instance of an arbitrary class without having to explicitly add another equivalence group.

Since:

10.0

Field Summary

Fields

Modifier and Type	Field	Description
private RelationshipTester<T>	delegate
private Equivalence<? super T>	equivalence
private java.util.List<T>	items
private static int	REPETITIONS

Constructor Summary

Constructors

Modifier	Constructor	Description
private	EquivalenceTester(Equivalence<? super T> equivalence)

Method Summary

Modifier and Type	Method	Description
EquivalenceTester<T>	addEquivalenceGroup(java.lang.Iterable<T> group)
EquivalenceTester<T>	addEquivalenceGroup(T first, T... rest)	Adds a group of objects that are supposed to be equivalent to each other and not equivalent to objects in any other equivalence group added to this tester.
static <T> EquivalenceTester<T>	of(Equivalence<? super T> equivalence)
EquivalenceTester<T>	test()	Run tests on equivalence methods, throwing a failure on an invalid test
private void	testItems()

Methods inherited from class java.lang.Object

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

Field Detail

REPETITIONS

private static final int REPETITIONS

See Also:

Constant Field Values

equivalence

private final Equivalence<? super T> equivalence

delegate

private final RelationshipTester<T> delegate

items

private final java.util.List<T> items

Constructor Detail

EquivalenceTester

private EquivalenceTester(Equivalence<? super T> equivalence)

Method Detail

of

public static <T> EquivalenceTester<T> of(Equivalence<? super T> equivalence)

addEquivalenceGroup

public EquivalenceTester<T> addEquivalenceGroup(T first,
                                                T... rest)

Adds a group of objects that are supposed to be equivalent to each other and not equivalent to objects in any other equivalence group added to this tester.

addEquivalenceGroup

public EquivalenceTester<T> addEquivalenceGroup(java.lang.Iterable<T> group)

test

public EquivalenceTester<T> test()

Run tests on equivalence methods, throwing a failure on an invalid test

testItems

private void testItems()