JavaTM 2 Platform
Standard Ed. 5.0

org.w3c.dom
接口 DOMImplementation


public interface DOMImplementation

DOMImplementation 接口为执行独立于文档对象模型的任何特定实例的操作提供了许多方法。

另请参见 Document Object Model (DOM) Level 3 Core Specification


方法摘要
 Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype)
          创建具有文档元素的指定类型的 DOM Document 对象。
 DocumentType createDocumentType(String qualifiedName, String publicId, String systemId)
          创建空 DocumentType 节点。
 Object getFeature(String feature, String version)
          此方法返回一个特定的对象,该对象实现了所指定的特定特性或版本的特殊 API。
 boolean hasFeature(String feature, String version)
          测试 DOM 实现是否实现在其中指定的特定特性和版本。
 

方法详细信息

hasFeature

boolean hasFeature(String feature,
                   String version)
测试 DOM 实现是否实现在其中指定的特定特性和版本。

参数:
feature - 要测试的特性的名称。
version - 这是要测试的特性的版本号。
返回:
如果在指定的版本中实现该特性,则返回 true;否则返回 false

createDocumentType

DocumentType createDocumentType(String qualifiedName,
                                String publicId,
                                String systemId)
                                throws DOMException
创建空 DocumentType 节点。无法使实体声明和表示法可用。不发生实体引用扩展和默认属性添加。

参数:
qualifiedName - 要创建的文档类型的限定名称。
publicId - 外部子集的公共标识符。
systemId - 外部子集的系统标识符。
返回:
具有设置为 nullNode.ownerDocument 的新 DocumentType 节点。
抛出:
DOMException - INVALID_CHARACTER_ERR:如果指定的限定名称不是遵循 [XML 1.0] 的 XML 名称,则引发此异常。
NAMESPACE_ERR: 如果 qualifiedName 是错误格式的,则引发此异常。
NOT_SUPPORTED_ERR: 如果实现不支持功能 "XML" 且文档公开的语言不支持 XML 名称空间(如 [HTML 4.01]),则可能引发此异常。
从以下版本开始:
DOM Level 2

createDocument

Document createDocument(String namespaceURI,
                        String qualifiedName,
                        DocumentType doctype)
                        throws DOMException
创建具有文档元素的指定类型的 DOM Document 对象。
注意,基于给定的 DocumentType 创建文档,该实现可以实例化特定的 Document 对象,这些对象可支持 "Core" 之外的其他特性,如 "HTML" [DOM Level 2 HTML]。而在创建文档之后再设置 DocumentType,可能使得此操作很难实现。此外,特定的 Document 创建方法(例如 createHTMLDocument [DOM Level 2 HTML])可用于获取特定类型的 Document 对象。

参数:
namespaceURI - 要创建的文档元素的名称空间 URI 或 null
qualifiedName - 要创建的文档元素的限定名称或 null
doctype - 要创建的文档的类型或 null。当 doctype 不是 null 时,其 Node.ownerDocument 属性将被设置为正在创建的文档。
返回:
具有文档元素的新 Document 对象。如果 NamespaceURIqualifiedNamedoctypenull,则返回的 Document 为空的,不带有文档元素。
抛出:
DOMException - INVALID_CHARACTER_ERR:如果指定的限定名称不是遵循 [XML 1.0] 的 XML 名称,则引发此异常。
NAMESPACE_ERR: 在以下情况下引发此异常:如果 qualifiedName 是错误格式的;如果 qualifiedName 有前缀且 namespaceURInull;或者如果 qualifiedNamenullnamespaceURI 不同于 null;或者如果 qualifiedName 有名为 "xml" 的前缀且 namespaceURI 不同于 "http://www.w3.org/XML/1998/namespace" [XML Namespaces];或者如果 DOM 实现不支持 "XML" 功能但提供非 null 名称空间 URI,因为名称空间由 XML 定义。
WRONG_DOCUMENT_ERR: 如果 doctype 已经用于不同文档或者从不同的实现创建,则引发此异常。
NOT_SUPPORTED_ERR: 如果实现不支持功能 "XML" 且文档公开的语言不支持 XML 名称空间(如 [HTML 4.01]),则可能引发此异常。
从以下版本开始:
DOM Level 2

getFeature

Object getFeature(String feature,
                  String version)
此方法返回一个特定的对象,该对象实现了所指定的特定特性或版本的特殊 API。该特殊对象也可以通过使用特定于绑定的强制转换方法获得,但不是必须期望这样做,正如文中讨论的那样。此方法还允许实现提供不支持 DOMImplementation 接口的特殊对象。

参数:
feature - 所请求的功能的名称。注意,追加到功能的名称的任何加号 "+" 将被忽略,因为它在此方法的上下文中无关紧要。
version - 这是要测试的功能的版本号。
返回:
返回实现指定的特性和版本的特殊 API 的对象(如果有);如果不存在实现与此特性相关的接口的对象,则返回 null。如果此方法返回的 DOMObject 实现 DOMImplementation 接口,则它必须委托给主要核心实现 DOMImplementation 且不返回与该主要核心 DOMImplementation 不一致的结果,如 hasFeaturegetFeature、等等。
从以下版本开始:
DOM Level 3

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策