org.castor.transactionmanager

Class TransactionManagerRegistry


public final class TransactionManagerRegistry
extends java.lang.Object

Registry for TransactionManager instances obtained by their name.
Version:
$Revision: 5951 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $
Author:
Ralf Joachim
Since:
1.0

Constructor Summary

TransactionManagerRegistry(Configuration config)
Construct an instance of TransactionManagerRegistry that uses given LocalConfiguration to get required configuration properties.

Method Summary

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.

Constructor Details

TransactionManagerRegistry

public TransactionManagerRegistry(Configuration config)
Construct an instance of TransactionManagerRegistry that uses given LocalConfiguration to get required configuration properties.
Parameters:
config - The LocalConfiguration.

Method Details

deregisterTransactionManager

public void deregisterTransactionManager(String managerName)
Deregister TransactionManager with given name.
Parameters:
managerName - The name of the TransactionManager to deregister.

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.

getTransactionManagerNames

public String[] getTransactionManagerNames()
Returns the names of all the registered TransactionManager's.
Returns:
Names of TransactionManager's.

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.

Intalio Inc. (C) 1999-2006. All rights reserved http://www.intalio.com