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 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

Constructor Summary

Constructors

Constructor and Description
OperationalDefaultsPreprocessor() Constructs a OperationalDefaultsPreprocessor.

Method Summary

Modifier and Type	Method and Description
void	addDefaultsDefinition(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.

Methods inherited from class java.lang.Object

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

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 occurring

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(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