All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class org.jdom.input.DOMBuilder

java.lang.Object
   |
   +----org.jdom.input.DOMBuilder

public class DOMBuilder
extends 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.

Version:
$Revision: 1.42 $, $Date: 2002/02/12 06:15:20 $
Author:
Brett McLaughlin, Jason Hunter, Philip Nelson, Kevin Regan, Yusuf Goolamabbas, Dan Schaffer, Bradley S. Huffman

Constructor Index

 o 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.

 o DOMBuilder(boolean)

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.

 o DOMBuilder(String)

This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser.

 o DOMBuilder(String, boolean)

This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser.

Method Index

 o build(Document)

This will build a JDOM tree from an existing DOM tree.

 o build(Element)

This will build a JDOM Element from an existing DOM Element

 o build(File)

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. Deprecated.

 o build(InputStream)

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. Deprecated.

 o build(URL)

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. Deprecated.

 o setFactory(JDOMFactory)
 o setValidation(boolean)

This sets validation for the builder.

Constructors

 o DOMBuilder
 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.

 o DOMBuilder
 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.
 o DOMBuilder
 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.
 o DOMBuilder
 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.

Methods

 o setFactory
 public void setFactory(JDOMFactory factory)
 o setValidation
 public void setValidation(boolean validate)

This sets validation for the builder.

Parameters:
validate - boolean indicating whether validation should occur.
 o build
 public Document build(InputStream in) throws JDOMException
Note: build() is deprecated. Deprecated in Beta 7, {@link SAXBuilder} should be used for building from any input other than a DOM tree

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.
 o build
 public Document build(File file) throws JDOMException
Note: build() is deprecated. Deprecated in Beta 7, {@link SAXBuilder} should be used for building from any input other than a DOM tree

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.
 o build
 public Document build(URL url) throws JDOMException
Note: build() is deprecated. Deprecated in Beta 7, {@link SAXBuilder} should be used for building from any input other than a DOM tree

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.
 o build
 public Document build(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.
 o build
 public Element build(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

All Packages  Class Hierarchy  This Package  Previous  Next  Index