com.metamatrix.platform.config.spi.xml
Class XMLConfigurationWriter

java.lang.Object
  com.metamatrix.platform.config.spi.xml.XMLConfigurationWriter

public class XMLConfigurationWriter
extends java.lang.Object

Constructor Summary

XMLConfigurationWriter(ManagedConnection mgdConnection)

Method Summary

void	beginSystemInitialization(boolean forceInitialization, ConfigTransaction transaction)
java.util.Set	executeActions(java.util.List actions, ConfigTransaction transaction) Executes the list of actions, returns the Set of affected objects.
void	finishSystemInitialization(ConfigTransaction transaction) Called by JDBCCurrentConfigurationReader#finishSystemInitialization
protected XMLConfigurationReader	getConfigurationReader()
protected ConfigUserTransaction	getTransaction(java.lang.String principal)
static ConfigUserTransaction	getWriteTransactionWithRetry(java.lang.String principal, ConfigUserTransactionFactory factory)
void	indicateSystemShutdown(ConfigTransaction transaction) Called by XMLCurrentConfigurationReader.indicateSystemShutdown()
ConfigurationID	overwriteConfiguration(ConfigurationID configIDToCopy, ConfigurationID configIDToOverwrite, ConfigTransaction transaction) Overwrite the specified configuration by copying another configuration over it.
void	performSystemInitialization(ConfigTransaction transaction) Called by XMLCurrentConfigurationReader.performSystemInitialization(boolean) NOTE - This is a self contained transaction, the calling class cannot control the transaction
void	updateSharedResource(SharedResource resource, ConfigTransaction transaction)

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLConfigurationWriter

public XMLConfigurationWriter(ManagedConnection mgdConnection)

Method Detail

updateSharedResource

public void updateSharedResource(SharedResource resource,
                                 ConfigTransaction transaction)
                          throws ConfigurationException,
                                 ConfigTransactionException

Throws:

ConfigurationException

ConfigTransactionException

performSystemInitialization

public void performSystemInitialization(ConfigTransaction transaction)
                                 throws StartupStateException,
                                        ConfigurationException

Called by XMLCurrentConfigurationReader.performSystemInitialization(boolean) NOTE - This is a self contained transaction, the calling class cannot control the transaction

Throws:

StartupStateException

ConfigurationException

See Also:

XMLCurrentConfigurationReader.performSystemInitialization(boolean)

beginSystemInitialization

public void beginSystemInitialization(boolean forceInitialization,
                                      ConfigTransaction transaction)
                               throws StartupStateException,
                                      ConfigurationException

Throws:

StartupStateException

ConfigurationException

finishSystemInitialization

public void finishSystemInitialization(ConfigTransaction transaction)
                                throws StartupStateException,
                                       ConfigurationException

Called by JDBCCurrentConfigurationReader#finishSystemInitialization

Throws:

StartupStateException

ConfigurationException

See Also:

JDBCCurrentConfigurationReader#finishSystemInitialization

indicateSystemShutdown

public void indicateSystemShutdown(ConfigTransaction transaction)
                            throws StartupStateException,
                                   ConfigurationException

Called by XMLCurrentConfigurationReader.indicateSystemShutdown()

Throws:

StartupStateException

ConfigurationException

See Also:

XMLCurrentConfigurationReader.indicateSystemShutdown()

overwriteConfiguration

public ConfigurationID overwriteConfiguration(ConfigurationID configIDToCopy,
                                              ConfigurationID configIDToOverwrite,
                                              ConfigTransaction transaction)
                                       throws InvalidConfigurationException,
                                              ConfigurationException

Overwrite the specified configuration by copying another configuration over it. This includes assigning any designations of the configuration to be overwritten to the configuration to be copied. Both configurations must already be in the data source. (This method is needed to implement baselining).

Parameters:

configToCopy - the ConfigurationID of the Configuration to be copied

configToCopy - the ConfigurationID of the Configuration to be deleted - the "configToCopy" will be overwritten in its place.

Returns:

the new ID of the newly-copied Configuration

Throws:

InvalidConfigurationException - if either ConfigurationID is invalid.

ConfigurationException - if an error occurred within or during communication with the Configuration Service.

executeActions

public java.util.Set executeActions(java.util.List actions,
                                    ConfigTransaction transaction)
                             throws ConfigTransactionException,
                                    ConfigurationLockException,
                                    ConfigurationException

Executes the list of actions, returns the Set of affected objects. This is assumed one logical transaction.

Returns:

Set of affected configuration objects

Throws:

ConfigTransactionException

ConfigurationLockException

ConfigurationException

getTransaction

protected ConfigUserTransaction getTransaction(java.lang.String principal)
                                        throws ConfigTransactionException,
                                               ConfigurationException

Throws:

ConfigTransactionException

ConfigurationException

getConfigurationReader

protected XMLConfigurationReader getConfigurationReader()

getWriteTransactionWithRetry

public static ConfigUserTransaction getWriteTransactionWithRetry(java.lang.String principal,
                                                                 ConfigUserTransactionFactory factory)
                                                          throws ConfigTransactionException

Throws:

ConfigTransactionException