所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |