Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.jdom.input.DOMBuilder
public class DOMBuilder
extends java.lang.Object
DOMBuilder
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
-String
name 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
-String
name of class to use for DOM building.validate
-boolean
indicating 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
-boolean
indicating 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 tree
SAXBuilder
This 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
-File
to 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 tree
SAXBuilder
This 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
-InputStream
to 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 tree
SAXBuilder
This 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
-URL
to 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.Document
object
- 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.Element
object
- Returns:
Element
- JDOM Element object
public void setValidation(boolean validate)
This sets validation for the builder.
- Parameters:
validate
-boolean
indicating whether validation should occur.