## 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
`Object` `getTransactionIdentifier(Transaction transaction)` Determine an identifier for the given transaction appropriate for use in caching/lookup usages.
`TransactionManager` `getTransactionManager(Properties props)` Obtain the JTA `TransactionManager`.
`String` `getUserTransactionName()` Return the JNDI namespace of the JTA `UserTransaction` for this platform or `null`; optional operation.

Method Detail

### getTransactionManager

    TransactionManager getTransactionManager(Properties props)
                                             throws HibernateException

  Obtain the JTA `TransactionManager`.

  Parameters:
    `props` - The configuration properties.
  Returns:
    The JTA `TransactionManager`.
  Throws:
    `HibernateException` - Indicates problem locating `TransactionManager`.

### getUserTransactionName

    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

    Object getTransactionIdentifier(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

Copyright © 2001-2010 Red Hat, Inc. All Rights Reserved.