org.hibernate.osgi

Class OsgiJtaPlatform

java.lang.Object

org.hibernate.osgi.OsgiJtaPlatform

All Implemented Interfaces:

Serializable, JtaPlatform, Service

public class OsgiJtaPlatform
extends Object
implements JtaPlatform

Offers the JTA Platform provided by the OSGi container. The Enterprise OSGi spec requires all containers to register UserTransaction and TransactionManager OSGi services.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OsgiJtaPlatform(OsgiServiceUtil osgiServiceUtil) Constructs a OsgiJtaPlatform

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canRegisterSynchronization() Can we currently register a Synchronization?
int	getCurrentStatus() Obtain the current transaction status using whatever means is preferred for this platform
Object	getTransactionIdentifier(Transaction transaction) Determine an identifier for the given transaction appropriate for use in caching/lookup usages.
void	registerSynchronization(Synchronization synchronization) Register a JTA Synchronization in the means defined by the platform.
TransactionManager	retrieveTransactionManager() Locate the TransactionManager
UserTransaction	retrieveUserTransaction() Locate the UserTransaction

Methods inherited from class java.lang.Object

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

Constructor Detail

OsgiJtaPlatform

public OsgiJtaPlatform(OsgiServiceUtil osgiServiceUtil)

Constructs a OsgiJtaPlatform

Parameters:

bundleContext - The OSGi bundle context

Method Detail

retrieveTransactionManager

public TransactionManager retrieveTransactionManager()

Description copied from interface: JtaPlatform

Locate the TransactionManager

Specified by:

retrieveTransactionManager in interface JtaPlatform

Returns:

The TransactionManager

retrieveUserTransaction

public UserTransaction retrieveUserTransaction()

Description copied from interface: JtaPlatform

Locate the UserTransaction

Specified by:

retrieveUserTransaction in interface JtaPlatform

Returns:

The UserTransaction

getTransactionIdentifier

public Object getTransactionIdentifier(Transaction transaction)

Description copied from interface: JtaPlatform

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).

Specified by:

getTransactionIdentifier in interface JtaPlatform

Parameters:

transaction - The transaction to be identified.

Returns:

An appropriate identifier

canRegisterSynchronization

public boolean canRegisterSynchronization()

Description copied from interface: JtaPlatform

Can we currently register a Synchronization?

Specified by:

canRegisterSynchronization in interface JtaPlatform

Returns:

True if registering a Synchronization is currently allowed; false otherwise.

registerSynchronization

public void registerSynchronization(Synchronization synchronization)

Description copied from interface: JtaPlatform

Register a JTA Synchronization in the means defined by the platform.

Specified by:

registerSynchronization in interface JtaPlatform

Parameters:

synchronization - The synchronization to register

getCurrentStatus

public int getCurrentStatus()
                     throws SystemException

Description copied from interface: JtaPlatform

Obtain the current transaction status using whatever means is preferred for this platform

Specified by:

getCurrentStatus in interface JtaPlatform

Returns:

The current status.

Throws:

SystemException - Indicates a problem access the underlying status