Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
package xapi.test;
import xapi.util.api.MatchesValue;
/**
* Some basic assertion utilities; based on org.junit.Assert,
* but without gwt-unfriendly capabilities, like the use of java.lang.reflect.Array.
*
* @author "James X. Nelson ([email protected])"
*
*/
public class Assert {
/**
* Protect constructor since it is a static only class
*/
protected Assert() {
}
/**
* Asserts that a condition is true. If it isn't it throws an
* {@link AssertionError} with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param condition
* condition to be checked
*/
static public void assertTrue(String message, boolean condition) {
if (!condition)
fail(message);
}
/**
* Asserts that a condition is true. If it isn't it throws an
* {@link AssertionError} without a message.
*
* @param condition
* condition to be checked
*/
static public void assertTrue(boolean condition) {
assertTrue(null, condition);
}
/**
* Asserts that a condition is false. If it isn't it throws an
* {@link AssertionError} with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param condition
* condition to be checked
*/
static public void assertFalse(String message, boolean condition) {
assertTrue(message, !condition);
}
/**
* Asserts that a condition is false. If it isn't it throws an
* {@link AssertionError} without a message.
*
* @param condition
* condition to be checked
*/
static public void assertFalse(boolean condition) {
assertFalse(null, condition);
}
/**
* Fails a test with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @see AssertionError
*/
static public void fail(String message) {
throw new AssertionError(message == null ? "" : message);
}
/**
* Fails a test with no message.
*/
static public void fail() {
fail(null);
}
/**
* Asserts that two objects are equal. If they are not, an
* {@link AssertionError} is thrown with the given message. If
* expected and actual are null,
* they are considered equal.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expected
* expected value
* @param actual
* actual value
*/
static public void assertEquals(String message, Object expected,
Object actual) {
if (expected == null && actual == null)
return;
if (expected != null && isEquals(expected, actual))
return;
else if (expected instanceof String && actual instanceof String) {
String cleanMessage= message == null ? "" : message;
throw asssertionError(cleanMessage, expected, actual);
} else
failNotEquals(message, expected, actual);
}
private static AssertionError asssertionError(String cleanMessage, Object expected, Object actual) {
return new AssertionError("Expected: "+ expected +"\nReceived:"+
actual+"\n["+cleanMessage+"]");
}
private static boolean isEquals(Object expected, Object actual) {
return expected.equals(actual);
}
/**
* Asserts that two objects are equal. If they are not, an
* {@link AssertionError} without a message is thrown. If
* expected and actual are null,
* they are considered equal.
*
* @param expected
* expected value
* @param actual
* the value to check against expected
*/
static public void assertEquals(Object expected, Object actual) {
assertEquals(null, expected, actual);
}
/**
* Asserts that two object arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message. If
* expecteds and actuals are null,
* they are considered equal.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* Object array or array of arrays (multi-dimensional array) with
* expected values.
* @param actuals
* Object array or array of arrays (multi-dimensional array) with
* actual values
*/
public static void assertArrayEquals(String message, Object[] expecteds,
Object[] actuals) throws AssertionError {
internalArrayEquals(message, expecteds, actuals);
}
/**
* Asserts that two object arrays are equal. If they are not, an
* {@link AssertionError} is thrown. If expected and
* actual are null, they are considered
* equal.
*
* @param expecteds
* Object array or array of arrays (multi-dimensional array) with
* expected values
* @param actuals
* Object array or array of arrays (multi-dimensional array) with
* actual values
*/
public static void assertArrayEquals(Object[] expecteds, Object[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two byte arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* byte array with expected values.
* @param actuals
* byte array with actual values
*/
public static void assertArrayEquals(String message, byte[] expected,
byte[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] != actual[i]) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two byte arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* byte array with expected values.
* @param actuals
* byte array with actual values
*/
public static void assertArrayEquals(byte[] expecteds, byte[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two char arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* char array with expected values.
* @param actuals
* char array with actual values
*/
public static void assertArrayEquals(String message, char[] expected,
char[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] != actual[i]) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two char arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* char array with expected values.
* @param actuals
* char array with actual values
*/
public static void assertArrayEquals(char[] expecteds, char[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two short arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* short array with expected values.
* @param actuals
* short array with actual values
*/
public static void assertArrayEquals(String message, short[] expected,
short[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] != actual[i]) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two short arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* short array with expected values.
* @param actuals
* short array with actual values
*/
public static void assertArrayEquals(short[] expecteds, short[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two int arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* int array with expected values.
* @param actuals
* int array with actual values
*/
public static void assertArrayEquals(String message, int[] expected,
int[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] != actual[i]) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two int arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* int array with expected values.
* @param actuals
* int array with actual values
*/
public static void assertArrayEquals(int[] expecteds, int[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two long arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* long array with expected values.
* @param actuals
* long array with actual values
*/
public static void assertArrayEquals(String message, long[] expected,
long[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] != actual[i]) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two long arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* long array with expected values.
* @param actuals
* long array with actual values
*/
public static void assertArrayEquals(long[] expecteds, long[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two double arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* double array with expected values.
* @param actuals
* double array with actual values
*/
public static void assertArrayEquals(double[] expecteds, double[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two double arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
* @param message
* debug message
* @param expecteds
* double array with expected values.
* @param actuals
* double array with actual values
*/
public static void assertArrayEquals(String message, double[] expected, double[] actual) {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
double delta = expected[i] - actual[i];
if (Math.abs(delta) > 0.00000000000001) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two float arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expecteds
* float array with expected values.
* @param actuals
* float array with actual values
*/
public static void assertArrayEquals(float[] expecteds, float[] actuals) {
assertArrayEquals(null, expecteds, actuals);
}
/**
* Asserts that two float arrays are equal. If they are not, an
* {@link AssertionError} is thrown.
* @param message
* debug message
* @param expecteds
* float array with expected values.
* @param actuals
* float array with actual values
*/
public static void assertArrayEquals(String message, float[] expected, float[] actual) {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
float delta = expected[i] - actual[i];
if (Math.abs(delta) > 0.0000000001f) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
/**
* Asserts that two object arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message. If
* expecteds and actuals are null,
* they are considered equal.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* Object array or array of arrays (multi-dimensional array) with
* expected values.
* @param actuals
* Object array or array of arrays (multi-dimensional array) with
* actual values
*/
private static void internalArrayEquals(String message, T[] expected,
T[] actual) throws AssertionError {
if (expected.length != actual.length) {
throw new AssertionError("Expected array length: "+expected.length+"\n" +
"Received: "+actual.length+(message==null?"":"\n"+message));
}
for (int i = expected.length; i-->0;) {
if (expected[i] == null) {
if (actual[i] != null) {
throw newArrayFail(i, expected[i], actual[i]);
}
} else {
if (!expected[i].equals(actual[i])) {
throw newArrayFail(i, expected[i], actual[i]);
}
}
}
}
private static AssertionError newArrayFail(int index, Object expected, Object actual) {
return new AssertionError("Array comparison failure at index " +
index+"\n" +
"Expected " +expected+ ", " +
"got: "+actual);
}
/**
* Asserts that two doubles or floats are equal to within a positive delta.
* If they are not, an {@link 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
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expected
* expected value
* @param actual
* the value to check against expected
* @param delta
* the maximum delta between expected and
* actual for which both numbers are still
* considered equal.
*/
static public void assertEquals(String message, double expected,
double actual, double delta) {
if (Double.compare(expected, actual) == 0)
return;
if (!(Math.abs(expected - actual) <= delta))
failNotEquals(message, new Double(expected), new Double(actual));
}
/**
* Asserts that two longs are equal. If they are not, an
* {@link AssertionError} is thrown.
*
* @param expected
* expected long value.
* @param actual
* actual long value
*/
static public void assertEquals(long expected, long actual) {
assertEquals(null, expected, actual);
}
/**
* Asserts that two longs are equal. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expected
* long expected value.
* @param actual
* long actual value
*/
static public void assertEquals(String message, long expected, long actual) {
assertEquals(message, (Long) expected, (Long) actual);
}
/**
* @deprecated Use
* assertEquals(double expected, double actual, double epsilon)
* instead
*/
@Deprecated
static public void assertEquals(double expected, double actual) {
assertEquals(null, expected, actual);
}
/**
* @deprecated Use
* assertEquals(String message, double expected, double actual, double epsilon)
* instead
*/
@Deprecated
static public void assertEquals(String message, double expected,
double actual) {
fail("Use assertEquals(expected, actual, delta) to compare floating-point numbers");
}
/**
* Asserts that two doubles or floats are equal to within a positive delta.
* If they are not, an {@link 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
*
* @param expected
* expected value
* @param actual
* the value to check against expected
* @param delta
* the maximum delta between expected and
* actual for which both numbers are still
* considered equal.
*/
static public void assertEquals(double expected, double actual, double delta) {
assertEquals(null, expected, actual, delta);
}
/**
* Asserts that an object isn't null. If it is an {@link AssertionError} is
* thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param object
* Object to check or null
*/
static public void assertNotNull(String message, Object object) {
assertTrue(message, object != null);
}
/**
* Asserts that an object isn't null. If it is an {@link AssertionError} is
* thrown.
*
* @param object
* Object to check or null
*/
static public void assertNotNull(Object object) {
assertNotNull(null, object);
}
/**
* Asserts that an object is null. If it is not, an {@link AssertionError}
* is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param object
* Object to check or null
*/
static public void assertNull(String message, Object object) {
assertTrue(message, object == null);
}
/**
* Asserts that an object is null. If it isn't an {@link AssertionError} is
* thrown.
*
* @param object
* Object to check or null
*/
static public void assertNull(Object object) {
assertNull(null, object);
}
/**
* Asserts that two objects refer to the same object. If they are not, an
* {@link AssertionError} is thrown with the given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expected
* the expected object
* @param actual
* the object to compare to expected
*/
static public void assertSame(String message, Object expected, Object actual) {
if (expected == actual)
return;
failNotSame(message, expected, actual);
}
/**
* Asserts that two objects refer to the same object. If they are not the
* same, an {@link AssertionError} without a message is thrown.
*
* @param expected
* the expected object
* @param actual
* the object to compare to expected
*/
static public void assertSame(Object expected, Object actual) {
assertSame(null, expected, actual);
}
/**
* Asserts that two objects do not refer to the same object. If they do
* refer to the same object, an {@link AssertionError} is thrown with the
* given message.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param unexpected
* the object you don't expect
* @param actual
* the object to compare to unexpected
*/
static public void assertNotSame(String message, Object unexpected,
Object actual) {
if (unexpected == actual)
failSame(message);
}
/**
* Asserts that two objects do not refer to the same object. If they do
* refer to the same object, an {@link AssertionError} without a message is
* thrown.
*
* @param unexpected
* the object you don't expect
* @param actual
* the object to compare to unexpected
*/
static public void assertNotSame(Object unexpected, Object actual) {
assertNotSame(null, unexpected, actual);
}
static private void failSame(String message) {
String formatted= "";
if (message != null)
formatted= message + " ";
fail(formatted + "expected not same");
}
static private void failNotSame(String message, Object expected,
Object actual) {
String formatted= "";
if (message != null)
formatted= message + " ";
fail(formatted + "expected same:<" + expected + "> was not:<" + actual
+ ">");
}
static private void failNotEquals(String message, Object expected,
Object actual) {
fail(format(message, expected, actual));
}
static String format(String message, Object expected, Object actual) {
String formatted= "";
if (message != null && !message.equals(""))
formatted= message + " ";
String expectedString= String.valueOf(expected);
String actualString= String.valueOf(actual);
if (expectedString.equals(actualString))
return formatted + "expected: "
+ formatClassAndValue(expected, expectedString)
+ " but was: " + formatClassAndValue(actual, actualString);
else
return formatted + "expected:<" + expectedString + "> but was:<"
+ actualString + ">";
}
private static String formatClassAndValue(Object value, String valueString) {
String className= value == null ? "null" : value.getClass().getName();
return className + "<" + valueString + ">";
}
/**
* Asserts that two object arrays are equal. If they are not, an
* {@link AssertionError} is thrown with the given message. If
* expecteds and actuals are null,
* they are considered equal.
*
* @param message
* the identifying message for the {@link AssertionError} (null
* okay)
* @param expecteds
* Object array or array of arrays (multi-dimensional array) with
* expected values.
* @param actuals
* Object array or array of arrays (multi-dimensional array) with
* actual values
* @deprecated use assertArrayEquals
*/
@Deprecated
public static void assertEquals(String message, Object[] expecteds,
Object[] actuals) {
assertArrayEquals(message, expecteds, actuals);
}
/**
* Asserts that two object arrays are equal. If they are not, an
* {@link AssertionError} is thrown. If expected and
* actual are null, they are considered
* equal.
*
* @param expecteds
* Object array or array of arrays (multi-dimensional array) with
* expected values
* @param actuals
* Object array or array of arrays (multi-dimensional array) with
* actual values
* @deprecated use assertArrayEquals
*/
@Deprecated
public static void assertEquals(Object[] expecteds, Object[] actuals) {
assertArrayEquals(expecteds, actuals);
}
/**
* Asserts that actual satisfies the condition specified by
* matcher. If not, an {@link AssertionError} is thrown with
* information about the matcher and failing value. Example:
*
*
*
* @param
* the static type accepted by the matcher (this can flag obvious
* compile-time problems such as {@code assertThat(1, is("a"))}
* @param actual
* the computed value being compared
* @param matcher
* an expression, built of {@link Matcher}s, specifying allowed
* values
*
* @see org.hamcrest.CoreMatchers
* @see org.junit.matchers.JUnitMatchers
*/
public static void assertThat(T actual, MatchesValue matcher) {
assertThat("", actual, matcher);
}
/**
* Asserts that actual satisfies the condition specified by
* matcher. If not, an {@link AssertionError} is thrown with
* the reason and information about the matcher and failing value. Example:
*
*
*
* @param reason
* additional information about the error
* @param
* the static type accepted by the matcher (this can flag obvious
* compile-time problems such as {@code assertThat(1, is("a"))}
* @param actual
* the computed value being compared
* @param matcher
* an expression, built of {@link Matcher}s, specifying allowed
* values
*
* @see org.hamcrest.CoreMatchers
* @see org.junit.matchers.JUnitMatchers
*/
public static void assertThat(String reason, T actual,
MatchesValue matcher) {
if (!matcher.matches(actual)) {
throw new java.lang.AssertionError("Item "+actual+" does not match "+matcher
+". "+(reason == null ? "" : "\n["+reason+"]"));
}
}
}
