org.hibernate.transaction

Interface TransactionManagerLookup

All Known Implementing Classes:

BESTransactionManagerLookup, BTMTransactionManagerLookup, JBossTransactionManagerLookup, JBossTSStandaloneTransactionManagerLookup, JNDITransactionManagerLookup, JOnASTransactionManagerLookup, JOTMTransactionManagerLookup, JRun4TransactionManagerLookup, OC4JTransactionManagerLookup, OrionTransactionManagerLookup, ResinTransactionManagerLookup, SunONETransactionManagerLookup, TransactionManagerLookupImpl, WeblogicTransactionManagerLookup, WebSphereExtendedJTATransactionLookup, WebSphereTransactionManagerLookup

public interface TransactionManagerLookup

Contract for locating the JTA TransactionManager on given platform.

NOTE: this contract has expanded over time, and basically is a platform abstraction contract for JTA-related information.

Author:

Gavin King

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	getTransactionIdentifier(javax.transaction.Transaction transaction) Determine an identifier for the given transaction appropriate for use in caching/lookup usages.
javax.transaction.TransactionManager	getTransactionManager(java.util.Properties props) Obtain the JTA TransactionManager.
java.lang.String	getUserTransactionName() Return the JNDI namespace of the JTA UserTransaction for this platform or null; optional operation.

Method Detail

getTransactionManager

javax.transaction.TransactionManager getTransactionManager(java.util.Properties props)
                                                           throws HibernateException

Obtain the JTA TransactionManager.

Parameters:

props - The configuration properties.

Returns:

The JTA TransactionManager.

Throws:

HibernateException - Indicates problem locating TransactionManager.

getUserTransactionName

java.lang.String getUserTransactionName()

Return the JNDI namespace of the JTA UserTransaction for this platform or null; optional operation.

Returns:

The JNDI namespace where we can locate the UserTransaction for this platform.

getTransactionIdentifier

java.lang.Object getTransactionIdentifier(javax.transaction.Transaction transaction)

Determine an identifier for the given transaction appropriate for use in caching/lookup usages.

Generally speaking the transaction itself will be returned here. This method was added specifically for use in WebSphere and other unfriendly JEE containers (although WebSphere is still the only known such brain-dead, sales-driven impl).

Parameters:

transaction - The transaction to be identified.

Returns:

An appropropriate identifier