|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.avalon.framework.configuration.DefaultConfigurationBuilder
A DefaultConfigurationBuilder builds Configuration
s from XML,
via a SAX2 compliant parser.
XML namespace support is optional, and disabled by default to preserve
backwards-compatibility. To enable it, pass the DefaultConfigurationBuilder(boolean)
constructor the flag true
, or pass
a namespace-enabled XMLReader
to the DefaultConfigurationBuilder(XMLReader)
constructor.
The mapping from XML namespaces to Configuration
namespaces is pretty
straightforward, with one caveat: attribute namespaces are (deliberately) not
supported. Enabling namespace processing has the following effects:
xmlns:
are interpreted as
declaring a prefix:namespaceURI mapping, and won't result in the creation of
xmlns
-prefixed attributes in the Configuration
.
Configuration
with getName()
.equals("title")
and getNamespace()
.equals("http://foo.com")
.
Constructor Summary | |
DefaultConfigurationBuilder()
Create a Configuration Builder with a default XMLReader that ignores namespaces. |
|
DefaultConfigurationBuilder(boolean enableNamespaces)
Create a Configuration Builder, specifying a flag that determines namespace support. |
|
DefaultConfigurationBuilder(org.xml.sax.XMLReader parser)
Create a Configuration Builder with your own XMLReader. |
Method Summary | |
Configuration |
build(org.xml.sax.InputSource input)
Build a configuration object using an XML InputSource object |
Configuration |
build(java.io.InputStream inputStream)
Build a configuration object using an InputStream. |
Configuration |
build(java.lang.String uri)
Build a configuration object using an URI |
Configuration |
buildFromFile(java.io.File file)
Build a configuration object from a file using a File object. |
Configuration |
buildFromFile(java.lang.String filename)
Build a configuration object from a file using a filename. |
protected SAXConfigurationHandler |
getHandler()
Get a SAXConfigurationHandler for your configuration reading. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DefaultConfigurationBuilder()
public DefaultConfigurationBuilder(boolean enableNamespaces)
enableNamespaces
- If true
, a namespace-aware
SAXParser
is used. If false
, the default JAXP
SAXParser
(without namespace support) is used.public DefaultConfigurationBuilder(org.xml.sax.XMLReader parser)
Method Detail |
protected SAXConfigurationHandler getHandler()
public Configuration buildFromFile(java.lang.String filename) throws org.xml.sax.SAXException, java.io.IOException, ConfigurationException
public Configuration buildFromFile(java.io.File file) throws org.xml.sax.SAXException, java.io.IOException, ConfigurationException
public Configuration build(java.io.InputStream inputStream) throws org.xml.sax.SAXException, java.io.IOException, ConfigurationException
public Configuration build(java.lang.String uri) throws org.xml.sax.SAXException, java.io.IOException, ConfigurationException
public Configuration build(org.xml.sax.InputSource input) throws org.xml.sax.SAXException, java.io.IOException, ConfigurationException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |