1. 首页
  2. JavaAPI

Java org.w3c.dom 接口 Document（JDK5）

172 阅读 0 评论

所有类

概述  软件包   类  使用  树  已过时  索引  帮助 
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

org.w3c.dom
接口 Document

所有超级接口：
Node 
public interface Document
   
   
   
   
     
     
extends Node

Document 接口表示整个 HTML 或 XML 文档。从概念上讲，它是文档树的根，并提供对文档数据的基本访问。

因为元素、文本节点、注释、处理指令等不能存在于 Document 的上下文之外，所以 Document 接口还包含所需的创建这些对象的工厂方法。所创建的 Node 对象具有 ownerDocument 属性，该属性将 Node 对象与创建这些对象时的上下文所属的 Document 关联起来。

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

字段摘要
 
从接口 org.w3c.dom.Node 继承的字段
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
方法摘要
 Node adoptNode(Node source)
          试图把另一文档中的节点采用到此文档。
 Attr createAttribute(String name)
          创建给定名称的 Attr。
 Attr createAttributeNS(String namespaceURI, String qualifiedName)
          创建给定的限定名称和名称空间 URI 的属性。
 CDATASection createCDATASection(String data)
          创建其值为指定字符串的 CDATASection 节点。
 Comment createComment(String data)
          创建给定指定字符串的 Comment 节点。
 DocumentFragment createDocumentFragment()
          创建空 DocumentFragment 对象。
 Element createElement(String tagName)
          创建指定类型的元素。
 Element createElementNS(String namespaceURI, String qualifiedName)
          创建给定的限定名称和名称空间 URI 的元素。
 EntityReference createEntityReference(String name)
          创建 EntityReference 对象。
 ProcessingInstruction createProcessingInstruction(String target, String data)
          创建给定指定名称和数据字符串的 ProcessingInstruction 节点。
 Text createTextNode(String data)
          创建给定指定字符串的 Text 节点。
 DocumentType getDoctype()
          与此文档相关的文档类型声明（参见 DocumentType）。
 Element getDocumentElement()
          这是一种便捷属性，该属性允许直接访问文档的文档元素的子节点。
 String getDocumentURI()
          文档的位置，如果未定义或 Document 是使用 DOMImplementation.createDocument 创建的，则为 null。
 DOMConfiguration getDomConfig()
          调用 Document.normalizeDocument() 时使用的配置。
 Element getElementById(String elementId)
          返回具有带给定值的 ID 属性的 Element。
 NodeList getElementsByTagName(String tagname)
          按文档顺序返回包含在文档中且具有给定标记名称的所有 Element 的 NodeList。
 NodeList getElementsByTagNameNS(String namespaceURI, String localName)
          以文档顺序返回具有给定本地名称和名称空间 URI 的所有 Elements 的 NodeList。
 DOMImplementation getImplementation()
          处理此文档的 DOMImplementation 对象。
 String getInputEncoding()
          指定解析时此文档使用的编码的属性。
 boolean getStrictErrorChecking()
          指定是否强制执行错误检查的属性。
 String getXmlEncoding()
          作为 XML 声明的一部分，指定此文档编码的属性。
 boolean getXmlStandalone()
          作为 XML 声明的一部分，指定此文档是否为独立文档的属性。
 String getXmlVersion()
          作为 XML 声明 的一部分指定此文档版本号的属性。
 Node importNode(Node importedNode, boolean deep)
          从另一文档向此文档导入节点，而不改变或移除原始文档中的源节点；此方法创建源节点的一个新副本。
 void normalizeDocument()
          此方法的行为如同使文档通过一个保存和加载的过程，而将其置为 "normal（标准）" 形式。
 Node renameNode(Node n, String namespaceURI, String qualifiedName)
          重命名 ELEMENT_NODE 或 ATTRIBUTE_NODE 类型的现有节点。
 void setDocumentURI(String documentURI)
          文档的位置，如果未定义或 Document 是使用 DOMImplementation.createDocument 创建的，则为 null。
 void setStrictErrorChecking(boolean strictErrorChecking)
          指定是否强制执行错误检查的属性。
 void setXmlStandalone(boolean xmlStandalone)
          作为 XML 声明 的一部分指定此文档是否是单独的的属性。
 void setXmlVersion(String xmlVersion)
          作为 XML 声明 的一部分指定此文档版本号的属性。
 
从接口 org.w3c.dom.Node 继承的方法
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 

方法详细信息

getDoctype

DocumentType getDoctype()
与此文档相关的文档类型声明（参见 DocumentType）。对于没有文档类型声明的 XML 文档，此方法返回 null。对于 HTML 文档，可以返回 DocumentType 对象，与 HTML 文档中是否有文档类型声明无关。
这提供对 Document 的子节点 DocumentType 节点的直接访问。此节点可以在文档创建时设置，以后可以通过使用子节点操作方法（如 Node.insertBefore 或 Node.replaceChild）进行更改。不过要注意的是，根据创建时指定的 DocumentType，在有些实现可以实例化不同类型的 Document 对象（支持 "Core" 之外的其他功能，如 "HTML" [DOM Level 2 HTML]）时，以后对它的更改很可能会导致所支持功能的不可更改。

getImplementation

DOMImplementation getImplementation()
处理此文档的 DOMImplementation 对象。DOM 应用程序可以使用多个实现中的对象。

getDocumentElement

Element getDocumentElement()
这是一种便捷属性，该属性允许直接访问文档的文档元素的子节点。

createElement

Element createElement(String tagName)
                      throws DOMException
创建指定类型的元素。注意，返回的实例实现 Element 接口，所以可以直接在返回的对象上指定属性。
此外，如果存在具有默认值的已知属性，则自动创建表示它们的 Attr 节点，并将其连接到该元素。
要创建具有限定名称和名称空间 URI 的元素，使用 createElementNS 方法。

参数：
tagName - 要实例化的元素类型名称。对于 XML，tagName 参数是区分大小写的；而对于其他文档，则取决于所使用标记语言的大小写敏感性。在该情况下，可通过 DOM 实现将该名称映射到该标记的规范形式。
返回：
新的 Element 对象，该对象具有设置为 tagName 的 nodeName 属性以及设置为 null 的 localName、prefix 和 namespaceURI。
抛出：
DOMException - INVALID_CHARACTER_ERR：如果指定的名称是不遵循所使用的 XML 版本（在 Document.xmlVersion 属性中指定）的 XML 名称，则引发此异常。

createDocumentFragment

DocumentFragment createDocumentFragment()
创建空 DocumentFragment 对象。

返回：
新的 DocumentFragment。

createTextNode

Text createTextNode(String data)
创建给定指定字符串的 Text 节点。

参数：
data - 该节点的数据。
返回：
新 Text 对象。

createComment

Comment createComment(String data)
创建给定指定字符串的 Comment 节点。

参数：
data - 该节点的数据。
返回：
新 Comment 对象。

微信小程序

微信扫一扫体验

微信公众账号

微信扫一扫加关注

 发表
评论 返回
顶部