Package org.jdom.adapters
Class AbstractDOMAdapter
- java.lang.Object
-
- org.jdom.adapters.AbstractDOMAdapter
-
- All Implemented Interfaces:
DOMAdapter
- Direct Known Subclasses:
CrimsonDOMAdapter
,JAXPDOMAdapter
,OracleV1DOMAdapter
,OracleV2DOMAdapter
,XercesDOMAdapter
,XML4JDOMAdapter
public abstract class AbstractDOMAdapter extends java.lang.Object implements DOMAdapter
A DOMAdapter utility abstract base class.- Version:
- $Revision: 1.21 $, $Date: 2007/11/10 05:28:59 $
- Author:
- Brett McLaughlin, Jason Hunter
-
-
Constructor Summary
Constructors Constructor Description AbstractDOMAdapter()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description abstract org.w3c.dom.Document
createDocument()
This creates an emptyDocument
object based on a specific parser implementation.org.w3c.dom.Document
createDocument(DocType doctype)
This creates an emptyDocument
object based on a specific parser implementation with the given DOCTYPE.org.w3c.dom.Document
getDocument(java.io.File filename, boolean validate)
This creates a new
from an existingDocument
InputStream
by letting a DOM parser handle parsing using the supplied stream.abstract org.w3c.dom.Document
getDocument(java.io.InputStream in, boolean validate)
This creates a new
from an existingDocument
InputStream
by letting a DOM parser handle parsing using the supplied stream.protected void
setInternalSubset(org.w3c.dom.DocumentType dt, java.lang.String s)
This attempts to change the DocumentType to have the given internal DTD subset value.
-
-
-
Method Detail
-
getDocument
public org.w3c.dom.Document getDocument(java.io.File filename, boolean validate) throws java.io.IOException, JDOMException
This creates a new
from an existingDocument
InputStream
by letting a DOM parser handle parsing using the supplied stream.- Specified by:
getDocument
in interfaceDOMAdapter
- Parameters:
filename
- file to parse.validate
-boolean
to indicate if validation should occur.- Returns:
Document
- instance ready for use.- Throws:
java.io.IOException
- when I/O error occurs.JDOMException
- when errors occur in parsing.
-
getDocument
public abstract org.w3c.dom.Document getDocument(java.io.InputStream in, boolean validate) throws java.io.IOException, JDOMException
This creates a new
from an existingDocument
InputStream
by letting a DOM parser handle parsing using the supplied stream.- Specified by:
getDocument
in interfaceDOMAdapter
- Parameters:
in
-InputStream
to parse.validate
-boolean
to indicate if validation should occur.- Returns:
Document
- instance ready for use.- Throws:
java.io.IOException
- when I/O error occurs.JDOMException
- when errors occur in parsing.
-
createDocument
public abstract org.w3c.dom.Document createDocument() throws JDOMException
This creates an emptyDocument
object based on a specific parser implementation.- Specified by:
createDocument
in interfaceDOMAdapter
- Returns:
Document
- created DOM Document.- Throws:
JDOMException
- when errors occur.
-
createDocument
public org.w3c.dom.Document createDocument(DocType doctype) throws JDOMException
This creates an emptyDocument
object based on a specific parser implementation with the given DOCTYPE. If the doctype parameter is null, the behavior is the same as callingcreateDocument()
.- Specified by:
createDocument
in interfaceDOMAdapter
- Parameters:
doctype
- InitialDocType
of the document.- Returns:
Document
- created DOM Document.- Throws:
JDOMException
- when errors occur.
-
setInternalSubset
protected void setInternalSubset(org.w3c.dom.DocumentType dt, java.lang.String s)
This attempts to change the DocumentType to have the given internal DTD subset value. This is not a standard ability in DOM, so it's only available with some parsers. Subclasses can alter the mechanism by which the attempt is made to set the value.- Parameters:
dt
- DocumentType to be altereds
- String to use as the internal DTD subset
-
-