Module java.xml
Package org.w3c.dom

# Interface DOMImplementation

All Known Subinterfaces:
  `DOMImplementationCSS`, `HTMLDOMImplementation`

public interface DOMImplementation
The `DOMImplementation` interface provides a number of methods for performing operations that are independent of any particular instance of the document object model.

See also the Document Object Model (DOM) Level 3 Core Specification.

## Method Summary

Modifier and Type
Method
Description
`Document`
`createDocument(String namespaceURI, String qualifiedName, DocumentType doctype)`
Creates a DOM Document object of the specified type with its document element.
`DocumentType`
`createDocumentType(String qualifiedName, String publicId, String systemId)`
Creates an empty `DocumentType` node.
`Object`
`getFeature(String feature, String version)`
This method returns a specialized object which implements the specialized APIs of the specified feature and version, as specified in DOM Features.
`boolean`
`hasFeature(String feature, String version)`
Test if the DOM implementation implements a specific feature and version, as specified in DOM Features.

## Method Details

### hasFeature

boolean hasFeature(String feature, String version)
Test if the DOM implementation implements a specific feature and version, as specified in DOM Features.

Parameters:
  `feature` - The name of the feature to test.
  `version` - This is the version number of the feature to test.
Returns:
  `true` if the feature is implemented in the specified version, `false` otherwise.

### createDocumentType

DocumentType createDocumentType(String qualifiedName, String publicId, String systemId) throws DOMException
Creates an empty `DocumentType` node. Entity declarations and notations are not made available. Entity reference expansions and default attribute additions do not occur..

Parameters:
  `qualifiedName` - The qualified name of the document type to be created.
  `publicId` - The external subset public identifier.
  `systemId` - The 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 is not an XML name according to [XML 1.0].
  NAMESPACE_ERR: Raised if the `qualifiedName` is malformed.
  NOT_SUPPORTED_ERR: May be raised if the implementation does not support the feature "XML" and the language exposed through the Document does not support XML Namespaces (such as [HTML 4.01]).
Since:
  1.4, DOM Level 2

### createDocument

Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) throws DOMException
Creates a DOM Document object of the specified type with its document element.
Note that based on the `DocumentType` given to create the document, the implementation may instantiate specialized `Document` objects that support additional features than the "Core", such as "HTML" [DOM Level 2 HTML] . On the other hand, setting the `DocumentType` after the document was created makes this very unlikely to happen. Alternatively, specialized `Document` creation methods, such as `createHTMLDocument` [DOM Level 2 HTML] , can be used to obtain specific types of `Document` objects.

Parameters:
  `namespaceURI` - The namespace URI of the document element to create or `null`.
  `qualifiedName` - The qualified name of the document element to be created or `null`.
  `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:
  A new `Document` object with its document element. If the `NamespaceURI`, `qualifiedName`, and `doctype` are `null`, the returned `Document` is empty with no document element.
Throws:
  `DOMException` - INVALID_CHARACTER_ERR: Raised if the specified qualified name is not an XML name according to [XML 1.0].
  NAMESPACE_ERR: Raised if the `qualifiedName` is malformed, if the `qualifiedName` has a prefix and the `namespaceURI` is `null`, or if the `qualifiedName` is `null` and the `namespaceURI` is different from `null`, or if the `qualifiedName` has a prefix that is "xml" and the `namespaceURI` is different from " http://www.w3.org/XML/1998/namespace" [XML Namespaces] , or if the DOM implementation does not support the `"XML"` feature but a non-null namespace URI was provided, since namespaces were defined by XML.
  WRONG_DOCUMENT_ERR: Raised if `doctype` has already been used with a different document or was created from a different implementation.
  NOT_SUPPORTED_ERR: May be raised if the implementation does not support the feature "XML" and the language exposed through the Document does not support XML Namespaces (such as [HTML 4.01]).
Since:
  1.4, DOM Level 2

### getFeature

Object getFeature(String feature, String version)
This method returns a specialized object which implements the specialized APIs of the specified feature and version, as specified in DOM Features. The specialized object may also be obtained by using binding-specific casting methods but is not necessarily expected to, as discussed in . This method also allow the implementation to provide specialized objects which do not support the `DOMImplementation` interface.

Parameters:
  `feature` - The name of the feature requested. Note that any plus sign "+" prepended to the name of the feature will be ignored since it is not significant in the context of this method.
  `version` - This is the version number of the feature to test.
Returns:
  Returns an object which implements the specialized APIs of the specified feature and version, if any, or `null` if there is no object which implements interfaces associated with that feature. If the `DOMObject` returned by this method implements the `DOMImplementation` interface, it must delegate to the primary core `DOMImplementation` and not return results inconsistent with the primary core `DOMImplementation` such as `hasFeature`, `getFeature`, etc.
Since:
  1.5, DOM Level 3