org.jboss.as.controller.persistence

Class BackupXmlConfigurationPersister

java.lang.Object

org.jboss.as.controller.persistence.AbstractConfigurationPersister

org.jboss.as.controller.persistence.XmlConfigurationPersister

org.jboss.as.controller.persistence.BackupXmlConfigurationPersister

All Implemented Interfaces:

ConfigurationPersister, ExtensibleConfigurationPersister, SubsystemXmlWriterRegistry

public class BackupXmlConfigurationPersister
extends XmlConfigurationPersister

An XML configuration persister which backs up the old file before overwriting it.

Author:

David M. Lloyd

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.as.controller.persistence.ConfigurationPersister

ConfigurationPersister.PersistenceResource, ConfigurationPersister.SnapshotInfo

Field Summary

Fields inherited from interface org.jboss.as.controller.persistence.ConfigurationPersister

NULL_SNAPSHOT_INFO

Constructor Summary

Constructors

Constructor and Description
BackupXmlConfigurationPersister(ConfigurationFile file, QName rootElement, org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> rootParser, org.jboss.staxmapper.XMLElementWriter<ModelMarshallingContext> rootDeparser) Construct a new instance.
BackupXmlConfigurationPersister(ConfigurationFile file, QName rootElement, org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> rootParser, org.jboss.staxmapper.XMLElementWriter<ModelMarshallingContext> rootDeparser, boolean reload, boolean allowEmpty) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
void	deleteSnapshot(String name) Deletes a snapshot using its name.
ConfigurationPersister.SnapshotInfo	listSnapshots() Gets the names of the snapshots in the snapshots directory
void	registerAdditionalRootElement(QName anotherRoot, org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> parser)
String	snapshot() Take a snapshot of the current configuration
ConfigurationPersister.PersistenceResource	store(org.jboss.dmr.ModelNode model, Set<PathAddress> affectedAddresses) Persist the given configuration model.
void	successfulBoot() Called once the xml has been successfully parsed, translated into updates, executed in the target controller and all services have started successfully

Methods inherited from class org.jboss.as.controller.persistence.XmlConfigurationPersister

load, successfulBoot

Methods inherited from class org.jboss.as.controller.persistence.AbstractConfigurationPersister

marshallAsXml, registerSubsystemWriter, unregisterSubsystemWriter

Methods inherited from class java.lang.Object

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

Constructor Detail

BackupXmlConfigurationPersister

public BackupXmlConfigurationPersister(ConfigurationFile file,
                                       QName rootElement,
                                       org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> rootParser,
                                       org.jboss.staxmapper.XMLElementWriter<ModelMarshallingContext> rootDeparser)

Construct a new instance.

Parameters:

file - the configuration base file

rootElement - the root element of the configuration file

rootParser - the root model parser

rootDeparser - the root model deparser

BackupXmlConfigurationPersister

public BackupXmlConfigurationPersister(ConfigurationFile file,
                                       QName rootElement,
                                       org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> rootParser,
                                       org.jboss.staxmapper.XMLElementWriter<ModelMarshallingContext> rootDeparser,
                                       boolean reload,
                                       boolean allowEmpty)

Construct a new instance.

Parameters:

file - the configuration base file

rootElement - the root element of the configuration file

rootParser - the root model parser

rootDeparser - the root model deparser

reload - true if this is a reload

allowEmpty - true if it is ok if ConfigurationFile.getBootFile() points to an empty file

Method Detail

registerAdditionalRootElement

public void registerAdditionalRootElement(QName anotherRoot,
                                          org.jboss.staxmapper.XMLElementReader<List<org.jboss.dmr.ModelNode>> parser)

Overrides:

registerAdditionalRootElement in class XmlConfigurationPersister

successfulBoot

public void successfulBoot()
                    throws ConfigurationPersistenceException

Description copied from interface: ConfigurationPersister

Called once the xml has been successfully parsed, translated into updates, executed in the target controller and all services have started successfully

Specified by:

successfulBoot in interface ConfigurationPersister

Overrides:

successfulBoot in class AbstractConfigurationPersister

Throws:

ConfigurationPersistenceException

store

public ConfigurationPersister.PersistenceResource store(org.jboss.dmr.ModelNode model,
                                                        Set<PathAddress> affectedAddresses)
                                                 throws ConfigurationPersistenceException

Description copied from class: XmlConfigurationPersister

Persist the given configuration model.

Specified by:

store in interface ConfigurationPersister

Overrides:

store in class XmlConfigurationPersister

Parameters:

model - the model to persist

Returns:

callback to use to control whether the stored model should be flushed to persistent storage

Throws:

ConfigurationPersistenceException

snapshot

public String snapshot()
                throws ConfigurationPersistenceException

Description copied from interface: ConfigurationPersister

Take a snapshot of the current configuration

Specified by:

snapshot in interface ConfigurationPersister

Overrides:

snapshot in class XmlConfigurationPersister

Returns:

the location of the snapshot

Throws:

ConfigurationPersistenceException - if a problem happened when creating the snapshot

listSnapshots

public ConfigurationPersister.SnapshotInfo listSnapshots()

Description copied from interface: ConfigurationPersister

Gets the names of the snapshots in the snapshots directory

Specified by:

listSnapshots in interface ConfigurationPersister

Overrides:

listSnapshots in class AbstractConfigurationPersister

Returns:

the snapshot info. This will never return null

deleteSnapshot

public void deleteSnapshot(String name)

Description copied from interface: ConfigurationPersister

Deletes a snapshot using its name.

Specified by:

deleteSnapshot in interface ConfigurationPersister

Overrides:

deleteSnapshot in class AbstractConfigurationPersister

Parameters:

name - the name of the snapshot (as returned by ConfigurationPersister.SnapshotInfo.names() returned from ConfigurationPersister.listSnapshots(). The whole name is not needed, just enough to uniquely identify it.