com.client.core.base.service.transaction

Interface TransactionService<T extends JpaEntity<PK>,PK>

Type Parameters:

T - the type of the entity with which we will be interacting with the database

PK - the id of the entity with which we will be interacting with the database

All Known Implementing Classes:

StandardTransactionService

public interface TransactionService<T extends JpaEntity<PK>,PK>

Service used to wrap DAO calls with transaction-specific code so as to remove that dependency on code interacting with a database. This object can be directly interacted with without any regards to handling a database transaction or seswsion.

Method Summary

Modifier and Type	Method and Description
void	add(T transientObject) Adds an object of type T.
java.util.List<T>	batchUpdate(java.util.List<T> transientObjects) Updates all entities passed in and returns a list of the updated objects
T	find(PK id) Get a T record using it's id
java.util.List<T>	findAll() Gets a List of all entities in table
T	merge(T transientObject) Adds or updates an object of type T
java.util.List<T>	query(java.lang.String queryString, java.util.Map<java.lang.String,java.lang.Object> queryParameters) Queries the current table using the passed in where clause
void	remove(T persistentObject) Deletes entity T from table.

Method Detail

add

void add(T transientObject)

Adds an object of type T.

Parameters:

transientObject - The object to be added

merge

T merge(T transientObject)

Adds or updates an object of type T

Parameters:

transientObject - The object to be added/updated

Returns:

the object just added/updated

find

T find(PK id)
throws javax.persistence.EntityNotFoundException

Get a T record using it's id

Parameters:

id - the primary key of the entity

Returns:

the entity of type T

Throws:

javax.persistence.EntityNotFoundException - when no entity with primary key PK exists

findAll

java.util.List<T> findAll()

Gets a List of all entities in table

Returns:

a List. If no entities exists an empty List will be returned.

remove

void remove(T persistentObject)
     throws javax.persistence.EntityNotFoundException

Deletes entity T from table.

Parameters:

persistentObject - Entity to delete

Throws:

javax.persistence.EntityNotFoundException - if the instance is not an entity or is a detached entity

query

java.util.List<T> query(java.lang.String queryString,
                        java.util.Map<java.lang.String,java.lang.Object> queryParameters)

Queries the current table using the passed in where clause

Parameters:

queryString - a query string

queryParameters - parameters to inject into the queryString

Returns:

a List of all entities filtered by the passed query

batchUpdate

java.util.List<T> batchUpdate(java.util.List<T> transientObjects)

Updates all entities passed in and returns a list of the updated objects

Parameters:

transientObjects - List of objects to update

Returns:

a List of all updated entities