org.apache.commons.configuration.tree
Class OverrideCombiner

java.lang.Object
  extended by org.apache.commons.configuration.tree.NodeCombiner
      extended by org.apache.commons.configuration.tree.OverrideCombiner

public class OverrideCombiner
extends NodeCombiner

A concrete combiner implementation that is able to construct an override combination.

An override combination means that nodes in the first node structure take precedence over nodes in the second, or - in other words - nodes of the second structure are only added to the resulting structure if they do not occure in the first one. This is especially suitable for dealing with the properties of configurations that are defined in an override section of a configuration definition file (hence the name).

This combiner will iterate over the second node hierarchy and find all nodes that are not contained in the first hierarchy; these are added to the result. If a node can be found in both structures, it is checked whether a combination (in a recursive way) can be constructed for the two, which will then be added. Per default, nodes are combined, which occur only once in both structures. This test is implemented in the canCombine() method.

As is true for the UnionCombiner, for this combiner list nodes are important. The addListNode() can be called to declare certain nodes as list nodes. This has the effect that these nodes will never be combined.

Since:
1.3
Version:
$Id: OverrideCombiner.java 439648 2006-09-02 20:42:10Z oheger $
Author:
Commons Configuration team

Field Summary
 
Fields inherited from class org.apache.commons.configuration.tree.NodeCombiner
listNodes
 
Constructor Summary
OverrideCombiner()
           
 
Method Summary
protected  void addAttributes(ViewNode result, ConfigurationNode node1, ConfigurationNode node2)
          Handles the attributes during a combination process.
protected  ConfigurationNode canCombine(ConfigurationNode node1, ConfigurationNode node2, ConfigurationNode child)
          Tests if a child node of the second node can be combined with the given child node of the first node.
 ConfigurationNode combine(ConfigurationNode node1, ConfigurationNode node2)
          Constructs an override combination for the passed in node structures.
 
Methods inherited from class org.apache.commons.configuration.tree.NodeCombiner
addListNode, createViewNode, getListNodes, isListNode
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

OverrideCombiner

public OverrideCombiner()
Method Detail

combine

public ConfigurationNode combine(ConfigurationNode node1,
                                 ConfigurationNode node2)
Constructs an override combination for the passed in node structures.

Specified by:
combine in class NodeCombiner
Parameters:
node1 - the first node
node2 - the second node
Returns:
the resulting combined node structure

addAttributes

protected void addAttributes(ViewNode result,
                             ConfigurationNode node1,
                             ConfigurationNode node2)
Handles the attributes during a combination process. First all attributes of the first node will be added to the result. Then all attributes of the second node, which are not contained in the first node, will also be added.

Parameters:
result - the resulting node
node1 - the first node
node2 - the second node

canCombine

protected ConfigurationNode canCombine(ConfigurationNode node1,
                                       ConfigurationNode node2,
                                       ConfigurationNode child)
Tests if a child node of the second node can be combined with the given child node of the first node. If this is the case, the corresponding node will be returned, otherwise null. This implementation checks whether the child node occurs only once in both hierarchies and is no known list node.

Parameters:
node1 - the first node
node2 - the second node
child - the child node (of the first node)
Returns:
a child of the second node, with which a combination is possible


Copyright © 2001-2007 The Apache Software Foundation. All Rights Reserved.