Class TestUtil
java.lang.Object
com.gargoylesoftware.base.testing.TestUtil
Utility methods dealing with JUnit testing.
- Version:
- $Revision: 1.6 $
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
appearsEqual
(Object a, Object b) Return true if the two objects appear to be equal.static void
assertAppearsEqual
(String message, Object a, Object b) Assert that a and b appear equal.static void
assertAppearsNotEqual
(String message, Object a, Object b) Assert that a and b do not appear equal.static final void
assertNotNull
(String fieldName, Object fieldValue) Verify that the specified value is not null.private static void
checkEquality
(Object original, Object copy) Assert that the two objects are equalstatic Object
copyBySerialization
(Object object) Copy an object by serializing it into a buffer and then deserializing it again.private static boolean
static void
The the clone() method on an object.static Object
testSerialization
(Object object) Same as testSerialization(object, true).static Object
testSerialization
(Object object, boolean checkEquality) Serialize the specified object to a stream and then deserialize it again.
-
Constructor Details
-
TestUtil
private TestUtil()
-
-
Method Details
-
testSerialization
Serialize the specified object to a stream and then deserialize it again. This tests the following things:- Ensures that the original and reconstructed objects are equal.
- The object can be serialized
- Parameters:
object
- The object to testcheckEquality
- True if the original and copy should be equal according to the semantics of the equals() method.- Returns:
- The copy.
- Throws:
IOException
- If an error occcurs during serialization.
-
testSerialization
Same as testSerialization(object, true). Provided as a convenience as the equality check is usually wanted.- Parameters:
object
- The object to test- Returns:
- The copy.
- Throws:
IOException
- If an error occcurs during serialization.
-
copyBySerialization
Copy an object by serializing it into a buffer and then deserializing it again.- Parameters:
object
- The original.- Returns:
- The copy.
- Throws:
IOException
- If an error occcurs during serialization.
-
testClone
public static void testClone(Object object, boolean checkEquality) throws IllegalAccessException, InvocationTargetException The the clone() method on an object.- Parameters:
object
- The original object to clone.checkEquality
- True if the original and copy are to be compared for equality after the clone().- Throws:
IllegalAccessException
- If we do not have authority to call the clone() method.InvocationTargetException
- If an exception is thrown during the processing of the clone() method
-
checkEquality
Assert that the two objects are equal- Parameters:
original
- The original objectcopy
- The object to compare against
-
assertAppearsEqual
Assert that a and b appear equal. SeeappearsEqual(Object,Object)
for an explanation of "appears"- Parameters:
message
- The message to display if the assert fails.a
- The first object to compareb
- The second object to compare
-
assertAppearsNotEqual
Assert that a and b do not appear equal. SeeappearsEqual(Object,Object)
for an explanation of "appears"- Parameters:
message
- The message to display if the assert fails.a
- The first object to compareb
- The second object to compare
-
appearsEqual
Return true if the two objects appear to be equal. Some objects cannot be compared for equality because they don't implement either the equals method or the Comparable interface. An example would be the Event objects used by AWT and Swing.This method will attempt to determine if the two objects are equal by calling all the public accessor methods on the objects and performing equals checks on the results.
If an exception is thrown during the invocation of any of the getXX() methods then that method will be ignored for the purpose of considering equality.
- Parameters:
a
- The first object to be comparedb
- The second object to be compared- Returns:
- True if the two objects appear to be the same.
-
isEqual
-
assertNotNull
public static final void assertNotNull(String fieldName, Object fieldValue) throws DetailedNullPointerException Verify that the specified value is not null. If it is then throw an exception- Parameters:
fieldName
- The name of the field to checkfieldValue
- The value of the field to check- Throws:
DetailedNullPointerException
- If fieldValue is null
-