org.jvnet.hk2.config
Class ConfigParser

java.lang.Object
  extended by org.jvnet.hk2.config.ConfigParser

public class ConfigParser
extends Object

Parses configuration files, builds Inhabitants, and add them to Habitat.

This class also maintains the model of various elements in the configuration file.

This class can be sub-classed to create a ConfigParser with a custom non-standard behavior.

Author:
Kohsuke Kawaguchi

Field Summary
protected  Habitat habitat
          This is where we put parsed inhabitants into.
 
Constructor Summary
ConfigParser(Habitat habitat)
           
 
Method Summary
protected  Dom handleElement(XMLStreamReader in, DomDocument document, Dom parent)
          Parses a whole XML tree and builds a Dom tree.
protected  Dom handleElement(XMLStreamReader in, DomDocument document, Dom parent, ConfigModel model)
          Parses a whole XML tree and builds a Dom tree, by using the given model for the top-level element.
 DomDocument parse(URL source)
          Parses the given source as a config file, and adds resulting Doms into Habitat as Inhabitants.
 DomDocument parse(URL source, DomDocument document)
           
 DomDocument parse(URL source, DomDocument document, Dom parent)
           
 DomDocument parse(XMLStreamReader in)
           
 void parse(XMLStreamReader in, DomDocument document)
           
 void parse(XMLStreamReader in, DomDocument document, Dom parent)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

habitat

protected final Habitat habitat
This is where we put parsed inhabitants into.

Constructor Detail

ConfigParser

public ConfigParser(Habitat habitat)
Method Detail

parse

public DomDocument parse(XMLStreamReader in)
                  throws XMLStreamException
Throws:
XMLStreamException

parse

public void parse(XMLStreamReader in,
                  DomDocument document)
           throws XMLStreamException
Throws:
XMLStreamException

parse

public void parse(XMLStreamReader in,
                  DomDocument document,
                  Dom parent)
           throws XMLStreamException
Throws:
XMLStreamException

parse

public DomDocument parse(URL source)
Parses the given source as a config file, and adds resulting Doms into Habitat as Inhabitants.


parse

public DomDocument parse(URL source,
                         DomDocument document)

parse

public DomDocument parse(URL source,
                         DomDocument document,
                         Dom parent)

handleElement

protected Dom handleElement(XMLStreamReader in,
                            DomDocument document,
                            Dom parent)
                     throws XMLStreamException
Parses a whole XML tree and builds a Dom tree.

This is the entry point for the root element of a configuration tree.

Parameters:
in - pre-condition: 'in' is at the start element. post-condition: 'in' is at the end element.
document - The document that we are building right now. Newly created Dom will belong to this document.
parent - The parent element
Returns:
Null if the XML element didn't yield anything (which can happen if the element is skipped.) Otherwise fully parsed valid Dom object.
Throws:
XMLStreamException

handleElement

protected Dom handleElement(XMLStreamReader in,
                            DomDocument document,
                            Dom parent,
                            ConfigModel model)
                     throws XMLStreamException
Parses a whole XML tree and builds a Dom tree, by using the given model for the top-level element.

This is the entry point for recursively parsing inside a configuration tree. Since not every element is global, you don't always want to infer the model just from the element name (as is the case with handleElement(XMLStreamReader, DomDocument, Dom).

Parameters:
in - pre-condition: 'in' is at the start element. post-condition: 'in' is at the end element.
document - The document that we are building right now. Newly created Dom will belong to this document.
parent - The parent element
Returns:
Null if the XML element didn't yield anything (which can happen if the element is skipped.) Otherwise fully parsed valid Dom object.
Throws:
XMLStreamException


Copyright © 2013 Oracle Corporation. All Rights Reserved.