org.apache.openjpa.ee

Class RegistryManagedRuntime

java.lang.Object

org.apache.openjpa.ee.RegistryManagedRuntime

All Implemented Interfaces:

ManagedRuntime

Direct Known Subclasses:

WASRegistryManagedRuntime

public class RegistryManagedRuntime
extends java.lang.Object
implements ManagedRuntime

Implementation of the ManagedRuntime interface that uses the TransactionSynchronizationRegistry interface (new in JTA 1.1) to create a TransactionManager facade for controlling transactions.

Since:

1.0.0

Author:

Marc Prud'hommeaux

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RegistryManagedRuntime.TransactionManagerRegistryFacade A TransactionManager and Transaction facade that delegates the appropriate methods to the internally-held TransactionSynchronizationRegistry.

Constructor Summary

Constructors

Constructor and Description
RegistryManagedRuntime()

Method Summary

Methods

Modifier and Type	Method and Description
void	doNonTransactionalWork(java.lang.Runnable runnable) RegistryManagedRuntime cannot suspend transactions.
java.lang.String	getRegistryName()
java.lang.Throwable	getRollbackCause() Returns the Throwable that caused the current transaction to be marked for rollback, provided that any exists.
java.lang.Object	getTransactionKey() Returns a transaction key that can be used to associate transactions and Brokers.
javax.transaction.TransactionManager	getTransactionManager() Return the cached TransactionManager instance.
void	setRegistryName(java.lang.String registryName)
void	setRollbackOnly(java.lang.Throwable cause) Sets the rollback only flag on the current transaction.

Methods inherited from class java.lang.Object

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

Constructor Detail

RegistryManagedRuntime

public RegistryManagedRuntime()

Method Detail

getTransactionManager

public javax.transaction.TransactionManager getTransactionManager()
                                                           throws java.lang.Exception

Return the cached TransactionManager instance.

Specified by:

getTransactionManager in interface ManagedRuntime

Throws:

java.lang.Exception

setRollbackOnly

public void setRollbackOnly(java.lang.Throwable cause)
                     throws java.lang.Exception

Description copied from interface: ManagedRuntime

Sets the rollback only flag on the current transaction. If the TransactionManager is capable of tracking the cause of the rollback-only flag, it will also pass along cause information.

Specified by:

setRollbackOnly in interface ManagedRuntime

Parameters:

cause - the Throwable that caused the transaction to be marked for rollback, or null of none is known

Throws:

java.lang.Exception

getRollbackCause

public java.lang.Throwable getRollbackCause()
                                     throws java.lang.Exception

Description copied from interface: ManagedRuntime

Returns the Throwable that caused the current transaction to be marked for rollback, provided that any exists.

Specified by:

getRollbackCause in interface ManagedRuntime

Returns:

the Throwable cause, or null if none

Throws:

java.lang.Exception

setRegistryName

public void setRegistryName(java.lang.String registryName)

getRegistryName

public java.lang.String getRegistryName()

getTransactionKey

public java.lang.Object getTransactionKey()
                                   throws java.lang.Exception,
                                          javax.transaction.SystemException

Description copied from interface: ManagedRuntime

Returns a transaction key that can be used to associate transactions and Brokers.

Specified by:

getTransactionKey in interface ManagedRuntime

Returns:

the transaction key

Throws:

java.lang.Exception

javax.transaction.SystemException

doNonTransactionalWork

public void doNonTransactionalWork(java.lang.Runnable runnable)
                            throws javax.transaction.NotSupportedException

RegistryManagedRuntime cannot suspend transactions.

Specified by:

doNonTransactionalWork in interface ManagedRuntime

Parameters:

runnable - The runnable wrapper for the work that will be done. The runnable object should be fully initialized with any state needed to execute.

Throws:

javax.transaction.NotSupportedException - if the transaction can not be suspended.