org.jdom.input

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

Version:
$Revision: 1.42 $, $Date: 2002/02/12 06:15:20 $

Authors:
Brett McLaughlin
Jason Hunter
Philip Nelson
Kevin Regan
Yusuf Goolamabbas
Dan Schaffer
Bradley S. Huffman

Constructor Summary

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.
DOMBuilder(String adapterClass)
This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser.
DOMBuilder(String adapterClass, boolean validate)
This creates a new DOMBuilder using the specified DOMAdapter implementation as a way to choose the underlying parser.
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.

Method Summary

Document
build(File file)
Deprecated. Deprecated in Beta 7, SAXBuilder should be used for building from any input other than a DOM tree
Document
build(InputStream in)
Deprecated. Deprecated in Beta 7, SAXBuilder should be used for building from any input other than a DOM tree
Document
build(URL url)
Deprecated. Deprecated in Beta 7, SAXBuilder should be used for building from any input other than a DOM tree
Document
build(org.w3c.dom.Document domDocument)
This will build a JDOM tree from an existing DOM tree.
Element
build(org.w3c.dom.Element domElement)
This will build a JDOM Element from an existing DOM Element
void
setFactory(JDOMFactory factory)
void
setValidation(boolean validate)
This sets validation for the builder.

Constructor Details

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.


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.


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.


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.

Method Details

build

public Document build(File file)
            throws JDOMException

Deprecated. Deprecated in Beta 7, 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.


build

public Document build(InputStream in)
            throws JDOMException

Deprecated. Deprecated in Beta 7, 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.


build

public Document build(URL url)
            throws JDOMException

Deprecated. Deprecated in Beta 7, 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.


build

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.


build

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


setFactory

public void setFactory(JDOMFactory factory)


setValidation

public void setValidation(boolean validate)
This sets validation for the builder.

Parameters:
validate - boolean indicating whether validation should occur.


Copyright B) 2002 Jason Hunter, Brett McLaughlin. All Rights Reserved.