de.mklinger.commons.junitsupport

Class BeanTestBase<T>

java.lang.Object

de.mklinger.commons.junitsupport.TestValueFactory

de.mklinger.commons.junitsupport.BeanTestBase<T>

Type Parameters:

T - The bean type

public class BeanTestBase<T>
extends TestValueFactory

Generic bean test.

Author:

Marc Klinger - mklinger[at]mklinger[dot]de

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	BeanTestBase.ConstructorParameters Constructor parameter descriptor.

Field Summary

Fields

Modifier and Type	Field and Description
protected static BeanTestBase.ConstructorParameters	DEFAULT_CONSTRUCTOR_PARAMETERS Default constructor parameters.

Constructor Summary

Constructors

Constructor and Description
BeanTestBase()
BeanTestBase(boolean treatIgnoreAsSuccess)
BeanTestBase(Class<T> beanClass) Create a new BeanTestBase instance.
BeanTestBase(Class<T> beanClass, boolean treatIgnoreAsSuccess) Create a new BeanTestBase instance.
BeanTestBase(Class<T> beanClass, int testRuns) Create a new BeanTestBase instance.
BeanTestBase(Class<T> beanClass, int testRuns, boolean treatIgnoreAsSuccess) Create a new BeanTestBase instance.
BeanTestBase(int testRuns)
BeanTestBase(int testRuns, boolean treatIgnoreAsSuccess)

Method Summary

Modifier and Type	Method and Description
protected void	assertEquals(String message, Collection<?> expected, Collection<?> actual)
protected void	assertEquals(String message, Object expected, Object actual) Assert equals with support for Double/double and Float/float, arrays and collections.
void	copyConstructorEmptyEqualsTest() Test for copy constructor, if any, and equals.
protected void	copyConstructorEmptyEqualsTestImpl()
void	copyConstructorEmptyValuesTest() Test for copy constructor, if any.
protected void	copyConstructorEmptyValuesTestImpl()
void	copyConstructorEqualsTest() Test for copy constructor, if any, and equals.
protected void	copyConstructorEqualsTestImpl()
void	copyConstructorValuesTest() Test for copy constructor, if any.
protected void	copyConstructorValuesTestImpl()
protected T	createInstance(BeanTestBase.ConstructorParameters constructorParameters) Create a bean instance using this parameter constructor.
void	equalsIdentityTest() Test the equals method with identical instances.
protected void	equalsIdentityTestImpl()
void	equalsValuesTest() Test the equals method with equal values.
protected void	equalsValuesTestImpl()
protected Map<String,Object>	fillBean(T bean, String[] propertiesToOmit)
protected Object	fillProperty(T entity, String propertyName) Set a value for the given field using a setter if possible.
protected Collection<String>	getBeanPropertyNames() Get all bean property names.
protected BeanTestBase.ConstructorParameters[]	getConstructorParameters() Get all constructor parameter sets.
protected Object	getFieldDefaultValue(String propertyName)
protected Object	getFieldValue(T entity, String propertyName) Get the value of the given field using a getter if possible.
protected String[]	getIgnorePropertyNames() Get the property names to ignore in this test.
void	hashCodeTest() Test the hashCode method.
protected void	hashCodeTestImpl()
protected boolean	isBeanFieldCandidate(Field field) Is the given field a bean field candidate?
void	propertyTestForAllConstructors() Property test for all constructors.
protected void	propertyTestForAllConstructorsImpl()
void	toStringTestForAllConstructorsEmpty() Calling toString() on an empty bean.
protected void	toStringTestForAllConstructorsEmptyImpl()
void	toStringTestForAllConstructorsFilled() Calling toString() on an filled bean.
protected void	toStringTestForAllConstructorsFilledImpl()

Methods inherited from class de.mklinger.commons.junitsupport.TestValueFactory

createValue, getNextTestValue

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CONSTRUCTOR_PARAMETERS

protected static final BeanTestBase.ConstructorParameters DEFAULT_CONSTRUCTOR_PARAMETERS

Default constructor parameters.

Constructor Detail

BeanTestBase

public BeanTestBase(Class<T> beanClass)

Create a new BeanTestBase instance.

Parameters:

beanClass - The bean class to test

BeanTestBase

public BeanTestBase(Class<T> beanClass,
                    boolean treatIgnoreAsSuccess)

Create a new BeanTestBase instance.

Parameters:

beanClass - The bean class to test

BeanTestBase

public BeanTestBase(Class<T> beanClass,
                    int testRuns)

Create a new BeanTestBase instance.

Parameters:

beanClass - The bean class to test

BeanTestBase

public BeanTestBase(Class<T> beanClass,
                    int testRuns,
                    boolean treatIgnoreAsSuccess)

Create a new BeanTestBase instance.

Parameters:

beanClass - The bean class to test

BeanTestBase

public BeanTestBase()

BeanTestBase

public BeanTestBase(int testRuns)

BeanTestBase

public BeanTestBase(boolean treatIgnoreAsSuccess)

BeanTestBase

public BeanTestBase(int testRuns,
                    boolean treatIgnoreAsSuccess)

Method Detail

getBeanPropertyNames

protected Collection<String> getBeanPropertyNames()

Get all bean property names.

Returns:

The bean property names

See Also:

isBeanFieldCandidate(Field)

fillProperty

protected Object fillProperty(T entity,
                              String propertyName)
                       throws IllegalAccessException,
                              InvocationTargetException,
                              NoSuchFieldException

Set a value for the given field using a setter if possible.

Throws:

IllegalAccessException

InvocationTargetException

NoSuchFieldException

getFieldValue

protected Object getFieldValue(T entity,
                               String propertyName)
                        throws IllegalAccessException,
                               InvocationTargetException,
                               NoSuchFieldException

Get the value of the given field using a getter if possible.

Throws:

IllegalAccessException

InvocationTargetException

NoSuchFieldException

getIgnorePropertyNames

protected String[] getIgnorePropertyNames()

Get the property names to ignore in this test.

Returns:

The property names to ignore.

isBeanFieldCandidate

protected boolean isBeanFieldCandidate(Field field)

Is the given field a bean field candidate?

Parameters:

field - The field

Returns:

true if the given field is a bean field candidate

createInstance

protected T createInstance(BeanTestBase.ConstructorParameters constructorParameters)
                    throws NoSuchMethodException,
                           InstantiationException,
                           IllegalAccessException,
                           InvocationTargetException

Create a bean instance using this parameter constructor. Property values are reused on subsequent calls to this method.

Returns:

The instance

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

getConstructorParameters

protected BeanTestBase.ConstructorParameters[] getConstructorParameters()

Get all constructor parameter sets.

Returns:

The constructor parameters array

assertEquals

protected void assertEquals(String message,
                            Object expected,
                            Object actual)

Assert equals with support for Double/double and Float/float, arrays and collections.

assertEquals

protected void assertEquals(String message,
                            Collection<?> expected,
                            Collection<?> actual)

fillBean

protected Map<String,Object> fillBean(T bean,
                                      String[] propertiesToOmit)
                               throws IllegalAccessException,
                                      InvocationTargetException,
                                      NoSuchFieldException

Returns:

The property name to value map

Throws:

IllegalAccessException

InvocationTargetException

NoSuchFieldException

propertyTestForAllConstructors

public void propertyTestForAllConstructors()
                                    throws NoSuchMethodException,
                                           InstantiationException,
                                           IllegalAccessException,
                                           InvocationTargetException,
                                           NoSuchFieldException

Property test for all constructors.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

propertyTestForAllConstructorsImpl

protected void propertyTestForAllConstructorsImpl()
                                           throws NoSuchMethodException,
                                                  InstantiationException,
                                                  IllegalAccessException,
                                                  InvocationTargetException,
                                                  NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEqualsTest

public void copyConstructorEqualsTest()
                               throws NoSuchMethodException,
                                      InstantiationException,
                                      IllegalAccessException,
                                      InvocationTargetException,
                                      NoSuchFieldException

Test for copy constructor, if any, and equals.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEqualsTestImpl

protected void copyConstructorEqualsTestImpl()
                                      throws NoSuchMethodException,
                                             InstantiationException,
                                             IllegalAccessException,
                                             InvocationTargetException,
                                             NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorValuesTest

public void copyConstructorValuesTest()
                               throws NoSuchMethodException,
                                      InstantiationException,
                                      IllegalAccessException,
                                      InvocationTargetException,
                                      NoSuchFieldException

Test for copy constructor, if any.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorValuesTestImpl

protected void copyConstructorValuesTestImpl()
                                      throws NoSuchMethodException,
                                             InstantiationException,
                                             IllegalAccessException,
                                             InvocationTargetException,
                                             NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEmptyEqualsTest

public void copyConstructorEmptyEqualsTest()
                                    throws NoSuchMethodException,
                                           InstantiationException,
                                           IllegalAccessException,
                                           InvocationTargetException,
                                           NoSuchFieldException

Test for copy constructor, if any, and equals.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEmptyEqualsTestImpl

protected void copyConstructorEmptyEqualsTestImpl()
                                           throws NoSuchMethodException,
                                                  InstantiationException,
                                                  IllegalAccessException,
                                                  InvocationTargetException,
                                                  NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEmptyValuesTest

public void copyConstructorEmptyValuesTest()
                                    throws NoSuchMethodException,
                                           InstantiationException,
                                           IllegalAccessException,
                                           InvocationTargetException,
                                           NoSuchFieldException

Test for copy constructor, if any.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

copyConstructorEmptyValuesTestImpl

protected void copyConstructorEmptyValuesTestImpl()
                                           throws NoSuchMethodException,
                                                  InstantiationException,
                                                  IllegalAccessException,
                                                  InvocationTargetException,
                                                  NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

getFieldDefaultValue

protected Object getFieldDefaultValue(String propertyName)

toStringTestForAllConstructorsEmpty

public void toStringTestForAllConstructorsEmpty()
                                         throws NoSuchMethodException,
                                                InstantiationException,
                                                IllegalAccessException,
                                                InvocationTargetException,
                                                NoSuchFieldException

Calling toString() on an empty bean.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

toStringTestForAllConstructorsEmptyImpl

protected void toStringTestForAllConstructorsEmptyImpl()
                                                throws NoSuchMethodException,
                                                       InstantiationException,
                                                       IllegalAccessException,
                                                       InvocationTargetException,
                                                       NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

toStringTestForAllConstructorsFilled

public void toStringTestForAllConstructorsFilled()
                                          throws NoSuchMethodException,
                                                 InstantiationException,
                                                 IllegalAccessException,
                                                 InvocationTargetException,
                                                 NoSuchFieldException

Calling toString() on an filled bean.

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

toStringTestForAllConstructorsFilledImpl

protected void toStringTestForAllConstructorsFilledImpl()
                                                 throws NoSuchMethodException,
                                                        InstantiationException,
                                                        IllegalAccessException,
                                                        InvocationTargetException,
                                                        NoSuchFieldException

Throws:

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

equalsIdentityTest

public void equalsIdentityTest()
                        throws InstantiationException,
                               IllegalAccessException,
                               InvocationTargetException,
                               NoSuchFieldException,
                               NoSuchMethodException

Test the equals method with identical instances.

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException

equalsIdentityTestImpl

protected void equalsIdentityTestImpl()
                               throws InstantiationException,
                                      IllegalAccessException,
                                      InvocationTargetException,
                                      NoSuchFieldException,
                                      NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException

equalsValuesTest

public void equalsValuesTest()
                      throws InstantiationException,
                             IllegalAccessException,
                             InvocationTargetException,
                             NoSuchFieldException,
                             NoSuchMethodException

Test the equals method with equal values.

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException

equalsValuesTestImpl

protected void equalsValuesTestImpl()
                             throws InstantiationException,
                                    IllegalAccessException,
                                    InvocationTargetException,
                                    NoSuchFieldException,
                                    NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException

hashCodeTest

public void hashCodeTest()
                  throws InstantiationException,
                         IllegalAccessException,
                         InvocationTargetException,
                         NoSuchFieldException,
                         NoSuchMethodException

Test the hashCode method.

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException

hashCodeTestImpl

protected void hashCodeTestImpl()
                         throws InstantiationException,
                                IllegalAccessException,
                                InvocationTargetException,
                                NoSuchFieldException,
                                NoSuchMethodException

Throws:

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchFieldException

NoSuchMethodException