org.apache.openjpa.ee
Class InvocationManagedRuntime

java.lang.Object
  org.apache.openjpa.ee.AbstractManagedRuntime
      org.apache.openjpa.ee.InvocationManagedRuntime

All Implemented Interfaces:

ManagedRuntime, org.apache.openjpa.lib.conf.Configurable

public class InvocationManagedRuntime
extends AbstractManagedRuntime
implements ManagedRuntime, org.apache.openjpa.lib.conf.Configurable

Implementation of the ManagedRuntime interface that uses a static method call to find the TransactionManager. For example, to configure it to use IBM Websphere's TransactionManager, use the method:
com.ibm.ejs.jts.jta.JTSXA.getTransactionManager

Author:

Marc Prud'hommeaux

Constructor Summary

InvocationManagedRuntime()

Method Summary

void	endConfiguration()
java.lang.Throwable	getRollbackCause() Returns the Throwable that caused the current transaction to be marked for rollback, provided that any exists.
javax.transaction.TransactionManager	getTransactionManager() Return the TransactionManager for the managed runtime.
java.lang.String	getTransactionManagerMethod() Return the method to invoke to get the TransactionManager.
void	setConfiguration(org.apache.openjpa.lib.conf.Configuration conf)
void	setRollbackOnly(java.lang.Throwable cause) Sets the rollback only flag on the current transaction.
void	setTransactionManagerMethod(java.lang.String methodName) Set the method to invoke to get the TransactionManager.
void	startConfiguration()

Methods inherited from class org.apache.openjpa.ee.AbstractManagedRuntime

getTransactionKey

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.openjpa.ee.ManagedRuntime

getTransactionKey

Constructor Detail

InvocationManagedRuntime

public InvocationManagedRuntime()

Method Detail

getTransactionManagerMethod

public java.lang.String getTransactionManagerMethod()

Return the method to invoke to get the TransactionManager.

setTransactionManagerMethod

public void setTransactionManagerMethod(java.lang.String methodName)

Set the method to invoke to get the TransactionManager. E.g.: com.ibm.ejs.jts.jta.JTSXA.getTransactionManager

getTransactionManager

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

Description copied from interface: ManagedRuntime

Return the TransactionManager for the managed runtime. This manager is used to register synchronization listeners, to map transactional PersistenceManagers to the current transaction, and possibly to enlist XA resources.

Specified by:

getTransactionManager in interface ManagedRuntime

Throws:

java.lang.Exception

setConfiguration

public void setConfiguration(org.apache.openjpa.lib.conf.Configuration conf)

Specified by:

setConfiguration in interface org.apache.openjpa.lib.conf.Configurable

startConfiguration

public void startConfiguration()

Specified by:

startConfiguration in interface org.apache.openjpa.lib.conf.Configurable

endConfiguration

public void endConfiguration()

Specified by:

endConfiguration in interface org.apache.openjpa.lib.conf.Configurable

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