org.apache.commons.configuration
Class BaseConfigurationXMLReader.SAXConverter

java.lang.Object
  extended byorg.apache.commons.configuration.HierarchicalConfigurationConverter
      extended byorg.apache.commons.configuration.BaseConfigurationXMLReader.SAXConverter
Enclosing class:
BaseConfigurationXMLReader

class BaseConfigurationXMLReader.SAXConverter
extends HierarchicalConfigurationConverter

An internally used helper class to iterate over all configuration keys ant to generate corresponding SAX events.


Constructor Summary
(package private) BaseConfigurationXMLReader.SAXConverter()
           
 
Method Summary
protected  void closeElements(ConfigurationKey keyLast, ConfigurationKey keyAct)
          Fires all necessary element end events for the specified keys.
protected  void elementEnd(String name)
          Callback for the end of an element.
protected  void elementStart(String name, Object value)
          Callback for the start of an element.
protected  void fireValue(String name, Object value)
          Fires all necessary element start events with the actual element values.
protected  String openElements(ConfigurationKey keyLast, ConfigurationKey keyAct, Configuration config, Set keySet)
          Fires all necessary element start events for the specified key.
 void process(Configuration config)
          Processes the specified configuration object.
protected  Iterator reverseIterator(ConfigurationKey key)
          Helper method for determining a reverse iterator for the specified key.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

BaseConfigurationXMLReader.SAXConverter

BaseConfigurationXMLReader.SAXConverter()
Method Detail

elementStart

protected void elementStart(String name,
                            Object value)
Callback for the start of an element.

Specified by:
elementStart in class HierarchicalConfigurationConverter
Parameters:
name - the element name
value - the element value

elementEnd

protected void elementEnd(String name)
Callback for the end of an element.

Specified by:
elementEnd in class HierarchicalConfigurationConverter
Parameters:
name - the element name

process

public void process(Configuration config)
Processes the specified configuration object. This method implements the iteration over the configuration's keys. All defined keys are translated into a set of element start and end events represented by calls to the elementStart() and elementEnd() methods.

Parameters:
config - the configuration to be processed

closeElements

protected void closeElements(ConfigurationKey keyLast,
                             ConfigurationKey keyAct)
Fires all necessary element end events for the specified keys. This method is called for each key obtained from the configuration to be converted. It calculates the common part of the actual and the last processed key and thus determines how many elements must be closed.

Parameters:
keyLast - the last processed key
keyAct - the actual key

reverseIterator

protected Iterator reverseIterator(ConfigurationKey key)
Helper method for determining a reverse iterator for the specified key. This implementation returns an iterator that returns the parts of the given key in reverse order, ignoring indices.

Parameters:
key - the key
Returns:
a reverse iterator for the parts of this key

openElements

protected String openElements(ConfigurationKey keyLast,
                              ConfigurationKey keyAct,
                              Configuration config,
                              Set keySet)
Fires all necessary element start events for the specified key. This method is called for each key obtained from the configuration to be converted. It ensures that all elements "between" the last key and the actual key are opened and their values are set.

Parameters:
keyLast - the last processed key
keyAct - the actual key
config - the configuration to process
keySet - the set with the processed keys
Returns:
the name of the last element on the path

fireValue

protected void fireValue(String name,
                         Object value)
Fires all necessary element start events with the actual element values. This method is called for each key obtained from the configuration to be processed with the last part of the key as argument. The value can be either a single value or a collection.

Parameters:
name - the name of the actual element
value - the element's value


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