Package com.google.common.testing

Class RelationshipTester<T>

java.lang.Object

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

@GwtCompatible
final class RelationshipTester<T>
extends java.lang.Object

Implementation helper for EqualsTester and EquivalenceTester that tests for equivalence classes.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	RelationshipTester.Item<T>
(package private) static class	RelationshipTester.ItemReporter

Field Summary

Fields

Modifier and Type	Field	Description
private Equivalence<? super T>	equivalence	A word about using Equivalence, which automatically checks for null and identical inputs: This sounds like it ought to be a problem here, since the goals of this class include testing that equals() is reflexive and is tolerant of null.
private java.util.List<ImmutableList<T>>	groups
private java.lang.String	hashName
private RelationshipTester.ItemReporter	itemReporter
private java.lang.String	relationshipName

Constructor Summary

Constructors

Constructor	Description
RelationshipTester(Equivalence<? super T> equivalence, java.lang.String relationshipName, java.lang.String hashName, RelationshipTester.ItemReporter itemReporter)

Method Summary

Modifier and Type	Method	Description
RelationshipTester<T>	addRelatedGroup(java.lang.Iterable<? extends T> group)
private void	assertRelated(int groupNumber, int itemNumber, int relatedItemNumber)
private void	assertUnrelated(int groupNumber, int itemNumber, int unrelatedGroupNumber, int unrelatedItemNumber)
private void	assertWithTemplate(java.lang.String template, RelationshipTester.Item<T> item, RelationshipTester.Item<T> other, boolean condition)
private RelationshipTester.Item<T>	getItem(int groupNumber, int itemNumber)
void	test()

Methods inherited from class java.lang.Object

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

Field Detail

equivalence

private final Equivalence<? super T> equivalence

A word about using Equivalence, which automatically checks for null and identical inputs: This sounds like it ought to be a problem here, since the goals of this class include testing that equals() is reflexive and is tolerant of null. However, there's no problem. The reason: EqualsTester tests null and identical inputs directly against equals() rather than through the Equivalence.

relationshipName

private final java.lang.String relationshipName

hashName

private final java.lang.String hashName

itemReporter

private final RelationshipTester.ItemReporter itemReporter

groups

private final java.util.List<ImmutableList<T>> groups

Constructor Detail

RelationshipTester

RelationshipTester(Equivalence<? super T> equivalence,
                   java.lang.String relationshipName,
                   java.lang.String hashName,
                   RelationshipTester.ItemReporter itemReporter)

Method Detail

addRelatedGroup

public RelationshipTester<T> addRelatedGroup(java.lang.Iterable<? extends T> group)

test

public void test()

assertRelated

private void assertRelated(int groupNumber,
                           int itemNumber,
                           int relatedItemNumber)

assertUnrelated

private void assertUnrelated(int groupNumber,
                             int itemNumber,
                             int unrelatedGroupNumber,
                             int unrelatedItemNumber)

assertWithTemplate

private void assertWithTemplate(java.lang.String template,
                                RelationshipTester.Item<T> item,
                                RelationshipTester.Item<T> other,
                                boolean condition)

getItem

private RelationshipTester.Item<T> getItem(int groupNumber,
                                           int itemNumber)