| Prev Class | Next Class | Frames | No Frames |
| Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Objectorg.jdom.input.DOMBuilderpublic class DOMBuilderextends java.lang.ObjectDOMBuilder builds a JDOM tree using DOM.
Note that this class should only be used for building from a pre-existing
DOM tree. The class can be used to build from files, streams, etc but
other builders like SAXBuilder can perform the task faster because
they don't create a DOM tree first.
Constructor Summary | |
| |
| |
| |
| |
Method Summary | |
Document |
|
Document |
|
Document |
|
Document |
|
Element |
|
void |
|
void |
|
public DOMBuilder()
This creates a new DOMBuilder which will attempt to first locate a parser via JAXP, then will try to use a set of default parsers. The underlying parser will not validate.
public DOMBuilder(String adapterClass)
This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser. The underlying parser will not validate.
- Parameters:
adapterClass-Stringname of class to use for DOM building.
public DOMBuilder(String adapterClass,
boolean validate)This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser. The underlying parser will validate or not according to the given parameter.
- Parameters:
adapterClass-Stringname of class to use for DOM building.validate-booleanindicating if validation should occur.
public DOMBuilder(boolean validate)
This creates a new DOMBuilder which will attempt to first locate a parser via JAXP, then will try to use a set of default parsers. The underlying parser will validate or not according to the given parameter.
- Parameters:
validate-booleanindicating if validation should occur.
public Document build(File file) throws JDOMException
Deprecated. Deprecated in Beta 7,
should be used for building from any input other than a DOM treeSAXBuilderThis builds a document from the supplied filename by constructing a DOM tree and reading information from the DOM to create a JDOM document, a slower approach than SAXBuilder but useful for debugging.
- Parameters:
file-Fileto read from.
- Returns:
Document- resultant Document object.
- Throws:
JDOMException- when errors occur in parsing.
public Document build(InputStream in) throws JDOMException
Deprecated. Deprecated in Beta 7,
should be used for building from any input other than a DOM treeSAXBuilderThis builds a document from the supplied input stream by constructing a DOM tree and reading information from the DOM to create a JDOM document, a slower approach than SAXBuilder but useful for debugging.
- Parameters:
in-InputStreamto read from.
- Returns:
Document- resultant Document object.
- Throws:
JDOMException- when errors occur in parsing.
public Document build(URL url) throws JDOMException
Deprecated. Deprecated in Beta 7,
should be used for building from any input other than a DOM treeSAXBuilderThis builds a document from the supplied URL by constructing a DOM tree and reading information from the DOM to create a JDOM document, a slower approach than SAXBuilder but useful for debugging.
- Parameters:
url-URLto read from.
- Returns:
Document- resultant Document object.
- Throws:
JDOMException- when errors occur in parsing.
public Document build(org.w3c.dom.Document domDocument)
This will build a JDOM tree from an existing DOM tree.
- Parameters:
domDocument-org.w3c.dom.Documentobject
- Returns:
Document- JDOM document object.
public Element build(org.w3c.dom.Element domElement)
This will build a JDOM Element from an existing DOM Element
- Parameters:
domElement-org.w3c.dom.Elementobject
- Returns:
Element- JDOM Element object
public void setValidation(boolean validate)
This sets validation for the builder.
- Parameters:
validate-booleanindicating whether validation should occur.