org.apache.deltaspike.jpa.impl.transaction

Class ResourceLocalTransactionStrategy

java.lang.Object

org.apache.deltaspike.jpa.impl.transaction.ResourceLocalTransactionStrategy

All Implemented Interfaces:

Serializable, org.apache.deltaspike.core.spi.InterceptorStrategy, org.apache.deltaspike.jpa.spi.transaction.TransactionStrategy

Direct Known Subclasses:

BeanManagedUserTransactionStrategy

@Dependent
public class ResourceLocalTransactionStrategy
extends Object
implements org.apache.deltaspike.jpa.spi.transaction.TransactionStrategy

Default implementation of our plugable TransactionStrategy. It supports nested Transactions with the MANDATORY behaviour.

The outermost @Transactional interceptor for the given Qualifier will open an EntityTransaction and the outermost @Transactional interceptor for all EntityManagers will flush and subsequently close all open transactions.

If an Exception occurs in flushing the EntityManagers or any other Exception gets thrown inside the intercepted method chain and not gets catched until the outermost @Transactional interceptor gets reached, then all open transactions will get rollbacked.

If you like to implement your own TransactionStrategy, then use the standard CDI @Alternative mechanism.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ResourceLocalTransactionStrategy()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	beforeProceed(EntityManagerEntry entityManagerEntry)
protected EntityManagerEntry	createEntityManagerEntry(javax.persistence.EntityManager entityManager, Class<? extends Annotation> qualifier)
Object	execute(javax.interceptor.InvocationContext invocationContext)
protected javax.persistence.EntityTransaction	getTransaction(EntityManagerEntry entityManagerEntry)
protected void	onCloseTransactionScope()
protected Exception	prepareException(Exception e) This method might get overridden in subclasses to supply better error messages.
protected javax.enterprise.inject.spi.Bean<javax.persistence.EntityManager>	resolveEntityManagerBean(Class<? extends Annotation> qualifierClass)

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceLocalTransactionStrategy

public ResourceLocalTransactionStrategy()

Method Detail

execute

public Object execute(javax.interceptor.InvocationContext invocationContext)
               throws Exception

Specified by:

execute in interface org.apache.deltaspike.core.spi.InterceptorStrategy

Throws:

Exception

createEntityManagerEntry

protected EntityManagerEntry createEntityManagerEntry(javax.persistence.EntityManager entityManager,
                                          Class<? extends Annotation> qualifier)

getTransaction

protected javax.persistence.EntityTransaction getTransaction(EntityManagerEntry entityManagerEntry)

Parameters:

entityManagerEntry - entry of the current entity-manager

Returns:

per default the EntityTransaction of the given EntityManager. A subclass can also return an adapter e.g. for an UserTransaction

beforeProceed

protected void beforeProceed(EntityManagerEntry entityManagerEntry)

prepareException

protected Exception prepareException(Exception e)

This method might get overridden in subclasses to supply better error messages. This is useful if e.g. a JPA provider only provides a stubborn Exception for their ConstraintValidationExceptions.

Returns:

the wrapped or unwrapped Exception

onCloseTransactionScope

protected void onCloseTransactionScope()

resolveEntityManagerBean

protected javax.enterprise.inject.spi.Bean<javax.persistence.EntityManager> resolveEntityManagerBean(Class<? extends Annotation> qualifierClass)