Class Helpers
java.lang.Object
com.google.common.collect.testing.Helpers
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprivate static class
private static @interface
Private replacement forinvalid reference
com.google.gwt.user.client.rpc.GwtTransient
static class
Compares strings in natural order except that null comes immediately before a given value.static final class
static final class
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic <E> boolean
addAll
(Collection<E> addTo, Iterable<? extends E> elementsToAdd) static void
assertContains
(Iterable<?> actual, Object expected) static void
assertContainsAllOf
(Iterable<?> actual, Object... expected) static void
assertContentsAnyOrder
(Iterable<?> actual, Object... expected) static void
assertContentsInOrder
(Iterable<?> actual, Object... expected) static void
assertEmpty
(Iterable<?> iterable) static void
assertEmpty
(Map<?, ?> map) static void
assertEqualIgnoringOrder
(Iterable<?> expected, Iterable<?> actual) static void
assertEqualInOrder
(Iterable<?> expected, Iterable<?> actual) (package private) static <E> List
<E> castOrCopyToList
(Iterable<E> iterable) static <E> List
<E> copyToList
(E[] elements) static <E> List
<E> copyToList
(Iterable<? extends E> elements) static <E> Set
<E> copyToSet
(E[] elements) static <E> Set
<E> (package private) static <T> Iterator
<T> static <K,
V> Comparator <Map.Entry<K, V>> entryComparator
(Comparator<? super K> keyComparator) (package private) static boolean
(package private) static <T> T
static Method
private static boolean
static <K,
V> Map.Entry <K, V> mapEntry
(K key, V value) static <T> Collection
<T> misleadingSizeCollection
(int delta) Returns a collection that simulates concurrent modification by having its size method return incorrect values.static <K,
V> Map.Entry <K, V> nefariousMapEntry
(K key, V value) Returns a "nefarious" map entry with the specified key and value, meaning an entry that is suitable for testing that map entries cannot be modified via a nefarious implementation of equals.static <K extends Comparable,
V>
Iterable<Map.Entry<K, V>> orderEntriesByKey
(List<Map.Entry<K, V>> insertionOrder) (package private) static <T> Iterable
<T> static <T> void
testComparator
(Comparator<? super T> comparator, List<T> valuesInExpectedOrder) Asserts that all pairs ofT
values withinvaluesInExpectedOrder
are ordered consistently between their order withinvaluesInExpectedOrder
and the order implied by the givencomparator
.static <T> void
testComparator
(Comparator<? super T> comparator, T... valuesInExpectedOrder) Asserts that all pairs ofT
values withinvaluesInExpectedOrder
are ordered consistently between their order withinvaluesInExpectedOrder
and the order implied by the givencomparator
.static <T extends Comparable<? super T>>
voidtestCompareToAndEquals
(List<T> valuesInExpectedOrder)
-
Constructor Details
-
Helpers
public Helpers()
-
-
Method Details
-
equal
-
copyToList
-
copyToList
-
copyToSet
-
copyToSet
-
mapEntry
-
isEmpty
-
assertEmpty
-
assertEmpty
-
assertEqualInOrder
-
assertContentsInOrder
-
assertEqualIgnoringOrder
-
assertContentsAnyOrder
-
assertContains
-
assertContainsAllOf
-
addAll
-
reverse
-
cycle
-
get
-
entryComparator
public static <K,V> Comparator<Map.Entry<K,V>> entryComparator(Comparator<? super K> keyComparator) -
testComparator
Asserts that all pairs ofT
values withinvaluesInExpectedOrder
are ordered consistently between their order withinvaluesInExpectedOrder
and the order implied by the givencomparator
.- See Also:
-
testComparator
public static <T> void testComparator(Comparator<? super T> comparator, List<T> valuesInExpectedOrder) Asserts that all pairs ofT
values withinvaluesInExpectedOrder
are ordered consistently between their order withinvaluesInExpectedOrder
and the order implied by the givencomparator
.In detail, this method asserts
- reflexivity:
comparator.compare(t, t) = 0
for allt
invaluesInExpectedOrder
; and - consistency:
comparator.compare(ti, tj) < 0
andcomparator.compare(tj, ti) > 0
fori < j
, whereti = valuesInExpectedOrder.get(i)
andtj = valuesInExpectedOrder.get(j)
.
- reflexivity:
-
testCompareToAndEquals
public static <T extends Comparable<? super T>> void testCompareToAndEquals(List<T> valuesInExpectedOrder) -
misleadingSizeCollection
Returns a collection that simulates concurrent modification by having its size method return incorrect values. This is useful for testing methods that must treat the return value from size() as a hint only.- Parameters:
delta
- the difference between the true size of the collection and the values returned by the size method
-
nefariousMapEntry
Returns a "nefarious" map entry with the specified key and value, meaning an entry that is suitable for testing that map entries cannot be modified via a nefarious implementation of equals. This is used for testing unmodifiable collections of map entries; for example, it should not be possible to access the raw (modifiable) map entry via a nefarious equals method. -
castOrCopyToList
-
orderEntriesByKey
public static <K extends Comparable,V> Iterable<Map.Entry<K,V>> orderEntriesByKey(List<Map.Entry<K, V>> insertionOrder) -
getMethod
-