org.jdom.adapters
Class AbstractDOMAdapter

Direct Known Subclasses:

CrimsonDOMAdapter, OracleV1DOMAdapter, OracleV2DOMAdapter, ProjectXDOMAdapter, XercesDOMAdapter, XML4JDOMAdapter

public abstract class AbstractDOMAdapter

implements DOMAdapter

AbstractDOMAdapter

This class defines wrapper behavior for obtaining a DOM Document object from a DOM parser.

Author:

Brett McLaughlin, Jason Hunter

Version: 1.0

public abstract Document createDocument()
                                  throws java.io.IOException

This creates an empty Document object based on a specific parser implementation.

Returns: Document - created DOM Document.

Throws:

IOException - when errors occur.

public Document getDocument(File filename, boolean validate)
                      throws java.io.IOException

This creates a new Document from an existing InputStream by letting a DOM parser handle parsing using the supplied stream.

Parameters:

in - InputStream to parse.

validate - boolean to indicate if validation should occur.

Returns: Document - instance ready for use.

Throws:

IOException - when errors occur in parsing.

public abstract Document getDocument(InputStream in, boolean validate)
                               throws java.io.IOException

This creates a new Document from an existing InputStream by letting a DOM parser handle parsing using the supplied stream.

Parameters:

in - InputStream to parse.

validate - boolean to indicate if validation should occur.

Returns: Document - instance ready for use.

Throws:

IOException - when errors occur in parsing.