org.apache.openjpa.ee
Class AutomaticManagedRuntime

java.lang.Object
  org.apache.openjpa.ee.AutomaticManagedRuntime

All Implemented Interfaces:

ManagedRuntime, Configurable

public class AutomaticManagedRuntime
extends Object
implements ManagedRuntime, Configurable

Implementation of the ManagedRuntime interface that searches through a set of known JNDI locations and method invocations to locate the appropriate mechanism for obtaining a TransactionManager. Built in support is provided for the following Application Servers:

• Bluestone
• HP Application Server
• JBoss
• JRun
• OpenEJB
• Oracle Application Server
• Orion
• SunONE
• Weblogic
• Websphere

Author:

Marc Prud'hommeaux

Constructor Summary

AutomaticManagedRuntime()

Method Summary

void	endConfiguration() Invoked upon completion of bean property configuration for this object.
Throwable	getRollbackCause() Returns the Throwable that caused the current transaction to be marked for rollback, provided that any exists.
TransactionManager	getTransactionManager() Return the TransactionManager for the managed runtime.
void	setConfiguration(Configuration conf) Invoked prior to setting bean properties.
void	setRollbackOnly(Throwable cause) Sets the rollback only flag on the current transaction.
void	startConfiguration() Invoked before bean property configuration is begun on this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

AutomaticManagedRuntime

public AutomaticManagedRuntime()

Method Detail

getTransactionManager

public TransactionManager getTransactionManager()
                                         throws 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:

Exception

setConfiguration

public void setConfiguration(Configuration conf)

Description copied from interface: Configurable

Invoked prior to setting bean properties.

Specified by:

setConfiguration in interface Configurable

startConfiguration

public void startConfiguration()

Description copied from interface: Configurable

Invoked before bean property configuration is begun on this object.

Specified by:

startConfiguration in interface Configurable

endConfiguration

public void endConfiguration()

Description copied from interface: Configurable

Invoked upon completion of bean property configuration for this object.

Specified by:

endConfiguration in interface Configurable

setRollbackOnly

public void setRollbackOnly(Throwable cause)
                     throws 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:

Exception

getRollbackCause

public Throwable getRollbackCause()
                           throws 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:

Exception