| /* |
| * Copyright (c) 2000 World Wide Web Consortium, |
| * (Massachusetts Institute of Technology, Institut National de |
| * Recherche en Informatique et en Automatique, Keio University). All |
| * Rights Reserved. This program is distributed under the W3C's Software |
| * Intellectual Property License. This program is distributed in the |
| * hope that it will be useful, but WITHOUT ANY WARRANTY; without even |
| * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
| * PURPOSE. |
| * See W3C License http://www.w3.org/Consortium/Legal/ for more details. |
| */ |
| |
| package org.w3c.dom; |
| |
| /** |
| * The <code>DOMImplementation</code> interface provides a number of methods |
| * for performing operations that are independent of any particular instance |
| * of the document object model. |
| * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>. |
| */ |
| public interface DOMImplementation { |
| /** |
| * Test if the DOM implementation implements a specific feature. |
| * @param 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". |
| * @param 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 <code>true</code>. |
| * @return <code>true</code> if the feature is implemented in the |
| * specified version, <code>false</code> otherwise. |
| */ |
| public boolean hasFeature(String feature, |
| String version); |
| |
| /** |
| * Creates an empty <code>DocumentType</code> node. Entity declarations |
| * and notations are not made available. Entity reference expansions and |
| * default attribute additions do not occur. It is expected that a |
| * future version of the DOM will provide a way for populating a |
| * <code>DocumentType</code>. |
| * <br>HTML-only DOM implementations do not need to implement this method. |
| * @param qualifiedNameThe qualified name of the document type to be |
| * created. |
| * @param publicIdThe external subset public identifier. |
| * @param systemIdThe external subset system identifier. |
| * @return A new <code>DocumentType</code> node with |
| * <code>Node.ownerDocument</code> set to <code>null</code>. |
| * @exception DOMException |
| * INVALID_CHARACTER_ERR: Raised if the specified qualified name |
| * contains an illegal character. |
| * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is |
| * malformed. |
| * @since DOM Level 2 |
| */ |
| public DocumentType createDocumentType(String qualifiedName, |
| String publicId, |
| String systemId) |
| throws DOMException; |
| |
| /** |
| * Creates an XML <code>Document</code> object of the specified type with |
| * its document element. HTML-only DOM implementations do not need to |
| * implement this method. |
| * @param namespaceURIThe namespace URI of the document element to create. |
| * @param qualifiedNameThe qualified name of the document element to be |
| * created. |
| * @param doctypeThe type of document to be created or <code>null</code>. |
| * When <code>doctype</code> is not <code>null</code>, its |
| * <code>Node.ownerDocument</code> attribute is set to the document |
| * being created. |
| * @return A new <code>Document</code> object. |
| * @exception DOMException |
| * INVALID_CHARACTER_ERR: Raised if the specified qualified name |
| * contains an illegal character. |
| * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is |
| * malformed, if the <code>qualifiedName</code> has a prefix and the |
| * <code>namespaceURI</code> is <code>null</code>, or if the |
| * <code>qualifiedName</code> has a prefix that is "xml" and the |
| * <code>namespaceURI</code> is different from " |
| * http://www.w3.org/XML/1998/namespace" . |
| * <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already |
| * been used with a different document or was created from a different |
| * implementation. |
| * @since DOM Level 2 |
| */ |
| public Document createDocument(String namespaceURI, |
| String qualifiedName, |
| DocumentType doctype) |
| throws DOMException; |
| |
| } |