android.test
Class MoreAsserts

java.lang.Object
  android.test.MoreAsserts

public final class MoreAsserts
extends Object

Contains additional assertion methods not found in JUnit.

Method Summary

static void	assertAssignableFrom(Class<?> expected, Class<?> actual) Asserts that class expected is assignable from the class actual.
static void	assertAssignableFrom(Class<?> expected, Object actual) Asserts that the class expected is assignable from the object actual.
static MatchResult	assertContainsRegex(String expectedRegex, String actual) Variant of assertContainsRegex(String,String,String) using a generic message.
static MatchResult	assertContainsRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex matches any substring of actual and fails with message if it does not.
static void	assertContentsInAnyOrder(Iterable<?> actual, Object... expected) Variant of assertContentsInAnyOrder(String, Iterable, Object...) using a generic message.
static void	assertContentsInAnyOrder(String message, Iterable<?> actual, Object... expected) Asserts that actual contains precisely the elements expected, but in any order.
static void	assertContentsInOrder(Iterable<?> actual, Object... expected) Variant of assertContentsInOrder(String, Iterable, Object...) using a generic message.
static void	assertContentsInOrder(String message, Iterable<?> actual, Object... expected) Asserts that actual contains precisely the elements expected, and in the same order.
static void	assertEmpty(Iterable<?> iterable) Variant of assertEmpty(String, Iterable) using a generic message.
static void	assertEmpty(Map<?,?> map) Variant of assertEmpty(String, Map) using a generic message.
static void	assertEmpty(String message, Iterable<?> iterable) Asserts that iterable is empty.
static void	assertEmpty(String message, Map<?,?> map) Asserts that map is empty.
static void	assertEquals(byte[] expected, byte[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(double[] expected, double[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(int[] expected, int[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(Object[] expected, Object[] actual) Asserts that array actual is the same size and every element is the same as those in array expected.
static void	assertEquals(Set<? extends Object> expected, Set<? extends Object> actual) Asserts that two sets contain the same elements.
static void	assertEquals(String message, byte[] expected, byte[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, double[] expected, double[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, int[] expected, int[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, Object[] expected, Object[] actual) Asserts that array actual is the same size and every element is the same as those in array expected.
static void	assertEquals(String message, Set<? extends Object> expected, Set<? extends Object> actual) Asserts that two sets contain the same elements.
static MatchResult	assertMatchesRegex(String expectedRegex, String actual) Variant of assertMatchesRegex(String,String,String) using a generic message.
static MatchResult	assertMatchesRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex exactly matches actual and fails with message if it does not.
static void	assertNotContainsRegex(String expectedRegex, String actual) Variant of assertNotContainsRegex(String,String,String) using a generic message.
static void	assertNotContainsRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex does not match any substring of actual, and fails with message if it does.
static void	assertNotEmpty(Iterable<?> iterable) Variant of assertNotEmpty(String, Iterable) using a generic message.
static void	assertNotEmpty(Map<?,?> map) Variant of assertNotEmpty(String, Map) using a generic message.
static void	assertNotEmpty(String message, Iterable<?> iterable) Asserts that iterable is not empty.
static void	assertNotEmpty(String message, Map<?,?> map) Asserts that map is not empty.
static void	assertNotEqual(Object unexpected, Object actual) Variant of assertNotEqual(String,Object,Object) using a generic message.
static void	assertNotEqual(String message, Object unexpected, Object actual) Asserts that actual is not equal unexpected, according to both == and Object.equals(java.lang.Object).
static void	assertNotMatchesRegex(String expectedRegex, String actual) Variant of assertNotMatchesRegex(String,String,String) using a generic message.
static void	assertNotMatchesRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex does not exactly match actual, and fails with message if it does.
static void	checkEqualsAndHashCodeMethods(Object lhs, Object rhs, boolean expectedResult) Variant of checkEqualsAndHashCodeMethods(String,Object,Object,boolean...)} using a generic message.
static void	checkEqualsAndHashCodeMethods(String message, Object lhs, Object rhs, boolean expectedResult) Utility for testing equals() and hashCode() results at once.

Methods inherited from class java.lang.Object

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

Method Detail

assertAssignableFrom

public static void assertAssignableFrom(Class<?> expected,
                                        Object actual)

Asserts that the class expected is assignable from the object actual. This verifies expected is a parent class or a interface that actual implements.

assertAssignableFrom

public static void assertAssignableFrom(Class<?> expected,
                                        Class<?> actual)

Asserts that class expected is assignable from the class actual. This verifies expected is a parent class or a interface that actual implements.

assertNotEqual

public static void assertNotEqual(String message,
                                  Object unexpected,
                                  Object actual)

Asserts that actual is not equal unexpected, according to both == and Object.equals(java.lang.Object).

assertNotEqual

public static void assertNotEqual(Object unexpected,
                                  Object actual)

Variant of assertNotEqual(String,Object,Object) using a generic message.

assertEquals

public static void assertEquals(String message,
                                byte[] expected,
                                byte[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates specific element mismatch.

assertEquals

public static void assertEquals(byte[] expected,
                                byte[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates specific element mismatch.

assertEquals

public static void assertEquals(String message,
                                int[] expected,
                                int[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(int[] expected,
                                int[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(String message,
                                double[] expected,
                                double[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(double[] expected,
                                double[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(String message,
                                Object[] expected,
                                Object[] actual)

Asserts that array actual is the same size and every element is the same as those in array expected. Note that this uses equals() instead of == to compare the objects. null will be considered equal to {code null} (unlike SQL). On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(Object[] expected,
                                Object[] actual)

Asserts that array actual is the same size and every element is the same as those in array expected. Note that this uses == instead of equals() to compare the objects. On failure, message indicates first specific element mismatch.

assertEquals

public static void assertEquals(String message,
                                Set<? extends Object> expected,
                                Set<? extends Object> actual)

Asserts that two sets contain the same elements.

assertEquals

public static void assertEquals(Set<? extends Object> expected,
                                Set<? extends Object> actual)

Asserts that two sets contain the same elements.

assertMatchesRegex

public static MatchResult assertMatchesRegex(String message,
                                             String expectedRegex,
                                             String actual)

Asserts that expectedRegex exactly matches actual and fails with message if it does not. The MatchResult is returned in case the test needs access to any captured groups. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote(java.lang.String).

assertMatchesRegex

public static MatchResult assertMatchesRegex(String expectedRegex,
                                             String actual)

Variant of assertMatchesRegex(String,String,String) using a generic message.

assertContainsRegex

public static MatchResult assertContainsRegex(String message,
                                              String expectedRegex,
                                              String actual)

Asserts that expectedRegex matches any substring of actual and fails with message if it does not. The Matcher is returned in case the test needs access to any captured groups. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote(java.lang.String).

assertContainsRegex

public static MatchResult assertContainsRegex(String expectedRegex,
                                              String actual)

Variant of assertContainsRegex(String,String,String) using a generic message.

assertNotMatchesRegex

public static void assertNotMatchesRegex(String message,
                                         String expectedRegex,
                                         String actual)

Asserts that expectedRegex does not exactly match actual, and fails with message if it does. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote(java.lang.String).

assertNotMatchesRegex

public static void assertNotMatchesRegex(String expectedRegex,
                                         String actual)

Variant of assertNotMatchesRegex(String,String,String) using a generic message.

assertNotContainsRegex

public static void assertNotContainsRegex(String message,
                                          String expectedRegex,
                                          String actual)

Asserts that expectedRegex does not match any substring of actual, and fails with message if it does. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote(java.lang.String).

assertNotContainsRegex

public static void assertNotContainsRegex(String expectedRegex,
                                          String actual)

Variant of assertNotContainsRegex(String,String,String) using a generic message.

assertContentsInOrder

public static void assertContentsInOrder(String message,
                                         Iterable<?> actual,
                                         Object... expected)

Asserts that actual contains precisely the elements expected, and in the same order.

assertContentsInOrder

public static void assertContentsInOrder(Iterable<?> actual,
                                         Object... expected)

Variant of assertContentsInOrder(String, Iterable, Object...) using a generic message.

assertContentsInAnyOrder

public static void assertContentsInAnyOrder(String message,
                                            Iterable<?> actual,
                                            Object... expected)

Asserts that actual contains precisely the elements expected, but in any order.

assertContentsInAnyOrder

public static void assertContentsInAnyOrder(Iterable<?> actual,
                                            Object... expected)

Variant of assertContentsInAnyOrder(String, Iterable, Object...) using a generic message.

assertEmpty

public static void assertEmpty(String message,
                               Iterable<?> iterable)

Asserts that iterable is empty.

assertEmpty

public static void assertEmpty(Iterable<?> iterable)

Variant of assertEmpty(String, Iterable) using a generic message.

assertEmpty

public static void assertEmpty(String message,
                               Map<?,?> map)

Asserts that map is empty.

assertEmpty

public static void assertEmpty(Map<?,?> map)

Variant of assertEmpty(String, Map) using a generic message.

assertNotEmpty

public static void assertNotEmpty(String message,
                                  Iterable<?> iterable)

Asserts that iterable is not empty.

assertNotEmpty

public static void assertNotEmpty(Iterable<?> iterable)

Variant of assertNotEmpty(String, Iterable) using a generic message.

assertNotEmpty

public static void assertNotEmpty(String message,
                                  Map<?,?> map)

Asserts that map is not empty.

assertNotEmpty

public static void assertNotEmpty(Map<?,?> map)

Variant of assertNotEmpty(String, Map) using a generic message.

checkEqualsAndHashCodeMethods

public static void checkEqualsAndHashCodeMethods(String message,
                                                 Object lhs,
                                                 Object rhs,
                                                 boolean expectedResult)

Utility for testing equals() and hashCode() results at once. Tests that lhs.equals(rhs) matches expectedResult, as well as rhs.equals(lhs). Also tests that hashCode() return values are equal if expectedResult is true. (hashCode() is not tested if expectedResult is false, as unequal objects can have equal hashCodes.)

Parameters:

lhs - An Object for which equals() and hashCode() are to be tested.

rhs - As lhs.

expectedResult - True if the objects should compare equal, false if not.

checkEqualsAndHashCodeMethods

public static void checkEqualsAndHashCodeMethods(Object lhs,
                                                 Object rhs,
                                                 boolean expectedResult)

Variant of checkEqualsAndHashCodeMethods(String,Object,Object,boolean...)} using a generic message.