tech.units.tck.util

Class TestUtils

java.lang.Object

tech.units.tck.util.TestUtils

@Singleton
public class TestUtils
extends Object

Test utilities used in the JSR 385 TCK.

Since:

1.0

Version:

1.0.2, September 10, 2017

Author:

Werner Keil

Field Summary

Fields

Modifier and Type	Field and Description
static String	SYS_PROPERTY_OUTPUT_DIR Name of the system property to override the default output directory
static String	SYS_PROPERTY_PROFILE Name of the system property to pass the desired profile
static String	SYS_PROPERTY_REPORT_FILE Name of the system property to override the default report file
static String	SYS_PROPERTY_VERBOSE Name of the system property to set the verbose flag

Method Summary

Modifier and Type	Method and Description
static void	assertValue(String section, Object value, String methodName, Object instance) Checks the returned value, when calling a given method.
static void	testComparable(String section, Class<?> type) Tests if the given type is comparable.
static void	testHasNotPublicMethod(String section, Class type, Class returnType, String name, Class... paramTypes) Tests if the given type has not a public method with the given signature.
static void	testHasPublicMethod(String section, Class<?> type, boolean trySuperclassFirst, Class<?> returnType, String name, Class<?>... paramTypes) Deprecated. use the simplified version on top of Reflections.org where possible
static void	testHasPublicMethod(String section, Class<?> type, Class<?> returnType, String name, Class... paramTypes) Deprecated. use the simplified version on top of Reflections.org where possible
static void	testHasPublicMethod(String section, Class<?> type, String name) Deprecated. use the simplified version on top of Reflections.org where possible
static void	testHasPublicMethod(String section, Class<?> type, String name, boolean hasParameters) Tests if the given type has a public method with the given signature.
static void	testImmutable(String section, Class<?> type) Tests the given class being serializable.
static boolean	testImmutableOpt(String section, Class type) Test for immutability (optional recommendation), writes a warning if not given.
static void	testImplementsInterface(String section, Class<?> type, Class<?> iface) Tests the given class implements a given interface.
static void	testSerializable(String section, Class<?> type) Tests the given object being (effectively) serializable by serializing it.
static void	testSerializable(String section, Object o) Tests the given object being (effectively) serializable by serializing it.
static boolean	testSerializableOpt(String section, Class type) Test for serializable (optional recommendation), writes a warning if not given.
static boolean	testSerializableOpt(String section, Object instance) Test for serializable (optional recommendation), writes a warning if not given.

Methods inherited from class java.lang.Object

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

Field Detail

SYS_PROPERTY_PROFILE

public static final String SYS_PROPERTY_PROFILE

Name of the system property to pass the desired profile

See Also:

Constant Field Values

SYS_PROPERTY_OUTPUT_DIR

public static final String SYS_PROPERTY_OUTPUT_DIR

Name of the system property to override the default output directory

See Also:

Constant Field Values

SYS_PROPERTY_REPORT_FILE

public static final String SYS_PROPERTY_REPORT_FILE

Name of the system property to override the default report file

See Also:

Constant Field Values

SYS_PROPERTY_VERBOSE

public static final String SYS_PROPERTY_VERBOSE

Name of the system property to set the verbose flag

See Also:

Constant Field Values

Method Detail

testSerializable

public static void testSerializable(String section,
                                    Class<?> type)

Tests the given object being (effectively) serializable by serializing it.

Parameters:

section - the section of the spec under test

type - the type to be checked.

Throws:

TCKValidationException - if the test fails.

testImmutable

public static void testImmutable(String section,
                                 Class<?> type)

Tests the given class being serializable.

Parameters:

section - the section of the spec under test

type - the type to be checked.

Throws:

TCKValidationException - if test fails.

testSerializable

public static void testSerializable(String section,
                                    Object o)

Tests the given object being (effectively) serializable by serializing it.

Parameters:

section - the section of the spec under test

o - the object to be checked.

Throws:

TCKValidationException - if test fails.

testImplementsInterface

public static void testImplementsInterface(String section,
                                           Class<?> type,
                                           Class<?> iface)

Tests the given class implements a given interface.

Parameters:

section - the section of the spec under test

type - the type to be checked.

iface - the interface to be checked for.

Throws:

Assert#fail - if test fails.

testComparable

public static void testComparable(String section,
                                  Class<?> type)

Tests if the given type is comparable.

Parameters:

section - the section of the spec under test

type - the type to be checked.

testHasPublicMethod

public static void testHasPublicMethod(String section,
                                       Class<?> type,
                                       Class<?> returnType,
                                       String name,
                                       Class... paramTypes)

Deprecated. use the simplified version on top of Reflections.org where possible

Parameters:

section -

type -

returnType -

name -

paramTypes -

testHasPublicMethod

public static void testHasPublicMethod(String section,
                                       Class<?> type,
                                       boolean trySuperclassFirst,
                                       Class<?> returnType,
                                       String name,
                                       Class<?>... paramTypes)

Deprecated. use the simplified version on top of Reflections.org where possible

Parameters:

section -

type -

trySuperclassFirst -

returnType -

name -

paramTypes -

testHasPublicMethod

public static void testHasPublicMethod(String section,
                                       Class<?> type,
                                       String name,
                                       boolean hasParameters)

Tests if the given type has a public method with the given signature.

Parameters:

section - the section of the spec under test

type - the type to be checked.

name - the method name

hasParameters - the method has parameters.

Throws:

TCKValidationException - if test fails.

testHasPublicMethod

public static void testHasPublicMethod(String section,
                                       Class<?> type,
                                       String name)

Deprecated. use the simplified version on top of Reflections.org where possible

Parameters:

section -

type -

name -

testHasNotPublicMethod

public static void testHasNotPublicMethod(String section,
                                          Class type,
                                          Class returnType,
                                          String name,
                                          Class... paramTypes)

Tests if the given type has not a public method with the given signature.

Parameters:

section - the section of the spec under test

type - the type to be checked.

returnType - the method return type.

name - the method name

paramTypes - the parameter types.

Throws:

TCKValidationException - if test fails.

assertValue

public static void assertValue(String section,
                               Object value,
                               String methodName,
                               Object instance)
                        throws NoSuchMethodException,
                               SecurityException,
                               IllegalAccessException,
                               IllegalArgumentException,
                               InvocationTargetException

Checks the returned value, when calling a given method.

Parameters:

section - the section of the spec under test

value - the expected value

methodName - the target method name

instance - the instance to call

Throws:

NoSuchMethodException

SecurityException

IllegalAccessException

IllegalArgumentException

InvocationTargetException

TCKValidationException - if test fails.

testImmutableOpt

public static boolean testImmutableOpt(String section,
                                       Class type)

Test for immutability (optional recommendation), writes a warning if not given.

Parameters:

section - the section of the spec under test

type - the type to be checked.

Returns:

true, if the instance is probably immutable.

testSerializableOpt

public static boolean testSerializableOpt(String section,
                                          Class type)

Test for serializable (optional recommendation), writes a warning if not given.

Parameters:

section - the section of the spec under test

type - the type to be checked.

Returns:

true, if the type is probably serializable.

testSerializableOpt

public static boolean testSerializableOpt(String section,
                                          Object instance)

Test for serializable (optional recommendation), writes a warning if not given.

Parameters:

section - the section of the spec under test

instance - the object to be checked.

Returns:

true, if the instance is probably serializable.