java中Document类
public interface Document
extends
Document 接⼝表⽰整个 HTML 或 XML ⽂档。从概念上讲,它是⽂档树的根,并提供对⽂档数据的基本访问。namespace是干嘛的
因为元素、⽂本节点、注释、处理指令等不能存在于 Document 的上下⽂之外,所以 Document 接⼝还包含所需的创建这些对象的⼯⼚⽅法。所创建的 Node 对象具有 ownerDocument 属性,该属性将 Node 对象与创建这些对象时的上下⽂所属的Document 关联起来。
另请参见 。
字段摘要
从接⼝ org.w3c.dom. 继承的字段
, , , , , , , , , , , , , , , , ,
⽅法摘要
( source) 试图把另⼀⽂档中的节点采⽤到此⽂档。
( name) 创建给定名称的 Attr。
( namespaceURI, qualifiedName) 创建给定的限定名称和名称空间 URI 的属性。
( data) 创建其值为指定字符串的 CDATASection 节点。
( data) 创建给定指定字符串的 Comment 节点。
() 创建空 DocumentFragment 对象。
( tagName) 创建指定类型的元素。
( namespaceURI, qualifiedName) 创建给定的限定名称和名称空间 URI 的元素。
( name) 创建 EntityReference 对象。
( target, data) 创建给定指定名称和数据字符串的 ProcessingInstruction 节点。
( data) 创建给定指定字符串的 Text 节点。
() 与此⽂档相关的⽂档类型声明(参见 DocumentType)。
() 这是⼀种便捷属性,该属性允许直接访问⽂档的⽂档元素的⼦节点。
() ⽂档的位置,如果未定义或 Document 是使⽤ ateDocument 创建的,则为 null。
() 调⽤ alizeDocument() 时使⽤的配置。
( elementId) 返回具有带给定值的 ID 属性的 Element。
( tagname) 按⽂档顺序返回包含在⽂档中且具有给定标记名称的所有 Element 的 NodeList。
( namespaceURI, localName) 以⽂档顺序返回具有给定本地名称和名称空间 URI 的所有 Elements 的
NodeList。
() 处理此⽂档的 DOMImplementation 对象。
() 指定解析时此⽂档使⽤的编码的属性。
b
o
o
l
e
a
n
() 指定是否强制执⾏错误检查的属性。
() 作为 的⼀部分,指定此⽂档编码的属性。
b
o
o
l
e
a
n
() 作为 的⼀部分,指定此⽂档是否为独⽴⽂档的属性。
() 作为 的⼀部分指定此⽂档版本号的属性。
( importedNode, boolean deep) 从另⼀⽂档向此⽂档导⼊节点,⽽不改变或移除原始⽂档中的源节点;此⽅法创建源节点的⼀个新副本。
v
o
i
d
() 此⽅法的⾏为如同使⽂档通过⼀个保存和加载的过程,⽽将其置为 "normal(标准)" 形式。
( n, namespaceURI, qualifiedName) 重命名 ELEMENT_NODE 或 ATTRIBUTE_NODE 类型的现有节点。
v o i d ( documentURI) ⽂档的位置,如果未定义或 Document 是使⽤ ateDocument 创建的,则为 null。
v
o
i
d
(boolean strictErrorChecking) 指定是否强制执⾏错误检查的属性。
v
o
i
d
(boolean xmlStandalone) 作为 的⼀部分指定此⽂档是否是单独的的属性。
v
o
i
d
( xmlVersion) 作为 的⼀部分指定此⽂档版本号的属性。
⽅法详细信息
getDoctype
getDoctype()
与此⽂档相关的⽂档类型声明(参见 DocumentType)。对于没有⽂档类型声明的 XML ⽂档,此⽅法返回
null。对于 HTML ⽂档,可以返回 DocumentType 对象,与 HTML ⽂档中是否有⽂档类型声明⽆关。
这提供对 Document 的⼦节点 DocumentType 节点的直接访问。此节点可以在⽂档创建时设置,以后可以通过使⽤⼦节点操作⽅法(如 Node.insertBefore 或 placeChild)进⾏更改。不过要注意的是,根据创建时指定的 DocumentType,在有些实现可以实例化不同类型的 Document 对象(⽀持 "Core" 之外的其他功能,如"HTML" [])时,以后对它的更改很可能会导致所⽀持功能的不可更改。
从以下版本开始:
DOM Level 3
getImplementation
getImplementation()
处理此⽂档的 DOMImplementation 对象。DOM 应⽤程序可以使⽤多个实现中的对象。
getDocumentElement
getDocumentElement()
这是⼀种便捷属性,该属性允许直接访问⽂档的⽂档元素的⼦节点。
createElement
createElement( tagName)
throws
创建指定类型的元素。注意,返回的实例实现 Element 接⼝,所以可以直接在返回的对象上指定属性。
此外,如果存在具有默认值的已知属性,则⾃动创建表⽰它们的 Attr 节点,并将其连接到该元素。
要创建具有限定名称和名称空间 URI 的元素,使⽤ createElementNS ⽅法。
参数:
tagName - 要实例化的元素类型名称。对于 XML,tagName 参数是区分⼤⼩写的;⽽对于其他⽂
档,则取决于所使⽤标记语⾔的⼤⼩写敏感性。在该情况下,可通过 DOM 实现将该名称映射到该标
记的规范形式。
返回:
新的 Element 对象,该对象具有设置为 tagName 的 nodeName 属性以及设置为 null 的
localName、prefix 和 namespaceURI。
抛出:
- INVALID_CHARACTER_ERR:如果指定的名称是不遵循所使⽤的 XML 版本(在
createDocumentFragment()
创建空 DocumentFragment 对象。
返回:
新的 DocumentFragment。
createTextNode
createTextNode( data)
创建给定指定字符串的 Text 节点。
参数:
data - 该节点的数据。
返回:
新 Text 对象。
createComment
createComment( data)
创建给定指定字符串的 Comment 节点。
参数:
data - 该节点的数据。
返回:
新 Comment 对象。
createCDATASection
createCDATASection( data)
throws
创建其值为指定字符串的 CDATASection 节点。
参数:
data - CDATASection 内容的数据。
返回:
新 CDATASection 对象。
抛出:
- NOT_SUPPORTED_ERR:如果此⽂档为 HTML ⽂档,则引发该异常。createProcessingInstruction
createProcessingInstruction( target,
data)
throws
创建给定指定名称和数据字符串的 ProcessingInstruction 节点。
参数:
target - 处理指令的⽬标部分。与 ateElementNS 或 ateAttributeNS 不
同,此⽅法不检查⽬标名称是否为格式良好的名称空间。为了确保⽬标名称是格式良好的名称空间,
应⽤程序应该使⽤设置为 true 的参数 "namespaces" 调⽤ alizeDocument()。
data - 该节点的数据。
返回:
新 ProcessingInstruction 对象。
抛出:
- INVALID_CHARACTER_ERR:如果指定的⽬标是不遵循在 lVersion 属性中指定的使
⽤中的 XML 版本的 XML 名称,则引发此异常。
NOT_SUPPORTED_ERR:如果此⽂档为 HTML ⽂档,则引发此异常。
createAttribute
createAttribute( name)
throws
创建给定名称的 Attr。注意,然后可以使⽤ setAttributeNode ⽅法在 Element 上设置 Attr。
要创建具有限定名称和名称空间 URI 的属性,使⽤ createAttributeNS ⽅法。
参数:
name - 属性名称。
返回:
新的 Attr 对象,该对象具有设置为 name 的 nodeName 属性以及设置为 null 的 localName、prefix
和 namespaceURI。该属性的值为空字符串。
抛出:
- INVALID_CHARACTER_ERR:如果指定的名称是不遵循在 lVersion 属性中指定的使
⽤中的 XML 版本的 XML 名称,则引发此异常。
createEntityReference
createEntityReference( name)
throws
创建 EntityReference 对象。此外,如果引⽤的实体是已知的,则使 EntityReference 节点的⼦列表与相应 Entity 节点的⼦列表相同。
注: 如果任何 Entity 节点的后代具有未绑定的名称空间前缀,则相应的所创建的 EntityReference 节点的后代也未绑定;(其 namespaceURI 为 null)。DOM Level 2 和 3 不⽀持在此情况下解析名称空间前缀的任何机制。
参数:
name - 要引⽤的实体的名称。与 ateElementNS 或 ateAttributeNS 不
同,不在实体名称上检查名称空间是否为格式良好的。为了确保实体名称是格式良好的名称空间,应
⽤程序应该使⽤设置为 true 的参数 "namespaces" 调⽤ alizeDocument()。
返回:
新的 EntityReference 对象。
抛出:
- INVALID_CHARACTER_ERR:如果指定的名称是不遵循在 lVersion 属性中指定的使
⽤中的 XML 版本的 XML 名称,则引发此异常。
NOT_SUPPORTED_ERR:如果此⽂档为 HTML ⽂档,则引发该异常。getElementsByTagName
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论