Class Helpers
java.lang.Object
com.google.common.collect.testing.Helpers
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic 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 extends @Nullable Object>
booleanaddAll
(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) copyToList
(E[] elements) copyToList
(Iterable<? extends E> elements) copyToSet
(E[] elements) static <K extends @Nullable Object, V extends @Nullable Object>
Comparator<Map.Entry<K, V>> entryComparator
(@Nullable Comparator<? super K> keyComparator) static Method
mapEntry
(K key, V value) static <T extends @Nullable Object>
Collection<T> misleadingSizeCollection
(int delta) Returns a collection that simulates concurrent modification by having its size method return incorrect values.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 extends @Nullable Object>
Iterable<Map.Entry<K, V>> orderEntriesByKey
(List<Map.Entry<K, V>> insertionOrder) static <T extends @Nullable Object>
voidtestComparator
(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 extends @Nullable Object>
voidtestComparator
(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
-
copyToList
-
copyToList
-
copyToSet
-
copyToSet
-
mapEntry
-
assertEmpty
-
assertEmpty
-
assertEqualInOrder
-
assertContentsInOrder
-
assertEqualIgnoringOrder
-
assertContentsAnyOrder
-
assertContains
-
assertContainsAllOf
-
addAll
@CanIgnoreReturnValue public static <E extends @Nullable Object> boolean addAll(Collection<E> addTo, Iterable<? extends E> elementsToAdd) -
entryComparator
public static <K extends @Nullable Object, V extends @Nullable Object> Comparator<Map.Entry<K,V>> entryComparator(@Nullable Comparator<? super K> keyComparator) -
testComparator
public static <T extends @Nullable Object> 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
.- See Also:
-
testComparator
public static <T extends @Nullable Object> 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
public static <K extends @Nullable Object, V extends @Nullable Object> 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. 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. -
orderEntriesByKey
-
getMethod
-