org.junit
Class Assert

java.lang.Object
  org.junit.Assert

public class Assert
extends java.lang.Object

A set of assertion methods useful for writing tests. Only failed assertions are recorded. These methods can be used directly: Assert.assertEquals(...), however, they read better if they are referenced through static import:

 import static org.junit.Assert.*;
    ...
    assertEquals(...);
 

See Also:

AssertionError

Constructor Summary

protected

Assert() Protect constructor since it is a static only class

Method Summary

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(java.lang.Object[] expecteds, java.lang.Object[] actuals) Asserts that two object arrays are equal.
static void	assertEquals(java.lang.Object expected, java.lang.Object actual) Asserts that two objects are equal.
static void	assertEquals(java.lang.String message, double expected, double actual, double delta) Asserts that two doubles are equal to within a positive delta.
static void	assertEquals(java.lang.String message, float expected, float actual, float delta) Asserts that two floats are equal to within a positive delta.
static void	assertEquals(java.lang.String message, java.lang.Object[] expecteds, java.lang.Object[] actuals) Asserts that two object arrays are equal.
static void	assertEquals(java.lang.String message, java.lang.Object expected, java.lang.Object actual) Asserts that two objects are equal.
static void	assertFalse(boolean condition) Asserts that a condition is false.
static void	assertFalse(java.lang.String message, boolean condition) Asserts that a condition is false.
static void	assertNotNull(java.lang.Object object) Asserts that an object isn't null.
static void	assertNotNull(java.lang.String message, java.lang.Object object) Asserts that an object isn't null.
static void	assertNotSame(java.lang.Object unexpected, java.lang.Object actual) Asserts that two objects do not refer to the same object.
static void	assertNotSame(java.lang.String message, java.lang.Object unexpected, java.lang.Object actual) Asserts that two objects do not refer to the same object.
static void	assertNull(java.lang.Object object) Asserts that an object is null.
static void	assertNull(java.lang.String message, java.lang.Object object) Asserts that an object is null.
static void	assertSame(java.lang.Object expected, java.lang.Object actual) Asserts that two objects refer to the same object.
static void	assertSame(java.lang.String message, java.lang.Object expected, java.lang.Object actual) Asserts that two objects refer to the same object.
static void	assertTrue(boolean condition) Asserts that a condition is true.
static void	assertTrue(java.lang.String message, boolean condition) Asserts that a condition is true.
static void	fail() Fails a test with no message.
static void	fail(java.lang.String message) Fails a test with the given message.

Methods inherited from class java.lang.Object

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

Constructor Detail

Assert

protected Assert()

Protect constructor since it is a static only class

Method Detail

assertTrue

public static void assertTrue(java.lang.String message,
                              boolean condition)

Asserts that a condition is true. If it isn't it throws an AssertionError with the given message.

Parameters:

message - the identifying message or null for the AssertionError

condition - condition to be checked

assertTrue

public static void assertTrue(boolean condition)

Asserts that a condition is true. If it isn't it throws an AssertionError without a message.

Parameters:

condition - condition to be checked

assertFalse

public static void assertFalse(java.lang.String message,
                               boolean condition)

Asserts that a condition is false. If it isn't it throws an AssertionError with the given message.

Parameters:

message - the identifying message or null for the AssertionError

condition - condition to be checked

assertFalse

public static void assertFalse(boolean condition)

Asserts that a condition is false. If it isn't it throws an AssertionError without a message.

Parameters:

condition - condition to be checked

fail

public static void fail(java.lang.String message)

Fails a test with the given message.

Parameters:

message - the identifying message or null for the AssertionError

See Also:

AssertionError

fail

public static void fail()

Fails a test with no message.

assertEquals

public static void assertEquals(java.lang.String message,
                                java.lang.Object expected,
                                java.lang.Object actual)

Asserts that two objects are equal. If they are not, an AssertionError is thrown with the given message. If expected and actual are null, they are considered equal.

Parameters:

message - the identifying message or null for the AssertionError

expected - expected value

actual - actual value

assertEquals

public static void assertEquals(java.lang.Object expected,
                                java.lang.Object actual)

Asserts that two objects are equal. If they are not, an AssertionError without a message is thrown. If expected and actual are null, they are considered equal.

Parameters:

expected - expected value

actual - the value to check against expected

assertEquals

public static void assertEquals(java.lang.String message,
                                java.lang.Object[] expecteds,
                                java.lang.Object[] actuals)

Asserts that two object arrays are equal. If they are not, an AssertionError is thrown with the given message. If expecteds and actuals are null, they are considered equal.

Parameters:

message - the identifying message or null for the AssertionError

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

assertEquals

public static void assertEquals(java.lang.Object[] expecteds,
                                java.lang.Object[] actuals)

Asserts that two object arrays are equal. If they are not, an AssertionError is thrown. If expected and actual are null, they are considered equal.

Parameters:

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

assertEquals

public static void assertEquals(java.lang.String message,
                                double expected,
                                double actual,
                                double delta)

Asserts that two doubles are equal to within a positive delta. If they are not, an 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, *) passes

Parameters:

message - the identifying message or null for the AssertionError

expected - expected value

actual - the value to check against expected

delta - the maximum delta between expected and actual for which both numbers are still considered equal.

assertEquals

public static void assertEquals(double expected,
                                double actual,
                                double delta)

Asserts that two doubles are equal to within a positive delta. If they are not, an AssertionError is thrown. If the expected value is infinity then the delta value is ignored.NaNs are considered equal: assertEquals(Double.NaN, Double.NaN, *) passes

Parameters:

expected - expected value

actual - the value to check against expected

delta - the maximum delta between expected and actual for which both numbers are still considered equal.

assertEquals

public static void assertEquals(java.lang.String message,
                                float expected,
                                float actual,
                                float delta)

Asserts that two floats are equal to within a positive delta. If they are not, an 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, *) passes

Parameters:

message - the identifying message or null for the AssertionError

expected - the expected float value

actual - the float value to check against expected

delta - the maximum delta between expected and actual for which both numbers are still considered equal.

assertEquals

public static void assertEquals(float expected,
                                float actual,
                                float delta)

Asserts that two floats are equal to within a positive delta. If they are not, an AssertionError is thrown. If the expected value is infinity then the delta value is ignored. NaNs are considered equal: assertEquals(Float.NaN, Float.NaN, *) passes

Parameters:

expected - the expected value

actual - the value to check against expected

delta - the maximum delta between expected and actual for which both numbers are still considered equal.

assertNotNull

public static void assertNotNull(java.lang.String message,
                                 java.lang.Object object)

Asserts that an object isn't null. If it is an AssertionError is thrown with the given message.

Parameters:

message - the identifying message or null for the AssertionError

object - Object to check or null

assertNotNull

public static void assertNotNull(java.lang.Object object)

Asserts that an object isn't null. If it is an AssertionError is thrown.

Parameters:

object - Object to check or null

assertNull

public static void assertNull(java.lang.String message,
                              java.lang.Object object)

Asserts that an object is null. If it is not, an AssertionError is thrown with the given message.

Parameters:

message - the identifying message or null for the AssertionError

object - Object to check or null

assertNull

public static void assertNull(java.lang.Object object)

Asserts that an object is null. If it isn't an AssertionError is thrown.

Parameters:

object - Object to check or null

assertSame

public static void assertSame(java.lang.String message,
                              java.lang.Object expected,
                              java.lang.Object actual)

Asserts that two objects refer to the same object. If they are not, an AssertionError is thrown with the given message.

Parameters:

message - the identifying message or null for the AssertionError

expected - the expected object

actual - the object to compare to expected

assertSame

public static void assertSame(java.lang.Object expected,
                              java.lang.Object actual)

Asserts that two objects refer to the same object. If they are not the same, an AssertionError without a message is thrown.

Parameters:

expected - the expected object

actual - the object to compare to expected

assertNotSame

public static void assertNotSame(java.lang.String message,
                                 java.lang.Object unexpected,
                                 java.lang.Object actual)

Asserts that two objects do not refer to the same object. If they do refer to the same object, an AssertionError is thrown with the given message.

Parameters:

message - the identifying message or null for the AssertionError

unexpected - the object you don't expect

actual - the object to compare to unexpected

assertNotSame

public static void assertNotSame(java.lang.Object unexpected,
                                 java.lang.Object actual)

Asserts that two objects do not refer to the same object. If they do refer to the same object, an AssertionError without a message is thrown.

Parameters:

unexpected - the object you don't expect

actual - the object to compare to unexpected