org.apache.xerces.dom
Class DOMImplementationImpl

java.lang.Object
  |
  +--org.apache.xerces.dom.DOMImplementationImpl

All Implemented Interfaces:

org.w3c.dom.DOMImplementation, org.apache.xerces.dom3.as.DOMImplementationAS, org.apache.xerces.dom3.ls.DOMImplementationLS

public class DOMImplementationImpl

extends java.lang.Object

implements org.w3c.dom.DOMImplementation, org.apache.xerces.dom3.ls.DOMImplementationLS, org.apache.xerces.dom3.as.DOMImplementationAS

The DOMImplementation class is description of a particular implementation of the Document Object Model. As such its data is static, shared by all instances of this implementation.

The DOM API requires that it be a real object rather than static methods. However, there's nothing that says it can't be a singleton, so that's how I've implemented it.

Since:

PR-DOM-Level-1-19980818.

Version:

$Id: DOMImplementationImpl.java,v 1.21 2002/01/29 01:15:07 lehors Exp $

Fields inherited from interface org.apache.xerces.dom3.ls.DOMImplementationLS

MODE_ASYNCHRONOUS, MODE_SYNCHRONOUS

Constructor Summary

DOMImplementationImpl()

Method Summary

org.apache.xerces.dom3.as.ASModel	createAS(boolean isNamespaceAware) DOM Level 3 WD - Experimental.
org.w3c.dom.Document	createDocument(java.lang.String namespaceURI, java.lang.String qualifiedName, org.w3c.dom.DocumentType doctype) Introduced in DOM Level 2.
org.w3c.dom.DocumentType	createDocumentType(java.lang.String qualifiedName, java.lang.String publicID, java.lang.String systemID) Introduced in DOM Level 2.
org.apache.xerces.dom3.as.DOMASBuilder	createDOMASBuilder() DOM Level 3 WD - Experimental.
org.apache.xerces.dom3.as.DOMASWriter	createDOMASWriter() DOM Level 3 WD - Experimental.
org.apache.xerces.dom3.ls.DOMBuilder	createDOMBuilder(short mode) DOM Level 3 WD - Experimental.
org.apache.xerces.dom3.ls.DOMInputSource	createDOMInputSource() DOM Level 3 WD - Experimental.
org.apache.xerces.dom3.ls.DOMWriter	createDOMWriter() DOM Level 3 WD - Experimental.
static org.w3c.dom.DOMImplementation	getDOMImplementation() NON-DOM: Obtain and return the single shared object
boolean	hasFeature(java.lang.String feature, java.lang.String version) Test if the DOM implementation supports a specific "feature" -- currently meaning language and level thereof.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DOMImplementationImpl

public DOMImplementationImpl()

Method Detail

hasFeature

public boolean hasFeature(java.lang.String feature,
                          java.lang.String version)

Test if the DOM implementation supports a specific "feature" -- currently meaning language and level thereof.

Specified by:

hasFeature in interface org.w3c.dom.DOMImplementation

Parameters:

feature - The package name of the feature to test. In Level 1, supported values are "HTML" and "XML" (case-insensitive). At this writing, org.apache.xerces.dom supports only XML.

version - The version number of the feature being tested. This is interpreted as "Version of the DOM API supported for the specified Feature", and in Level 1 should be "1.0"

getDOMImplementation

public static org.w3c.dom.DOMImplementation getDOMImplementation()

NON-DOM: Obtain and return the single shared object

createDocumentType

public org.w3c.dom.DocumentType createDocumentType(java.lang.String qualifiedName,
                                                   java.lang.String publicID,
                                                   java.lang.String systemID)

Introduced in DOM Level 2.

Creates an empty DocumentType node.

Specified by:

createDocumentType in interface org.w3c.dom.DOMImplementation

Parameters:

qualifiedName - The qualified name of the document type to be created.

publicID - The document type public identifier.

systemID - The document type system identifier.

Since:

WD-DOM-Level-2-19990923

createDocument

public org.w3c.dom.Document createDocument(java.lang.String namespaceURI,
                                           java.lang.String qualifiedName,
                                           org.w3c.dom.DocumentType doctype)
                                    throws org.w3c.dom.DOMException

Introduced in DOM Level 2.

Creates an XML Document object of the specified type with its document element.

Specified by:

createDocument in interface org.w3c.dom.DOMImplementation

Parameters:

namespaceURI - The namespace URI of the document element to create, or null.

qualifiedName - The qualified name of the document element to create.

doctype - The 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:

Document A new Document object.

Throws:

org.w3c.dom.DOMException - WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different document.

Since:

WD-DOM-Level-2-19990923

createDOMBuilder

public org.apache.xerces.dom3.ls.DOMBuilder createDOMBuilder(short mode)
                                                      throws org.w3c.dom.DOMException

DOM Level 3 WD - Experimental.

Specified by:

createDOMBuilder in interface org.apache.xerces.dom3.ls.DOMImplementationLS

Following copied from interface: org.apache.xerces.dom3.ls.DOMImplementationLS

Parameters:

mode - The mode argument is either MODE_SYNCHRONOUS or MODE_ASYNCHRONOUS, if mode is MODE_SYNCHRONOUS then the DOMBuilder that is created will operate in synchronous mode, if it's MODE_ASYNCHRONOUS then the DOMBuilder that is created will operate in asynchronous mode.

Returns:

The newly created DOMBuilder object, this DOMBuilder is either synchronous or asynchronous depending on the value of the type argument.

Throws:

org.w3c.dom.DOMException - Raise a NOT_SUPPORTED_ERR exception if MODE_ASYNCHRONOUS is not supported.

createDOMWriter

public org.apache.xerces.dom3.ls.DOMWriter createDOMWriter()

DOM Level 3 WD - Experimental.

Specified by:

createDOMWriter in interface org.apache.xerces.dom3.ls.DOMImplementationLS

Following copied from interface: org.apache.xerces.dom3.ls.DOMImplementationLS

Returns:

The newly created DOMWriter object.

createDOMInputSource

public org.apache.xerces.dom3.ls.DOMInputSource createDOMInputSource()

DOM Level 3 WD - Experimental.

Specified by:

createDOMInputSource in interface org.apache.xerces.dom3.ls.DOMImplementationLS

Following copied from interface: org.apache.xerces.dom3.ls.DOMImplementationLS

Returns:

The newly created DOMBuilder object, this DOMBuilder is either synchronous or asynchronous depending on the value of the type argument.

createAS

public org.apache.xerces.dom3.as.ASModel createAS(boolean isNamespaceAware)

DOM Level 3 WD - Experimental. Creates an ASModel.

Specified by:

createAS in interface org.apache.xerces.dom3.as.DOMImplementationAS

Parameters:

isNamespaceAware - Allow creation of ASModel with this attribute set to a specific value.

Returns:

A null return indicates failure.what is a failure? Could be a system error.

createDOMASBuilder

public org.apache.xerces.dom3.as.DOMASBuilder createDOMASBuilder()

DOM Level 3 WD - Experimental. Creates an DOMASBuilder.Do we need the method since we already have DOMImplementationLS.createDOMBuilder?

Specified by:

createDOMASBuilder in interface org.apache.xerces.dom3.as.DOMImplementationAS

Returns:

DOMASBuilder

createDOMASWriter

public org.apache.xerces.dom3.as.DOMASWriter createDOMASWriter()

DOM Level 3 WD - Experimental. Creates an DOMASWriter.

Specified by:

createDOMASWriter in interface org.apache.xerces.dom3.as.DOMImplementationAS

Returns:

a DOMASWriter