Package org.apache.commons.configuration2

# Class HierarchicalConfigurationXMLReader<T>

java.lang.Object
org.apache.commons.configuration2.ConfigurationXMLReader
org.apache.commons.configuration2.HierarchicalConfigurationXMLReader<T>

Type Parameters:
  `T` - the type of the nodes supported by this reader

All Implemented Interfaces:
  `XMLReader`

public class HierarchicalConfigurationXMLReader<T> extends ConfigurationXMLReader

A specialized SAX2 XML parser that "parses" hierarchical configuration objects.

This class mimics to be a SAX conform XML parser. Instead of parsing XML documents it processes a `Configuration` object and generates SAX events for the single properties defined there. This enables the whole world of XML processing for configuration objects.

The `HierarchicalConfiguration` object to be parsed can be specified using a constructor or the `setConfiguration()` method. This object will be processed by the `parse()` methods. Note that these methods ignore their argument.

- ## Field Summary

  ### Fields inherited from class org.apache.commons.configuration2.ConfigurationXMLReader

  `NS_URI`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `HierarchicalConfigurationXMLReader()`
  Creates a new instance of `HierarchicalConfigurationXMLReader`.
  `HierarchicalConfigurationXMLReader(HierarchicalConfiguration<T> config)`
  Creates a new instance of `HierarchicalConfigurationXMLReader` and sets the configuration to be parsed.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `HierarchicalConfiguration<T>`
  `getConfiguration()`
  Gets the configuration object to be parsed.
  `Configuration`
  `getParsedConfiguration()`
  Gets the configuration object to be processed.
  `protected void`
  `processKeys()`
  Processes the actual configuration object to generate SAX parsing events.
  `void`
  `setConfiguration(HierarchicalConfiguration<T> config)`
  Sets the configuration object to be parsed.

  ### Methods inherited from class org.apache.commons.configuration2.ConfigurationXMLReader

  `fireCharacters, fireElementEnd, fireElementStart, getContentHandler, getDTDHandler, getEntityResolver, getErrorHandler, getException, getFeature, getProperty, getRootName, parse, parse, parseConfiguration, setContentHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setProperty, setRootName`

  ### Methods inherited from class java.lang.Object

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

- ## Constructor Details

  - ### HierarchicalConfigurationXMLReader

    public HierarchicalConfigurationXMLReader()
    Creates a new instance of `HierarchicalConfigurationXMLReader`.

  - ### HierarchicalConfigurationXMLReader

    public HierarchicalConfigurationXMLReader(HierarchicalConfiguration<T> config)
    Creates a new instance of `HierarchicalConfigurationXMLReader` and sets the configuration to be parsed.
    Parameters:
      `config` - the configuration object

- ## Method Details

  - ### getConfiguration

    public HierarchicalConfiguration<T> getConfiguration()
    Gets the configuration object to be parsed.
    Returns:
      the configuration object to be parsed

  - ### getParsedConfiguration

    public Configuration getParsedConfiguration()
    Gets the configuration object to be processed.
    Specified by:
      `getParsedConfiguration` in class `ConfigurationXMLReader`
    Returns:
      the actual configuration object

  - ### processKeys

    protected void processKeys()
    Processes the actual configuration object to generate SAX parsing events.
    Specified by:
      `processKeys` in class `ConfigurationXMLReader`

  - ### setConfiguration

    public void setConfiguration(HierarchicalConfiguration<T> config)
    Sets the configuration object to be parsed.
    Parameters:
      `config` - the configuration object to be parsed