-
- All Known Subinterfaces:
-
DOMImplementationCSS
,HTMLDOMImplementation
public interface DOMImplementation
DOMImplementation
接口提供了许多方法,用于执行独立于文档对象模型的任何特定实例的操作。
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 Document
createDocument(String namespaceURI, String qualifiedName, DocumentType doctype)
使用其document元素创建指定类型的DOM Document对象。DocumentType
createDocumentType(String qualifiedName, String publicId, String systemId)
创建一个空的DocumentType
节点。Object
getFeature(String feature, String version)
此方法返回一个专用对象,该对象实现指定功能和版本的专用API,如 DOM Features中所述 。boolean
hasFeature(String feature, String version)
测试DOM实现是否实现特定功能和版本,如 DOM Features中所述 。
-
-
-
方法详细信息
-
hasFeature
boolean hasFeature(String feature, String version)
测试DOM实现是否实现特定功能和版本,如 DOM Features中所述 。- 参数
-
feature
- 要测试的功能的名称。 -
version
- 这是要测试的功能的版本号。 - 结果
-
true
如果在指定版本中实现该功能,false
。
-
createDocumentType
DocumentType createDocumentType(String qualifiedName, String publicId, String systemId) throws DOMException
创建一个空的DocumentType
节点。 实体声明和符号不可用。 实体引用扩展和默认属性添加不会发生..- 参数
-
qualifiedName
- 要创建的文档类型的限定名称。 -
publicId
- 外部子集公共标识符。 -
systemId
- 外部子集系统标识符。 - 结果
-
新的
DocumentType
节点,其中Node.ownerDocument
设置为null
。 - 异常
-
DOMException
- INVALID_CHARACTER_ERR:根据[ XML 1.0 ],如果指定的限定名称不是XML名称,则引发此异常 。
NAMESPACE_ERR:如果qualifiedName
格式qualifiedName
则会提高。
NOT_SUPPORTED_ERR:如果实现不支持“XML”功能,并且通过Document公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能引发此问题 。 - 从以下版本开始:
- 1.4,DOM Level 2
-
createDocument
Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) throws DOMException
使用其document元素创建指定类型的DOM Document对象。
请注意,基于创建文档的DocumentType
,实现可以实例化支持除“Core”之外的其他功能的专用Document
对象,例如“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"
功能但提供了非空名称空间URI,因为名称空间是由XML定义的。
WRONG_DOCUMENT_ERR:如果doctype
已用于其他文档或从其他实现创建,则doctype
。
NOT_SUPPORTED_ERR:如果实现不支持“XML”功能,并且通过Document公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能引发此问题 。 - 从以下版本开始:
- 1.4,DOM Level 2
-
getFeature
Object getFeature(String feature, String version)
此方法返回一个专用对象,该对象实现指定功能和版本的专用API,如DOM Features中所述 。 专用对象也可以通过使用特定于绑定的铸造方法来获得,但不一定是预期的,如在中所讨论的。 此方法还允许实现提供不支持DOMImplementation
接口的专用对象。- 参数
-
feature
- 请求的功能的名称。 请注意,将忽略该特征名称前面的任何加号“+”,因为它在此方法的上下文中不重要。 -
version
- 这是要测试的功能的版本号。 - 结果
-
返回实现指定功能和版本(如果有)的专用API的对象,如果没有实现与该功能关联的接口的对象,则
null
。 如果DOMObject
此方法返回实现DOMImplementation
接口,它必须委托给主芯DOMImplementation
和不返回结果不一致与主芯DOMImplementation
如hasFeature
,getFeature
等 - 从以下版本开始:
- 1.5,DOM Level 3
-
-