com.client.core.base.service.transaction.impl

Class StandardTransactionService<T extends JpaEntity<PK>,PK>

java.lang.Object

com.client.core.base.service.transaction.impl.StandardTransactionService<T,PK>

Type Parameters:

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

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

All Implemented Interfaces:

TransactionService<T,PK>

public class StandardTransactionService<T extends JpaEntity<PK>,PK>
extends java.lang.Object
implements TransactionService<T,PK>

Service used to wrap DAO calls with @Transactional annotations so as to handle the transaction in a generic way. Do NOT wrap any call to a TransactionService in a @Transactional annotation. The passed in DAO is used for all database calls and defines what type of entity can be retrieved/inserted into the database.

Constructor Summary

Constructors

Constructor and Description
StandardTransactionService(GenericDao<T,PK> genericDao)

Method Summary

Modifier and Type	Method and Description
void	add(T entity) 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.

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardTransactionService

public StandardTransactionService(GenericDao<T,PK> genericDao)

Method Detail

add

@Transactional(readOnly=false)
public void add(T entity)

Adds an object of type T.

Specified by:

add in interface TransactionService<T extends JpaEntity<PK>,PK>

Parameters:

entity - The object to be added

merge

@Transactional(readOnly=false)
public T merge(T transientObject)

Adds or updates an object of type T

Specified by:

merge in interface TransactionService<T extends JpaEntity<PK>,PK>

Parameters:

transientObject - The object to be added/updated

Returns:

the object just added/updated

find

@Transactional(readOnly=true)
public T find(PK id)
                                      throws javax.persistence.EntityNotFoundException

Get a T record using it's id

Specified by:

find in interface TransactionService<T extends JpaEntity<PK>,PK>

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

@Transactional(readOnly=true)
public java.util.List<T> findAll()

Gets a List of all entities in table

Specified by:

findAll in interface TransactionService<T extends JpaEntity<PK>,PK>

Returns:

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

remove

@Transactional(readOnly=false)
public void remove(T persistentObject)
                                            throws javax.persistence.EntityNotFoundException

Deletes entity T from table.

Specified by:

remove in interface TransactionService<T extends JpaEntity<PK>,PK>

Parameters:

persistentObject - Entity to delete

Throws:

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

query

@Transactional(readOnly=true)
public 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

Specified by:

query in interface TransactionService<T extends JpaEntity<PK>,PK>

Parameters:

queryString - a query string

queryParameters - parameters to inject into the queryString

Returns:

a List of all entities filtered by the passed query

batchUpdate

@Transactional(readOnly=false)
public java.util.List<T> batchUpdate(java.util.List<T> transientObjects)

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

Specified by:

batchUpdate in interface TransactionService<T extends JpaEntity<PK>,PK>

Parameters:

transientObjects - List of objects to update

Returns:

a List of all updated entities