auxtestlib

Class DefaultTCase

java.lang.Object

org.junit.Assert

auxtestlib.DefaultTCase

public class DefaultTCase
extends org.junit.Assert

Super class for all test cases. Test helpers (see AbstractTestHelper) may be added as private variables with the TestHelper annotation. They will be automatically initialized and destroyed. Note that helpers will be initialized by alphabetical order and will be destroyed in reverse order. This class will save system properties on set up and will restore them at tear down.

Constructor Summary

Constructors

Constructor and Description
DefaultTCase()

Method Summary

Modifier and Type	Method and Description
protected <E extends Enum<E>> void	cover_enumeration(Class<E> cls) Artificially invoke all automatically generated methods of an enumeration to make sure they are not missing in the code coverage report.
static <FIELD_T> FIELD_T	internal_get(Object object, Class<FIELD_T> field_type, String field_name) Obtains the value of a field in an object.
static void	internal_set(Object object, String field_name, Object value) Obtains the value of a field in an object.
void	post_tear_down() Runs after tear down.
void	pre_set_up() Runs before any preparation.
protected void	wait_for_true(BooleanEvaluation eval) Equivalent to invoke wait_for_true(BooleanEvaluation, long) with WAIT_FOR_TRUE_DEFAULT_TIMEOUT_MS as timeout.
protected void	wait_for_true(BooleanEvaluation eval, long timeout_ms) Keeps evaluating an expression until it returns true or until it times out.

Methods inherited from class org.junit.Assert

assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertArrayEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertThat, assertThat, assertTrue, assertTrue, fail, fail

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultTCase

public DefaultTCase()

Method Detail

pre_set_up

public void pre_set_up()
                throws Exception

Runs before any preparation. Ensures there are no helpers pending from previous test cases. It will also initialize any helpers marked with the TestHelper annotation.

Throws:

Exception - failed to initialize helpers.

post_tear_down

public void post_tear_down()
                    throws Exception

Runs after tear down. Ensures all helpers have been destroyed.

Throws:

Exception - failed to tear down the test case

cover_enumeration

protected <E extends Enum<E>> void cover_enumeration(Class<E> cls)
                                              throws Exception

Artificially invoke all automatically generated methods of an enumeration to make sure they are not missing in the code coverage report.

Type Parameters:

E - the enumeration type

Parameters:

cls - the enumeration class

Throws:

Exception - failed to invoke

wait_for_true

protected void wait_for_true(BooleanEvaluation eval,
                             long timeout_ms)
                      throws Exception

Keeps evaluating an expression until it returns true or until it times out. This method is usually used on unit tests to avoid having to code thread sleeps. This method will invoke fail() if eval didn't become true after timeout_ms milliseconds have elapsed

Parameters:

eval - the expression to evaluate; this expression will be invoked multiple times and it should compute quickly

timeout_ms - the timeout in milliseconds

Throws:

Exception - failed to evaluate

wait_for_true

protected void wait_for_true(BooleanEvaluation eval)
                      throws Exception

Equivalent to invoke wait_for_true(BooleanEvaluation, long) with WAIT_FOR_TRUE_DEFAULT_TIMEOUT_MS as timeout.

Parameters:

eval - the expression to evaluate; this expression will be invoked multiple times and it should compute quickly

Throws:

Exception - failed to evaluate

internal_get

public static <FIELD_T> FIELD_T internal_get(Object object,
                                             Class<FIELD_T> field_type,
                                             String field_name)
                                      throws Exception

Obtains the value of a field in an object. This method is usually used to mess up with internals for white box unit testing.

Type Parameters:

FIELD_T - the type of field

Parameters:

object - the object, cannot be null

field_type - the type of field, cannot be null

field_name - the name of the field, cannot be null

Returns:

the value of the field

Throws:

Exception - failed to access the field

internal_set

public static void internal_set(Object object,
                                String field_name,
                                Object value)
                         throws Exception

Obtains the value of a field in an object. This method is usually used to mess up with internals for white box unit testing.

Parameters:

object - the object, cannot be null

field_name - the name of the field, cannot be null

value - the value to put in the field

Throws:

Exception - failed to access the field