Class Helpers
- java.lang.Object
-
- com.google.common.collect.testing.Helpers
-
@GwtCompatible(emulated=true) public class Helpers extends java.lang.Object
-
-
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> boolean
addAll(java.util.Collection<E> addTo, java.lang.Iterable<? extends E> elementsToAdd)
static void
assertContains(java.lang.Iterable<?> actual, java.lang.Object expected)
static void
assertContainsAllOf(java.lang.Iterable<?> actual, java.lang.Object... expected)
static void
assertContentsAnyOrder(java.lang.Iterable<?> actual, java.lang.Object... expected)
static void
assertContentsInOrder(java.lang.Iterable<?> actual, java.lang.Object... expected)
static void
assertEmpty(java.lang.Iterable<?> iterable)
static void
assertEmpty(java.util.Map<?,?> map)
static void
assertEqualIgnoringOrder(java.lang.Iterable<?> expected, java.lang.Iterable<?> actual)
static void
assertEqualInOrder(java.lang.Iterable<?> expected, java.lang.Iterable<?> actual)
static <E> java.util.List<E>
copyToList(E[] elements)
static <E> java.util.List<E>
copyToList(java.lang.Iterable<? extends E> elements)
static <E> java.util.Set<E>
copyToSet(E[] elements)
static <E> java.util.Set<E>
copyToSet(java.lang.Iterable<? extends E> elements)
static <K,V>
java.util.Comparator<java.util.Map.Entry<K,V>>entryComparator(java.util.Comparator<? super K> keyComparator)
static java.lang.reflect.Method
getMethod(java.lang.Class<?> clazz, java.lang.String name)
static <K,V>
java.util.Map.Entry<K,V>mapEntry(K key, V value)
static <T> java.util.Collection<T>
misleadingSizeCollection(int delta)
Returns a collection that simulates concurrent modification by having its size method return incorrect values.static <K,V>
java.util.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 java.lang.Comparable,V>
java.lang.Iterable<java.util.Map.Entry<K,V>>orderEntriesByKey(java.util.List<java.util.Map.Entry<K,V>> insertionOrder)
static <T> void
testComparator(java.util.Comparator<? super T> comparator, java.util.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(java.util.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 java.lang.Comparable<? super T>>
voidtestCompareToAndEquals(java.util.List<T> valuesInExpectedOrder)
-
-
-
Method Detail
-
copyToList
public static <E> java.util.List<E> copyToList(java.lang.Iterable<? extends E> elements)
-
copyToList
public static <E> java.util.List<E> copyToList(E[] elements)
-
copyToSet
public static <E> java.util.Set<E> copyToSet(java.lang.Iterable<? extends E> elements)
-
copyToSet
public static <E> java.util.Set<E> copyToSet(E[] elements)
-
mapEntry
public static <K,V> java.util.Map.Entry<K,V> mapEntry(K key, V value)
-
assertEmpty
public static void assertEmpty(java.lang.Iterable<?> iterable)
-
assertEmpty
public static void assertEmpty(java.util.Map<?,?> map)
-
assertEqualInOrder
public static void assertEqualInOrder(java.lang.Iterable<?> expected, java.lang.Iterable<?> actual)
-
assertContentsInOrder
public static void assertContentsInOrder(java.lang.Iterable<?> actual, java.lang.Object... expected)
-
assertEqualIgnoringOrder
public static void assertEqualIgnoringOrder(java.lang.Iterable<?> expected, java.lang.Iterable<?> actual)
-
assertContentsAnyOrder
public static void assertContentsAnyOrder(java.lang.Iterable<?> actual, java.lang.Object... expected)
-
assertContains
public static void assertContains(java.lang.Iterable<?> actual, java.lang.Object expected)
-
assertContainsAllOf
public static void assertContainsAllOf(java.lang.Iterable<?> actual, java.lang.Object... expected)
-
addAll
public static <E> boolean addAll(java.util.Collection<E> addTo, java.lang.Iterable<? extends E> elementsToAdd)
-
entryComparator
public static <K,V> java.util.Comparator<java.util.Map.Entry<K,V>> entryComparator(java.util.Comparator<? super K> keyComparator)
-
testComparator
public static <T> void testComparator(java.util.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> void testComparator(java.util.Comparator<? super T> comparator, java.util.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 java.lang.Comparable<? super T>> void testCompareToAndEquals(java.util.List<T> valuesInExpectedOrder)
-
misleadingSizeCollection
public static <T> java.util.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,V> java.util.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 java.lang.Comparable,V> java.lang.Iterable<java.util.Map.Entry<K,V>> orderEntriesByKey(java.util.List<java.util.Map.Entry<K,V>> insertionOrder)
-
getMethod
@GwtIncompatible public static java.lang.reflect.Method getMethod(java.lang.Class<?> clazz, java.lang.String name)
-
-