+++ /dev/null
-/*\r
- * Copyright (c) 2000 World Wide Web Consortium,\r
- * (Massachusetts Institute of Technology, Institut National de\r
- * Recherche en Informatique et en Automatique, Keio University). All\r
- * Rights Reserved. This program is distributed under the W3C's Software\r
- * Intellectual Property License. This program is distributed in the\r
- * hope that it will be useful, but WITHOUT ANY WARRANTY; without even\r
- * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR\r
- * PURPOSE.\r
- * See W3C License http://www.w3.org/Consortium/Legal/ for more details.\r
- */\r
-\r
-package org.w3c.dom;\r
-\r
-/**\r
- * The <code>DOMImplementation</code> interface provides a number of methods \r
- * for performing operations that are independent of any particular instance \r
- * of the document object model.\r
- * <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>.\r
- */\r
-public interface DOMImplementation {\r
- /**\r
- * Test if the DOM implementation implements a specific feature.\r
- * @param featureThe name of the feature to test (case-insensitive). The \r
- * values used by DOM features are defined throughout the DOM Level 2 \r
- * specifications and listed in the section. The name must be an XML \r
- * name. To avoid possible conflicts, as a convention, names referring \r
- * to features defined outside the DOM specification should be made \r
- * unique by reversing the name of the Internet domain name of the \r
- * person (or the organization that the person belongs to) who defines \r
- * the feature, component by component, and using this as a prefix. \r
- * For instance, the W3C SVG Working Group defines the feature \r
- * "org.w3c.dom.svg".\r
- * @param versionThis is the version number of the feature to test. In \r
- * Level 2, the string can be either "2.0" or "1.0". If the version is \r
- * not specified, supporting any version of the feature causes the \r
- * method to return <code>true</code>.\r
- * @return <code>true</code> if the feature is implemented in the \r
- * specified version, <code>false</code> otherwise.\r
- */\r
- public boolean hasFeature(String feature, \r
- String version);\r
-\r
- /**\r
- * Creates an empty <code>DocumentType</code> node. Entity declarations \r
- * and notations are not made available. Entity reference expansions and \r
- * default attribute additions do not occur. It is expected that a \r
- * future version of the DOM will provide a way for populating a \r
- * <code>DocumentType</code>.\r
- * <br>HTML-only DOM implementations do not need to implement this method.\r
- * @param qualifiedNameThe qualified name of the document type to be \r
- * created. \r
- * @param publicIdThe external subset public identifier.\r
- * @param systemIdThe external subset system identifier.\r
- * @return A new <code>DocumentType</code> node with \r
- * <code>Node.ownerDocument</code> set to <code>null</code>.\r
- * @exception DOMException\r
- * INVALID_CHARACTER_ERR: Raised if the specified qualified name \r
- * contains an illegal character.\r
- * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is \r
- * malformed.\r
- * @since DOM Level 2\r
- */\r
- public DocumentType createDocumentType(String qualifiedName, \r
- String publicId, \r
- String systemId)\r
- throws DOMException;\r
-\r
- /**\r
- * Creates an XML <code>Document</code> object of the specified type with \r
- * its document element. HTML-only DOM implementations do not need to \r
- * implement this method.\r
- * @param namespaceURIThe namespace URI of the document element to create.\r
- * @param qualifiedNameThe qualified name of the document element to be \r
- * created.\r
- * @param doctypeThe type of document to be created or <code>null</code>.\r
- * When <code>doctype</code> is not <code>null</code>, its \r
- * <code>Node.ownerDocument</code> attribute is set to the document \r
- * being created.\r
- * @return A new <code>Document</code> object.\r
- * @exception DOMException\r
- * INVALID_CHARACTER_ERR: Raised if the specified qualified name \r
- * contains an illegal character.\r
- * <br>NAMESPACE_ERR: Raised if the <code>qualifiedName</code> is \r
- * malformed, if the <code>qualifiedName</code> has a prefix and the \r
- * <code>namespaceURI</code> is <code>null</code>, or if the \r
- * <code>qualifiedName</code> has a prefix that is "xml" and the \r
- * <code>namespaceURI</code> is different from "\r
- * http://www.w3.org/XML/1998/namespace" .\r
- * <br>WRONG_DOCUMENT_ERR: Raised if <code>doctype</code> has already \r
- * been used with a different document or was created from a different \r
- * implementation.\r
- * @since DOM Level 2\r
- */\r
- public Document createDocument(String namespaceURI, \r
- String qualifiedName, \r
- DocumentType doctype)\r
- throws DOMException;\r
-\r
-}\r