当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
org.w3c.dom
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
DOMImplementation (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
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- 外部子集的系统标识符。- 返回：
- 具有设置为
null的Node.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对象。如果NamespaceURI、qualifiedName和doctype为null，则返回的Document为空的，不带有文档元素。 - 抛出：
DOMException- INVALID_CHARACTER_ERR:如果指定的限定名称不是遵循 [XML 1.0] 的 XML 名称，则引发此异常。
NAMESPACE_ERR: 在以下情况下引发此异常：如果qualifiedName是错误格式的；如果qualifiedName有前缀且namespaceURI为null；或者如果qualifiedName为null且namespaceURI不同于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不一致的结果，如hasFeature、getFeature、等等。 - 从以下版本开始：
- DOM Level 3
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。