org.opencms.configuration
Class CmsConfigurationManager

java.lang.Object
  org.opencms.configuration.CmsConfigurationManager

All Implemented Interfaces:

I_CmsConfigurationParameterHandler, I_CmsXmlConfiguration

public class CmsConfigurationManager
extends Object
implements I_CmsXmlConfiguration

Configuration manager for digesting the OpenCms XML configuration.

Reads the individual configuration class nodes first and creaes new instances of the "base" configuration classes.

Since:

6.0.0

Version:

$Revision: 1.29 $

Author:

Alexander Kandzior

Field Summary

static String	DEFAULT_DTD_LOCATION The location of the OpenCms configuration DTD if the default prefix is the system ID.
static String	DEFAULT_DTD_PREFIX The default prefix for the OpenCms configuration DTD.
protected static String	N_CONFIG The config node.
protected static String	N_CONFIGURATION The configurations node.
protected static String	N_ROOT The "opencms" root node of the XML configuration.

Fields inherited from interface org.opencms.configuration.I_CmsXmlConfiguration

A_ALIAS, A_CLASS, A_COUNT, A_DESTINATION, A_ENABLED, A_FROM, A_HANDLER, A_ICON, A_ID, A_KEY, A_NAME, A_ORDER, A_PASSWORD, A_PROTOCOL, A_SUFFIX, A_TO, A_TYPE, A_URI, A_USER, A_VALUE, N_EXPORTPOINT, N_EXPORTPOINTS, N_NAME, N_PARAM, N_PROPERTY, N_RESOURCE, N_SITE, N_VALUE

Fields inherited from interface org.opencms.configuration.I_CmsConfigurationParameterHandler

ADD_PARAMETER_METHOD, INIT_CONFIGURATION_METHOD

Constructor Summary

CmsConfigurationManager(String baseFolder)
Creates a new OpenCms configuration manager.

Method Summary

void	addConfiguration(I_CmsXmlConfiguration configuration) Adds a configuration object to the configuration manager.
void	addConfigurationParameter(String paramName, String paramValue) Adds a configuration parameter to this parameter configurable class instance.
void	addXmlDigesterRules(Digester digester) Digests an XML node and creates an instance of this configurable class.
Element	generateXml(Element parent) Generates the XML element for this configurable class.
Document	generateXml(I_CmsXmlConfiguration configuration) Creates the XML document build from the provided configuration.
File	getBackupFolder() Returns the backup folder.
Map	getConfiguration() Returns the configuration of this parameter configurable class instance, or null if the class does not need to be configured.
I_CmsXmlConfiguration	getConfiguration(Class clazz) Returns a specific configuration from the list of initialized configurations.
List	getConfigurations() Returns the list of all initialized configurations.
String	getDtdFilename() Returns the name of the DTD file for this XML configuration, e.g.
String	getDtdSystemLocation() Returns the internal system location of the DTD file for this XML configuration, e.g.
String	getDtdUrlPrefix() Returns the external system id prefix of the DTD file for this XML configuration, e.g.
String	getXmlFileName() Returns the name of the XML input file for this configuration, e.g.
void	initConfiguration() Initializes a configuration after all parameters have been added.
void	loadXmlConfiguration() Loads the OpenCms configuration from the given XML file.
void	setConfiguration(Map legacyConfiguration) Sets the configuration read from the legacy "opencms.properties".
void	writeConfiguration(Class clazz) Writes the XML configuration for the provided configuration instance.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_DTD_LOCATION

public static final String DEFAULT_DTD_LOCATION

The location of the OpenCms configuration DTD if the default prefix is the system ID.

See Also:

Constant Field Values

DEFAULT_DTD_PREFIX

public static final String DEFAULT_DTD_PREFIX

The default prefix for the OpenCms configuration DTD.

See Also:

Constant Field Values

N_CONFIG

protected static final String N_CONFIG

The config node.

See Also:

Constant Field Values

N_CONFIGURATION

protected static final String N_CONFIGURATION

The configurations node.

See Also:

Constant Field Values

N_ROOT

protected static final String N_ROOT

The "opencms" root node of the XML configuration.

See Also:

Constant Field Values

Constructor Detail

CmsConfigurationManager

public CmsConfigurationManager(String baseFolder)

Creates a new OpenCms configuration manager.

Parameters:

baseFolder - base folder where XML configurations to load are located

Method Detail

addConfiguration

public void addConfiguration(I_CmsXmlConfiguration configuration)

Adds a configuration object to the configuration manager.

Parameters:

configuration - the configuration to add

addConfigurationParameter

public void addConfigurationParameter(String paramName,
                                      String paramValue)

Description copied from interface: I_CmsConfigurationParameterHandler

Adds a configuration parameter to this parameter configurable class instance.

Specified by:

addConfigurationParameter in interface I_CmsConfigurationParameterHandler

Parameters:

paramName - the name of the parameter

paramValue - the value for the parameter

See Also:

I_CmsConfigurationParameterHandler.addConfigurationParameter(java.lang.String, java.lang.String)

addXmlDigesterRules

public void addXmlDigesterRules(Digester digester)

Description copied from interface: I_CmsXmlConfiguration

Digests an XML node and creates an instance of this configurable class.

Specified by:

addXmlDigesterRules in interface I_CmsXmlConfiguration

Parameters:

digester - the digester to use

See Also:

I_CmsXmlConfiguration.addXmlDigesterRules(org.apache.commons.digester.Digester)

generateXml

public Element generateXml(Element parent)

Description copied from interface: I_CmsXmlConfiguration

Generates the XML element for this configurable class.

Specified by:

generateXml in interface I_CmsXmlConfiguration

Parameters:

parent - the parent element in the XML tree

Returns:

the XML element for this configurable class

See Also:

I_CmsXmlConfiguration.generateXml(org.dom4j.Element)

generateXml

public Document generateXml(I_CmsXmlConfiguration configuration)

Creates the XML document build from the provided configuration.

Parameters:

configuration - the configuration to build the XML for

Returns:

the XML document build from the provided configuration

getBackupFolder

public File getBackupFolder()

Returns the backup folder.

Returns:

the backup folder

getConfiguration

public Map getConfiguration()

Description copied from interface: I_CmsConfigurationParameterHandler

Returns the configuration of this parameter configurable class instance, or null if the class does not need to be configured.

All elements in the configuration are key, value String pairs, set using the I_CmsConfigurationParameterHandler.addConfigurationParameter(String, String) method during initialization of the loader.

Implementations will (should) not to return a direct reference to the internal configuration but just a copy of it, to avoid unwanted external manipulation.

Specified by:

getConfiguration in interface I_CmsConfigurationParameterHandler

Returns:

the configuration of this resource loader, or null

See Also:

I_CmsConfigurationParameterHandler.getConfiguration()

getConfiguration

public I_CmsXmlConfiguration getConfiguration(Class clazz)

Returns a specific configuration from the list of initialized configurations.

Parameters:

clazz - the configuration class that should be returned

Returns:

the initialized configuration class instance, or null if this is not found

getConfigurations

public List getConfigurations()

Returns the list of all initialized configurations.

Returns:

the list of all initialized configurations

getDtdFilename

public String getDtdFilename()

Description copied from interface: I_CmsXmlConfiguration

Returns the name of the DTD file for this XML configuration, e.g. opencms-configuration.dtd.

Specified by:

getDtdFilename in interface I_CmsXmlConfiguration

Returns:

the name of the DTD file for this XML configuration

See Also:

I_CmsXmlConfiguration.getDtdFilename()

getDtdSystemLocation

public String getDtdSystemLocation()

Description copied from interface: I_CmsXmlConfiguration

Returns the internal system location of the DTD file for this XML configuration, e.g. org/opencms/configuration/.

If this is not null, then the DTD is not read through the web URL, but an internal name resolution is added that resolves the system id of the DTD to I_CmsXmlConfiguration.getDtdSystemLocation() + I_CmsXmlConfiguration.getDtdUrlPrefix().

Specified by:

getDtdSystemLocation in interface I_CmsXmlConfiguration

Returns:

the system location of the DTD file for this XML configuration

See Also:

I_CmsXmlConfiguration.getDtdSystemLocation()

getDtdUrlPrefix

public String getDtdUrlPrefix()

Description copied from interface: I_CmsXmlConfiguration

Returns the external system id prefix of the DTD file for this XML configuration, e.g. http://www.opencms.org/dtd/6.0/.

The full system id for the DTD is calculated like this: I_CmsXmlConfiguration.getDtdSystemLocation() + I_CmsXmlConfiguration.getDtdUrlPrefix().

Specified by:

getDtdUrlPrefix in interface I_CmsXmlConfiguration

Returns:

the system id prefix of the DTD file for this XML configuration

See Also:

I_CmsXmlConfiguration.getDtdUrlPrefix()

getXmlFileName

public String getXmlFileName()

Description copied from interface: I_CmsXmlConfiguration

Returns the name of the XML input file for this configuration, e.g. opencms.xml.

Specified by:

getXmlFileName in interface I_CmsXmlConfiguration

Returns:

the name of the XML input file for this configuration

See Also:

I_CmsXmlConfiguration.getXmlFileName()

initConfiguration

public void initConfiguration()

Description copied from interface: I_CmsConfigurationParameterHandler

Initializes a configuration after all parameters have been added.

Specified by:

initConfiguration in interface I_CmsConfigurationParameterHandler

See Also:

I_CmsConfigurationParameterHandler.initConfiguration()

loadXmlConfiguration

public void loadXmlConfiguration()
                          throws SAXException,
                                 IOException

Loads the OpenCms configuration from the given XML file.

Throws:

SAXException - in case of XML parse errors

IOException - in case of file IO errors

setConfiguration

public void setConfiguration(Map legacyConfiguration)

Sets the configuration read from the legacy "opencms.properties".

Parameters:

legacyConfiguration - the configuration read from the legacy "opencms.properties"

writeConfiguration

public void writeConfiguration(Class clazz)
                        throws IOException,
                               CmsConfigurationException

Writes the XML configuration for the provided configuration instance.

Parameters:

clazz - the configuration class to write the XML for

Throws:

IOException - in case of I/O errors while writing

CmsConfigurationException - if the given class is not a valid configuration class