Skip navigation links

com.tangosol.coherence.config.xml.preprocessor
Class OperationalDefaultsPreprocessor

java.lang.Object
com.tangosol.coherence.config.xml.preprocessor.OperationalDefaultsPreprocessor

All Implemented Interfaces:

DocumentElementPreprocessor.ElementPreprocessor

public class OperationalDefaultsPreprocessor

extends java.lang.Object

implements DocumentElementPreprocessor.ElementPreprocessor

A OperationalDefaultsPreprocessor is an DocumentElementPreprocessor.ElementPreprocessor that introduces (via cloning) default xml content for xml elements where the said content is missing.

Ultimately this DocumentElementPreprocessor.ElementPreprocessor is designed to perform pre-processing of Coherence cache-config.xml files to inject appropriate Operational Config elements defined separately in tangosol-coherence.*.xml files.

Since:

Coherence 12.1.2

Author:

bo 2012.01.10

See Also:

CacheDefaultsPreprocessor

Constructor Summary

OperationalDefaultsPreprocessor()
Constructs a OperationalDefaultsPreprocessor.

Method Summary

void	addDefaultsDefinition(java.lang.String sPath, XmlElement defaultsElement) Defines that elements matching the specified path must contain the child elements defined by the default element.
boolean	preprocess(ProcessingContext context, XmlElement element) Process an XmlElement, optionally mutating it (or it's children) if required.

Constructor Detail

OperationalDefaultsPreprocessor

public OperationalDefaultsPreprocessor()

Constructs a OperationalDefaultsPreprocessor.

Method Detail

preprocess

public boolean preprocess(ProcessingContext context,
                          XmlElement element)
                   throws ConfigurationException

Process an XmlElement, optionally mutating it (or it's children) if required.

Note: An implementation of this interface should avoid attempting to traverse child XmlElements. If you wish to manually traverse or change the entire document, you should instead use a DocumentPreprocessor.

Specified by:

preprocess in interface DocumentElementPreprocessor.ElementPreprocessor

Parameters:

context - the ProcessingContext in which the pre-processing is occuring

element - the XmlElement to preprocess

Returns:

true if the specified XmlElement should be re-preprocessed by this and other DocumentElementPreprocessor.ElementPreprocessors due to the XmlElement being modified, false otherwise.

Throws:

ConfigurationException - if during pre-processing of the XmlElement a configuration issue was discovered (or if pre-processing fails for some reason)

addDefaultsDefinition

public void addDefaultsDefinition(java.lang.String sPath,
                                  XmlElement defaultsElement)

Defines that elements matching the specified path must contain the child elements defined by the default element. If not the missing children must be cloned from the default element into the element matching the path during pre-processing.

Paths used by this method are based those defined by the XmlHelper.findElement(XmlElement, String) method, with the exception that ".." is not supported.

For example 1: The following specifies that the elements matching the absolute path "/caching-schemes/distributed-scheme" must contain the children defined by the xmlDistributedSchemeDefaults element. If not, they must be cloned into place.

addDefaultsDefinition("/caching-schemes/distributed-scheme", xmlDistributedSchemeDefaults);

For example 2: The following specifies that the elements matching the relative path "distributed-scheme" must contain the children defined by the xmlDistributedSchemeDefaults element. If not, they must be cloned into place.

addDefaultsDefinition("distributed-scheme", xmlDistributedSchemeDefaults);

Parameters:

sPath - The path of elements requiring the defaults

defaultsElement - The xml element containing the required defaults for the specified path

Skip navigation links