gnu.xml.dom
Class DomImpl

java.lang.Object
  |
  +--gnu.xml.dom.DomImpl
All Implemented Interfaces:
org.w3c.dom.DOMImplementation

public class DomImpl
extends java.lang.Object
implements org.w3c.dom.DOMImplementation

"DOMImplementation" implementation.

At this writing, the following features are supported: "XML" (L1, L2), "Events" (L2), "MutationEvents" (L2), "USER-Events" (a conformant extension), "HTMLEvents" (L2), "UIEvents" (L2), "Traversal" (L2). It is possible to compile the package so it doesn't support some of these features (notably, Traversal).

Version:
$Date: 2001/11/20 04:57:05 $
Author:
David Brownell

Constructor Summary
DomImpl()
          Constructs a DOMImplementation object which supports "XML" and other DOM Level 2 features.
 
Method Summary
 org.w3c.dom.Document createDocument(java.lang.String namespaceURI, java.lang.String rootName, org.w3c.dom.DocumentType doctype)
          DOM L2 Creates and returns a Document, populated only with a root element and optionally a document type (if that was provided).
 org.w3c.dom.DocumentType createDocumentType(java.lang.String rootName, java.lang.String publicId, java.lang.String systemId)
          DOM L2 Creates and returns a DocumentType, associated with this implementation.
 boolean hasFeature(java.lang.String name, java.lang.String version)
          DOM L1 Returns true if the specified feature and version are supported.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DomImpl

public DomImpl()
Constructs a DOMImplementation object which supports "XML" and other DOM Level 2 features.

Method Detail

hasFeature

public boolean hasFeature(java.lang.String name,
                          java.lang.String version)
DOM L1 Returns true if the specified feature and version are supported. Note that the case of the feature name is ignored.

Specified by:
hasFeature in interface org.w3c.dom.DOMImplementation

createDocumentType

public org.w3c.dom.DocumentType createDocumentType(java.lang.String rootName,
                                                   java.lang.String publicId,
                                                   java.lang.String systemId)
DOM L2 Creates and returns a DocumentType, associated with this implementation. This DocumentType can have no associated objects (notations, entities) until the DocumentType is first associated with a document.

Note that there is no implication that this DTD will be parsed by the DOM, or ever have contents. Moreover, the DocumentType created here can only be added to a document by the createDocument method (below). That means that the only portable way to create a Document object is to start parsing, queue comment and processing instruction (PI) nodes, and then only create a DOM Document after (a) it's known if a DocumentType object is needed, and (b) the name and namespace of the root element is known. Queued comment and PI nodes would then be inserted appropriately in the document prologue, both before and after the DTD node, and additional attributes assigned to the root element. (One hopes that the final DOM REC fixes this serious botch.)

Specified by:
createDocumentType in interface org.w3c.dom.DOMImplementation

createDocument

public org.w3c.dom.Document createDocument(java.lang.String namespaceURI,
                                           java.lang.String rootName,
                                           org.w3c.dom.DocumentType doctype)
DOM L2 Creates and returns a Document, populated only with a root element and optionally a document type (if that was provided).

Specified by:
createDocument in interface org.w3c.dom.DOMImplementation


Source code is under GPL (with library exception) in the JAXP project at http://www.gnu.org/software/classpathx/jaxp
This documentation was derived from that source code on 2003-06-07.