public class Assert extends Object
Assert.assertEquals(...), however, they read better if they
are referenced through static import:
import static org.junit.Assert.*;
...
assertEquals(...);
AssertionError| Modifier | Constructor and Description |
|---|---|
protected |
Assert()
Protect constructor since it is a static only class
|
| Modifier and Type | Method and Description |
|---|---|
static void |
assertArrayEquals(byte[] expecteds,
byte[] actuals)
Asserts that two byte arrays are equal.
|
static void |
assertArrayEquals(char[] expecteds,
char[] actuals)
Asserts that two char arrays are equal.
|
static void |
assertArrayEquals(double[] expecteds,
double[] actuals,
double delta)
Asserts that two double arrays are equal.
|
static void |
assertArrayEquals(float[] expecteds,
float[] actuals,
float delta)
Asserts that two float arrays are equal.
|
static void |
assertArrayEquals(int[] expecteds,
int[] actuals)
Asserts that two int arrays are equal.
|
static void |
assertArrayEquals(long[] expecteds,
long[] actuals)
Asserts that two long arrays are equal.
|
static void |
assertArrayEquals(Object[] expecteds,
Object[] actuals)
Asserts that two object arrays are equal.
|
static void |
assertArrayEquals(short[] expecteds,
short[] actuals)
Asserts that two short arrays are equal.
|
static void |
assertArrayEquals(String message,
byte[] expecteds,
byte[] actuals)
Asserts that two byte arrays are equal.
|
static void |
assertArrayEquals(String message,
char[] expecteds,
char[] actuals)
Asserts that two char arrays are equal.
|
static void |
assertArrayEquals(String message,
double[] expecteds,
double[] actuals,
double delta)
Asserts that two double arrays are equal.
|
static void |
assertArrayEquals(String message,
float[] expecteds,
float[] actuals,
float delta)
Asserts that two float arrays are equal.
|
static void |
assertArrayEquals(String message,
int[] expecteds,
int[] actuals)
Asserts that two int arrays are equal.
|
static void |
assertArrayEquals(String message,
long[] expecteds,
long[] actuals)
Asserts that two long arrays are equal.
|
static void |
assertArrayEquals(String message,
Object[] expecteds,
Object[] actuals)
Asserts that two object arrays are equal.
|
static void |
assertArrayEquals(String message,
short[] expecteds,
short[] actuals)
Asserts that two short arrays are equal.
|
static void |
assertEquals(double expected,
double actual)
Deprecated.
Use
assertEquals(double expected, double actual, double delta)
instead |
static void |
assertEquals(double expected,
double actual,
double delta)
Asserts that two doubles are equal to within a positive delta.
|
static void |
assertEquals(float expected,
float actual,
float delta)
Asserts that two floats are equal to within a positive delta.
|
static void |
assertEquals(long expected,
long actual)
Asserts that two longs are equal.
|
static void |
assertEquals(Object[] expecteds,
Object[] actuals)
Deprecated.
use assertArrayEquals
|
static void |
assertEquals(Object expected,
Object actual)
Asserts that two objects are equal.
|
static void |
assertEquals(String message,
double expected,
double actual)
Deprecated.
Use
assertEquals(String message, double expected, double actual, double delta)
instead |
static void |
assertEquals(String message,
double expected,
double actual,
double delta)
Asserts that two doubles are equal to within a positive delta.
|
static void |
assertEquals(String message,
float expected,
float actual,
float delta)
Asserts that two floats are equal to within a positive delta.
|
static void |
assertEquals(String message,
long expected,
long actual)
Asserts that two longs are equal.
|
static void |
assertEquals(String message,
Object[] expecteds,
Object[] actuals)
Deprecated.
use assertArrayEquals
|
static void |
assertEquals(String message,
Object expected,
Object actual)
Asserts that two objects are equal.
|
static void |
assertFalse(boolean condition)
Asserts that a condition is false.
|
static void |
assertFalse(String message,
boolean condition)
Asserts that a condition is false.
|
static void |
assertNotEquals(double first,
double second,
double delta)
Asserts that two doubles or floats are not equal to within a positive delta.
|
static void |
assertNotEquals(long first,
long second)
Asserts that two longs are not equals.
|
static void |
assertNotEquals(Object first,
Object second)
Asserts that two objects are not equals.
|
static void |
assertNotEquals(String message,
double first,
double second,
double delta)
Asserts that two doubles or floats are not equal to within a positive delta.
|
static void |
assertNotEquals(String message,
long first,
long second)
Asserts that two longs are not equals.
|
static void |
assertNotEquals(String message,
Object first,
Object second)
Asserts that two objects are not equals.
|
static void |
assertNotNull(Object object)
Asserts that an object isn't null.
|
static void |
assertNotNull(String message,
Object object)
Asserts that an object isn't null.
|
static void |
assertNotSame(Object unexpected,
Object actual)
Asserts that two objects do not refer to the same object.
|
static void |
assertNotSame(String message,
Object unexpected,
Object actual)
Asserts that two objects do not refer to the same object.
|
static void |
assertNull(Object object)
Asserts that an object is null.
|
static void |
assertNull(String message,
Object object)
Asserts that an object is null.
|
static void |
assertSame(Object expected,
Object actual)
Asserts that two objects refer to the same object.
|
static void |
assertSame(String message,
Object expected,
Object actual)
Asserts that two objects refer to the same object.
|
static <T> void |
assertThat(String reason,
T actual,
Matcher<? super T> matcher)
Asserts that
actual satisfies the condition specified by
matcher. |
static <T> void |
assertThat(T actual,
Matcher<? super T> matcher)
Asserts that
actual satisfies the condition specified by
matcher. |
static void |
assertTrue(boolean condition)
Asserts that a condition is true.
|
static void |
assertTrue(String message,
boolean condition)
Asserts that a condition is true.
|
static void |
fail()
Fails a test with no message.
|
static void |
fail(String message)
Fails a test with the given message.
|
public static void assertTrue(String message, boolean condition)
AssertionError with the given message.message - the identifying message for the AssertionError (null
okay)condition - condition to be checkedpublic static void assertTrue(boolean condition)
AssertionError without a message.condition - condition to be checkedpublic static void assertFalse(String message, boolean condition)
AssertionError with the given message.message - the identifying message for the AssertionError (null
okay)condition - condition to be checkedpublic static void assertFalse(boolean condition)
AssertionError without a message.condition - condition to be checkedpublic static void fail(String message)
message - the identifying message for the AssertionError (null
okay)AssertionErrorpublic static void fail()
public static void assertEquals(String message, Object expected, Object actual)
AssertionError is thrown with the given message. If
expected and actual are null,
they are considered equal.message - the identifying message for the AssertionError (null
okay)expected - expected valueactual - actual valuepublic static void assertEquals(Object expected, Object actual)
AssertionError without a message is thrown. If
expected and actual are null,
they are considered equal.expected - expected valueactual - the value to check against expectedpublic static void assertNotEquals(String message, Object first, Object second)
AssertionError is thrown with the given message. If
first and second are null,
they are considered equal.message - the identifying message for the AssertionError (null
okay)first - first value to checksecond - the value to check against firstpublic static void assertNotEquals(Object first, Object second)
AssertionError without a message is thrown. If
first and second are null,
they are considered equal.first - first value to checksecond - the value to check against firstpublic static void assertNotEquals(String message, long first, long second)
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)first - first value to checksecond - the value to check against firstpublic static void assertNotEquals(long first,
long second)
AssertionError without a message is thrown.first - first value to checksecond - the value to check against firstpublic static void assertNotEquals(String message, double first, double second, double delta)
AssertionError is thrown with the given
message. If the expected value is infinity then the delta value is
ignored. NaNs are considered equal:
assertNotEquals(Double.NaN, Double.NaN, *) failsmessage - the identifying message for the AssertionError (null
okay)first - first value to checksecond - the value to check against firstdelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertNotEquals(double first,
double second,
double delta)
AssertionError is thrown. If the expected
value is infinity then the delta value is ignored.NaNs are considered
equal: assertNotEquals(Double.NaN, Double.NaN, *) failsfirst - first value to checksecond - the value to check against firstdelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertArrayEquals(String message, Object[] expecteds, Object[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message. If
expecteds and actuals are null,
they are considered equal.message - the identifying message for the AssertionError (null
okay)expecteds - Object array or array of arrays (multi-dimensional array) with
expected values.actuals - Object array or array of arrays (multi-dimensional array) with
actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(Object[] expecteds, Object[] actuals)
AssertionError is thrown. If expected and
actual are null, they are considered
equal.expecteds - Object array or array of arrays (multi-dimensional array) with
expected valuesactuals - Object array or array of arrays (multi-dimensional array) with
actual valuespublic static void assertArrayEquals(String message, byte[] expecteds, byte[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - byte array with expected values.actuals - byte array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(byte[] expecteds,
byte[] actuals)
AssertionError is thrown.expecteds - byte array with expected values.actuals - byte array with actual valuespublic static void assertArrayEquals(String message, char[] expecteds, char[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - char array with expected values.actuals - char array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(char[] expecteds,
char[] actuals)
AssertionError is thrown.expecteds - char array with expected values.actuals - char array with actual valuespublic static void assertArrayEquals(String message, short[] expecteds, short[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - short array with expected values.actuals - short array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(short[] expecteds,
short[] actuals)
AssertionError is thrown.expecteds - short array with expected values.actuals - short array with actual valuespublic static void assertArrayEquals(String message, int[] expecteds, int[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - int array with expected values.actuals - int array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(int[] expecteds,
int[] actuals)
AssertionError is thrown.expecteds - int array with expected values.actuals - int array with actual valuespublic static void assertArrayEquals(String message, long[] expecteds, long[] actuals) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - long array with expected values.actuals - long array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(long[] expecteds,
long[] actuals)
AssertionError is thrown.expecteds - long array with expected values.actuals - long array with actual valuespublic static void assertArrayEquals(String message, double[] expecteds, double[] actuals, double delta) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - double array with expected values.actuals - double array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(double[] expecteds,
double[] actuals,
double delta)
AssertionError is thrown.expecteds - double array with expected values.actuals - double array with actual valuespublic static void assertArrayEquals(String message, float[] expecteds, float[] actuals, float delta) throws org.junit.internal.ArrayComparisonFailure
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expecteds - float array with expected values.actuals - float array with actual valuesorg.junit.internal.ArrayComparisonFailurepublic static void assertArrayEquals(float[] expecteds,
float[] actuals,
float delta)
AssertionError is thrown.expecteds - float array with expected values.actuals - float array with actual valuespublic static void assertEquals(String message, double expected, double actual, double delta)
AssertionError is thrown with the given
message. If the expected value is infinity then the delta value is
ignored. NaNs are considered equal:
assertEquals(Double.NaN, Double.NaN, *) passesmessage - the identifying message for the AssertionError (null
okay)expected - expected valueactual - the value to check against expecteddelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertEquals(String message, float expected, float actual, float delta)
AssertionError is thrown with the given
message. If the expected value is infinity then the delta value is
ignored. NaNs are considered equal:
assertEquals(Float.NaN, Float.NaN, *) passesmessage - the identifying message for the AssertionError (null
okay)expected - expected valueactual - the value to check against expecteddelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertEquals(long expected,
long actual)
AssertionError is thrown.expected - expected long value.actual - actual long valuepublic static void assertEquals(String message, long expected, long actual)
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expected - long expected value.actual - long actual value@Deprecated public static void assertEquals(double expected, double actual)
assertEquals(double expected, double actual, double delta)
instead@Deprecated public static void assertEquals(String message, double expected, double actual)
assertEquals(String message, double expected, double actual, double delta)
insteadpublic static void assertEquals(double expected,
double actual,
double delta)
AssertionError is thrown. If the expected
value is infinity then the delta value is ignored.NaNs are considered
equal: assertEquals(Double.NaN, Double.NaN, *) passesexpected - expected valueactual - the value to check against expecteddelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertEquals(float expected,
float actual,
float delta)
AssertionError is thrown. If the expected
value is infinity then the delta value is ignored. NaNs are considered
equal: assertEquals(Float.NaN, Float.NaN, *) passesexpected - expected valueactual - the value to check against expecteddelta - the maximum delta between expected and
actual for which both numbers are still
considered equal.public static void assertNotNull(String message, Object object)
AssertionError is
thrown with the given message.message - the identifying message for the AssertionError (null
okay)object - Object to check or nullpublic static void assertNotNull(Object object)
AssertionError is
thrown.object - Object to check or nullpublic static void assertNull(String message, Object object)
AssertionError
is thrown with the given message.message - the identifying message for the AssertionError (null
okay)object - Object to check or nullpublic static void assertNull(Object object)
AssertionError is
thrown.object - Object to check or nullpublic static void assertSame(String message, Object expected, Object actual)
AssertionError is thrown with the given message.message - the identifying message for the AssertionError (null
okay)expected - the expected objectactual - the object to compare to expectedpublic static void assertSame(Object expected, Object actual)
AssertionError without a message is thrown.expected - the expected objectactual - the object to compare to expectedpublic static void assertNotSame(String message, Object unexpected, Object actual)
AssertionError is thrown with the
given message.message - the identifying message for the AssertionError (null
okay)unexpected - the object you don't expectactual - the object to compare to unexpectedpublic static void assertNotSame(Object unexpected, Object actual)
AssertionError without a message is
thrown.unexpected - the object you don't expectactual - the object to compare to unexpected@Deprecated public static void assertEquals(String message, Object[] expecteds, Object[] actuals)
AssertionError is thrown with the given message. If
expecteds and actuals are null,
they are considered equal.message - the identifying message for the AssertionError (null
okay)expecteds - Object array or array of arrays (multi-dimensional array) with
expected values.actuals - Object array or array of arrays (multi-dimensional array) with
actual values@Deprecated public static void assertEquals(Object[] expecteds, Object[] actuals)
AssertionError is thrown. If expected and
actual are null, they are considered
equal.expecteds - Object array or array of arrays (multi-dimensional array) with
expected valuesactuals - Object array or array of arrays (multi-dimensional array) with
actual valuespublic static <T> void assertThat(T actual,
Matcher<? super T> matcher)
actual satisfies the condition specified by
matcher. If not, an AssertionError is thrown with
information about the matcher and failing value. Example:
assertThat(0, is(1)); // fails:
// failure message:
// expected: is <1>
// got value: <0>
assertThat(0, is(not(1))) // passes
org.hamcrest.Matcher does not currently document the meaning
of its type parameter T. This method assumes that a matcher
typed as Matcher<T> can be meaningfully applied only
to values that could be assigned to a variable of type T.T - the static type accepted by the matcher (this can flag obvious
compile-time problems such as assertThat(1, is("a"))actual - the computed value being comparedmatcher - an expression, built of Matchers, specifying allowed
valuesCoreMatchers,
MatcherAssertpublic static <T> void assertThat(String reason, T actual, Matcher<? super T> matcher)
actual satisfies the condition specified by
matcher. If not, an AssertionError is thrown with
the reason and information about the matcher and failing value. Example:
assertThat("Help! Integers don't work", 0, is(1)); // fails:
// failure message:
// Help! Integers don't work
// expected: is <1>
// got value: <0>
assertThat("Zero is one", 0, is(not(1))) // passes
org.hamcrest.Matcher does not currently document the meaning
of its type parameter T. This method assumes that a matcher
typed as Matcher<T> can be meaningfully applied only
to values that could be assigned to a variable of type T.T - the static type accepted by the matcher (this can flag obvious
compile-time problems such as assertThat(1, is("a"))reason - additional information about the erroractual - the computed value being comparedmatcher - an expression, built of Matchers, specifying allowed
valuesCoreMatchers,
MatcherAssert