org.jminor.framework.domain.test

Class EntityTestUnit

java.lang.Object

org.jminor.framework.domain.test.EntityTestUnit

public class EntityTestUnit
extends java.lang.Object

A class for unit testing a domain model.

Constructor Summary

Constructors

Constructor and Description
EntityTestUnit(java.lang.String domainClass) Instantiates a new EntityTestUnit.

Method Summary

Modifier and Type	Method and Description
static Entity	createEntity(Domain domain, java.lang.String entityId, ValueProvider<Property,java.lang.Object> valueProvider)
static Entity	createRandomEntity(Domain domain, java.lang.String entityId, java.util.Map<java.lang.String,Entity> referenceEntities)
protected void	doSetUp() Override to provide specific setup for this test
protected void	doTearDown() Override to provide specific tear down for this test
protected EntityConnection	getConnection()
Domain	getDomain()
protected User	getTestUser() Returns the database user to use when running the tests, this default implementation returns a user based on the "jminor.unittest.username" and "jminor.unittest.password" system properties.
protected EntityConnectionProvider	initializeConnectionProvider()
protected Entity	initializeReferenceEntity(java.lang.String entityId, java.util.Map<java.lang.String,Entity> foreignKeyEntities) Initializes a new Entity of the given type, by default this method creates a Entity filled with random values.
protected Entity	initializeTestEntity(java.lang.String entityId, java.util.Map<java.lang.String,Entity> foreignKeyEntities) This method should return an instance of the entity specified by entityId
protected void	modifyEntity(Entity testEntity, java.util.Map<java.lang.String,Entity> foreignKeyEntities) This method should return testEntity in a modified state
static void	randomize(Domain domain, Entity entity, java.util.Map<java.lang.String,Entity> foreignKeyEntities) Randomizes the values in the given entity, note that if a foreign key entity is not provided the respective foreign key value in not modified
void	setUp() Sets up the database connection
void	tearDown() Tears down the database connection
void	testEntity(java.lang.String entityId) Runs the insert/update/select/delete tests for the given entityId

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityTestUnit

public EntityTestUnit(java.lang.String domainClass)

Instantiates a new EntityTestUnit.

Parameters:

domainClass - the name of the domain model class

Throws:

java.lang.NullPointerException - in case domainClass is null

Method Detail

getDomain

public final Domain getDomain()

Returns:

the domain model

setUp

@BeforeEach
public final void setUp()

Sets up the database connection

tearDown

@AfterEach
public final void tearDown()

Tears down the database connection

testEntity

public final void testEntity(java.lang.String entityId)
                      throws DatabaseException

Runs the insert/update/select/delete tests for the given entityId

Parameters:

entityId - the ID of the entity to test

Throws:

DatabaseException - in case of an exception

createRandomEntity

public static Entity createRandomEntity(Domain domain,
                                        java.lang.String entityId,
                                        java.util.Map<java.lang.String,Entity> referenceEntities)

Parameters:

domain - the domain model

entityId - the entity ID

referenceEntities - entities referenced by the given entity ID

Returns:

a Entity instance containing randomized values, based on the property definitions

createEntity

public static Entity createEntity(Domain domain,
                                  java.lang.String entityId,
                                  ValueProvider<Property,java.lang.Object> valueProvider)

Parameters:

domain - the domain model

entityId - the entity ID

valueProvider - the value provider

Returns:

an Entity instance initialized with values provided by the given value provider

randomize

public static void randomize(Domain domain,
                             Entity entity,
                             java.util.Map<java.lang.String,Entity> foreignKeyEntities)

Randomizes the values in the given entity, note that if a foreign key entity is not provided the respective foreign key value in not modified

Parameters:

domain - the domain model

entity - the entity to randomize

foreignKeyEntities - the entities referenced via foreign keys

doSetUp

protected void doSetUp()

Override to provide specific setup for this test

doTearDown

protected void doTearDown()

Override to provide specific tear down for this test

initializeConnectionProvider

protected EntityConnectionProvider initializeConnectionProvider()

Returns:

the EntityConnectionProvider instance this test case should use

getTestUser

protected User getTestUser()

Returns the database user to use when running the tests, this default implementation returns a user based on the "jminor.unittest.username" and "jminor.unittest.password" system properties.

Returns:

the db user to use when running the test

getConnection

protected final EntityConnection getConnection()

Returns:

the EntityConnection instance used by this EntityTestUnit

initializeTestEntity

protected Entity initializeTestEntity(java.lang.String entityId,
                                      java.util.Map<java.lang.String,Entity> foreignKeyEntities)

This method should return an instance of the entity specified by entityId

Parameters:

entityId - the entityId for which to initialize an entity instance

foreignKeyEntities - the entities referenced via foreign keys

Returns:

the entity instance to use for testing the entity type

initializeReferenceEntity

protected Entity initializeReferenceEntity(java.lang.String entityId,
                                           java.util.Map<java.lang.String,Entity> foreignKeyEntities)

Initializes a new Entity of the given type, by default this method creates a Entity filled with random values.

Parameters:

entityId - the entity ID

foreignKeyEntities - the entities referenced via foreign keys

Returns:

a entity of the given type

modifyEntity

protected void modifyEntity(Entity testEntity,
                            java.util.Map<java.lang.String,Entity> foreignKeyEntities)

This method should return testEntity in a modified state

Parameters:

testEntity - the entity to modify

foreignKeyEntities - the entities referenced via foreign keys