gnu.xml.dom
Class DomImpl

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

public class DomImpl
extends java.lang.Object
implements 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/06/23 05:17:19 $
Author:
David Brownell

Constructor Summary
DomImpl()
          Constructs a DOMImplementation object which supports "XML" and other DOM Level 2 features.
 
Method Summary
 Document createDocument(java.lang.String namespaceURI, java.lang.String rootName, DocumentType doctype)
          DOM L2 Creates and returns a Document, populated only with a root element and optionally a document type (if that was provided).
 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 DOMImplementation
Following copied from interface: org.w3c.dom.DOMImplementation
Parameters:
featureThe - name of the feature to test (case-insensitive). The values used by DOM features are defined throughout the DOM Level 2 specifications and listed in the section. The name must be an XML name. To avoid possible conflicts, as a convention, names referring to features defined outside the DOM specification should be made unique by reversing the name of the Internet domain name of the person (or the organization that the person belongs to) who defines the feature, component by component, and using this as a prefix. For instance, the W3C SVG Working Group defines the feature "org.w3c.dom.svg".
versionThis - is the version number of the feature to test. In Level 2, the string can be either "2.0" or "1.0". If the version is not specified, supporting any version of the feature causes the method to return true.
Returns:
true if the feature is implemented in the specified version, false otherwise.

createDocumentType

public 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 DOMImplementation
Following copied from interface: org.w3c.dom.DOMImplementation
Parameters:
qualifiedNameThe - qualified name of the document type to be created.
publicIdThe - external subset public identifier.
systemIdThe - external subset system identifier.
Returns:
A new DocumentType node with Node.ownerDocument set to null.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed.

createDocument

public Document createDocument(java.lang.String namespaceURI,
                               java.lang.String rootName,
                               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 DOMImplementation
Following copied from interface: org.w3c.dom.DOMImplementation
Parameters:
namespaceURIThe - namespace URI of the document element to create.
qualifiedNameThe - qualified name of the document element to be created.
doctypeThe - type of document to be created or null. When doctype is not null, its Node.ownerDocument attribute is set to the document being created.
Returns:
A new Document object.
Throws:
DOMException - INVALID_CHARACTER_ERR: Raised if the specified qualified name contains an illegal character.
NAMESPACE_ERR: Raised if the qualifiedName is malformed, if the qualifiedName has a prefix and the namespaceURI is null, or if the qualifiedName has a prefix that is "xml" and the namespaceURI is different from " http://www.w3.org/XML/1998/namespace" .
WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different document or was created from a different implementation.

Source code is GPL'd in the JAXP subproject at http://savannah.gnu.org/projects/classpathx
This documentation was derived from that source code on 2001-07-12.