org.castor.transactionmanager

Class TransactionManagerRegistry

java.lang.Object

org.castor.transactionmanager.TransactionManagerRegistry

public final class TransactionManagerRegistry
extends Object

Registry for TransactionManager instances obtained by their name.

Since:

1.0

Version:

$Revision: 8104 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $

Author:

Ralf Joachim

Constructor Summary

Constructors

Constructor and Description
TransactionManagerRegistry(AbstractProperties properties) Construct an instance of TransactionManagerRegistry that uses given LocalConfiguration to get required configuration properties.

Method Summary

Modifier and Type	Method and Description
void	deregisterTransactionManager(String managerName) Deregister TransactionManager with given name.
TransactionManager	getTransactionManager(String managerName) Get the TransactionManager with given name.
String[]	getTransactionManagerNames() Returns the names of all the registered TransactionManager's.
void	registerTransactionManager(String managerName, String factoryName, Properties properties) Register TransactionManager with given name.
void	registerTransactionManager(String managerName, TransactionManager managerInstance) Register given TransactionManager with given name.

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionManagerRegistry

public TransactionManagerRegistry(AbstractProperties properties)

Construct an instance of TransactionManagerRegistry that uses given LocalConfiguration to get required configuration properties.

Parameters:

properties - The properties.

Method Detail

registerTransactionManager

public void registerTransactionManager(String managerName,
                                       String factoryName,
                                       Properties properties)
                                throws TransactionManagerAcquireException

Register TransactionManager with given name. The method requires the name of the TransactionManagerFactory and properties to initialize the manager to be passed as parameters. Depending on the value of configuration property org.castor.jdo.TransactionManagerInitializeAtRegistration the manager will be initialized at registration or lazily when requested.

Parameters:

managerName - The name of the TransactionManager to register.

factoryName - The name of the TransactionManagerFactory used to get the factory from TransactionManagerFactoryRegistry.

properties - The properties passed to the TransactionManager at initialization.

Throws:

TransactionManagerAcquireException - If a TransactionManager with the same name has already been registered or if any failure occured at initialization of the TransactionManager.

registerTransactionManager

public void registerTransactionManager(String managerName,
                                       TransactionManager managerInstance)
                                throws TransactionManagerAcquireException

Register given TransactionManager with given name.

Parameters:

managerName - The name of the TransactionManager to register.

managerInstance - The TransactionManager instance.

Throws:

TransactionManagerAcquireException - If a TransactionManager with the same name has already been registered.

deregisterTransactionManager

public void deregisterTransactionManager(String managerName)

Deregister TransactionManager with given name.

Parameters:

managerName - The name of the TransactionManager to deregister.

getTransactionManagerNames

public String[] getTransactionManagerNames()

Returns the names of all the registered TransactionManager's.

Returns:

Names of TransactionManager's.

getTransactionManager

public TransactionManager getTransactionManager(String managerName)
                                         throws TransactionManagerAcquireException

Get the TransactionManager with given name.

Parameters:

managerName - The name of the TransactionManager to return.

Returns:

The TransactionManager.

Throws:

TransactionManagerAcquireException - If a TransactionManager with name has not been registered or if any failure occured at initialization of the TransactionManager.