org.mule.transaction.lookup

Class GenericTransactionManagerLookupFactory

java.lang.Object

org.mule.transaction.lookup.GenericTransactionManagerLookupFactory

All Implemented Interfaces:

Initialisable, TransactionManagerFactory

Direct Known Subclasses:

JBossTransactionManagerLookupFactory, JRunTransactionManagerLookupFactory, Resin3TransactionManagerLookupFactory, WeblogicTransactionManagerLookupFactory

public class GenericTransactionManagerLookupFactory
extends Object
implements TransactionManagerFactory, Initialisable

A factory performing a JNDI lookup for TransactionManager.

NOTE: Java EE 1.4 specification does not mandate application server vendors to expose a TransactionManager for direct use, nor does it name the standard way to locate it. For some servers the TransactionManager is not even available in the global JNDI namespace, so your only bet is to run Mule in the same JVM as the application server.

Field Summary

Fields

Modifier and Type	Field and Description
protected Context	context
protected org.apache.commons.logging.Log	logger

Fields inherited from interface org.mule.api.lifecycle.Initialisable

PHASE_NAME

Constructor Summary

Constructors

Constructor and Description
GenericTransactionManagerLookupFactory()

Method Summary

Methods

Modifier and Type	Method and Description
TransactionManager	create(MuleConfiguration config) Creates of obtains the jta transaction manager to use for mule transactions
Context	getContext()
Map	getEnvironment()
String	getJndiName()
TransactionManager	getTxManager()
void	initialise() Method used to perform any initialisation work.
void	setContext(Context context)
void	setEnvironment(Map environment)
void	setJndiName(String jndiName)
void	setTxManager(TransactionManager txManager)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

context

protected Context context

Constructor Detail

GenericTransactionManagerLookupFactory

public GenericTransactionManagerLookupFactory()

Method Detail

getJndiName

public String getJndiName()

setJndiName

public void setJndiName(String jndiName)

getTxManager

public TransactionManager getTxManager()

setTxManager

public void setTxManager(TransactionManager txManager)

getEnvironment

public Map getEnvironment()

setEnvironment

public void setEnvironment(Map environment)

getContext

public Context getContext()

setContext

public void setContext(Context context)

create

public TransactionManager create(MuleConfiguration config)
                          throws Exception

Description copied from interface: TransactionManagerFactory

Creates of obtains the jta transaction manager to use for mule transactions

Specified by:

create in interface TransactionManagerFactory

Parameters:

config -

Returns:

the transaction manager to use

Throws:

Exception - if the transaction manager cannot be located or created

See Also:

TransactionManagerFactory.create(MuleConfiguration)

initialise

public void initialise()
                throws InitialisationException

Method used to perform any initialisation work. If a fatal error occurs during initialisation an InitialisationException should be thrown, causing the Mule instance to shutdown. If the error is recoverable, say by retrying to connect, a RecoverableException should be thrown. There is no guarantee that by throwing a Recoverable exception that the Mule instance will not shut down.

Specified by:

initialise in interface Initialisable

Throws:

InitialisationException - if a fatal error occurs causing the Mule instance to shutdown

RecoverableException - if an error occurs that can be recovered from