Class Helpers
- java.lang.Object
-
- com.google.common.collect.testing.Helpers
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Helpers.NullsBefore
Compares strings in natural order except that null comes immediately before a given value.static class
Helpers.NullsBeforeB
static class
Helpers.NullsBeforeTwo
-
Constructor Summary
Constructors Constructor Description Helpers()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static <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)
static <E extends @Nullable Object>
List<E>copyToList(E[] elements)
static <E extends @Nullable Object>
List<E>copyToList(Iterable<? extends E> elements)
static <E extends @Nullable Object>
Set<E>copyToSet(E[] elements)
static <E extends @Nullable Object>
Set<E>copyToSet(Iterable<? extends E> elements)
static <K,V>
Comparator<Map.Entry<K,V>>entryComparator(@Nullable Comparator<? super K> keyComparator)
static Method
getMethod(Class<?> clazz, String name)
static <K extends @Nullable Object,V extends @Nullable Object>
Map.Entry<K,V>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.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.static <K extends Comparable,V>
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> 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 Detail
-
Helpers
public Helpers()
-
-
Method Detail
-
copyToList
public static <E extends @Nullable Object> List<E> copyToList(Iterable<? extends E> elements)
-
copyToList
public static <E extends @Nullable Object> List<E> copyToList(E[] elements)
-
copyToSet
public static <E extends @Nullable Object> Set<E> copyToSet(Iterable<? extends E> elements)
-
mapEntry
public static <K extends @Nullable Object,V extends @Nullable Object> Map.Entry<K,V> mapEntry(K key, V value)
-
assertEmpty
public static void assertEmpty(Iterable<?> iterable)
-
assertEmpty
public static void assertEmpty(Map<?,?> map)
-
assertEqualInOrder
public static void assertEqualInOrder(Iterable<?> expected, Iterable<?> actual)
-
assertContentsInOrder
public static void assertContentsInOrder(Iterable<?> actual, Object... expected)
-
assertEqualIgnoringOrder
public static void assertEqualIgnoringOrder(Iterable<?> expected, Iterable<?> actual)
-
assertContentsAnyOrder
public static void assertContentsAnyOrder(Iterable<?> actual, Object... expected)
-
assertContains
public static void assertContains(Iterable<?> actual, Object expected)
-
assertContainsAllOf
public static void assertContainsAllOf(Iterable<?> actual, Object... expected)
-
addAll
@CanIgnoreReturnValue public static <E extends @Nullable Object> boolean addAll(Collection<E> addTo, Iterable<? extends E> elementsToAdd)
-
entryComparator
public static <K,V> Comparator<Map.Entry<K,V>> entryComparator(@Nullable Comparator<? super K> keyComparator)
-
testComparator
public 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
.- See Also:
testComparator(Comparator, List)
-
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
public 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. 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
public static <K extends Comparable,V> Iterable<Map.Entry<K,V>> orderEntriesByKey(List<Map.Entry<K,V>> insertionOrder)
-
-