Document (Java Platform SE 8 )

All Superinterfaces:

Node

所有已知实现类：

SOAPPart
```
public interface Document
extends Node
```
Document接口代表整个HTML或XML文档。在概念上，它是文档树的根，并提供对文档数据的主访问。
由于元素，文本节点，注释，处理指令等不能存在于Document的上下文Document ， Document接口还包含创建这些对象所需的工厂方法。创建的Node对象具有ownerDocument属性，它们与创建的上下文中的Document 。

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

Field Summary
- Fields inherited from interface 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

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`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()` 文件的位置或 `null`如果未定义，或 `Document`是否使用 `DOMImplementation.createDocument`创建。
`DOMConfiguration`	`getDomConfig()` 调用Document.normalizeDocument()时使用的 `Document.normalizeDocument()` 。
`Element`	`getElementById(String elementId)` 返回 `Element`具有与给定值的ID属性。
`NodeList`	`getElementsByTagName(String tagname)` 以文件顺序返回 `NodeList`所有 `Elements`的给定标签名称，并包含在文档中。
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)` 返回 `NodeList`的所有 `Elements`具有给定本地名称和命名空间URI在文档顺序。
`DOMImplementation`	`getImplementation()` 处理此文档的 `DOMImplementation`对象。
`String`	`getInputEncoding()` 指定在解析时用于此文档的编码的属性。
`boolean`	`getStrictErrorChecking()` 指定是否强制执行错误检查的属性。
`String`	`getXmlEncoding()` 一个属性指定，作为一部分 XML declaration ，本文件的编码。
`boolean`	`getXmlStandalone()` 一个属性指定，作为一部分 XML declaration ，本文件是否是单独的。
`String`	`getXmlVersion()` 作为XML declaration的一部分的属性，指定此文档的版本号。
`Node`	`importNode(Node importedNode, boolean deep)` 将节点从另一个文档导入到本文档中，而不从原始文档更改或删除源节点; 此方法创建源节点的新副本。
`void`	`normalizeDocument()` 该方法的作用就好像文档正在进行保存和加载循环，将文档置于“正常”形式。
`Node`	`renameNode(Node n, String namespaceURI, String qualifiedName)` 重命名类型为 `ELEMENT_NODE`或 `ATTRIBUTE_NODE`的现有节点。
`void`	`setDocumentURI(String documentURI)` 文件的位置或 `null`如果未定义）或 `Document`是否使用 `DOMImplementation.createDocument`创建。
`void`	`setStrictErrorChecking(boolean strictErrorChecking)` 指定是否强制执行错误检查的属性。
`void`	`setXmlStandalone(boolean xmlStandalone)` 一个属性指定，作为一部分 XML declaration ，本文件是否是单独的。
`void`	`setXmlVersion(String xmlVersion)` 作为XML declaration的一部分的属性，指定此文档的版本号。

Methods inherited from interface 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文档中是否存在文档类型声明。
    这提供了直接访问DocumentType节点，这个Document子节点。该节点可以在文档创建时设置，稍后通过使用子节点操作方法（例如Node.insertBefore或Node.replaceChild 。然而，请注意，虽然一些实现可以实例化支持除“核心”之外的其他功能的不同类型的Document对象，例如“HTML”[ DOM Level 2 HTML ]，基于在创建时DocumentType DocumentType，之后更改它不太可能导致在更改支持的功能。
    
    从以下版本开始：
    
    DOM 3级
  - getImplementation
```
DOMImplementation getImplementation()
```
    处理此文档的DOMImplementation对象。 DOM应用程序可以使用来自多个实现的对象。
  - getDocumentElement
```
Element getDocumentElement()
```
    这是一个方便属性，允许直接访问作为文档的文档元素的子节点。
  - createElement
```
Element createElement(String tagName)
               throws DOMException
```
    创建指定类型的元素。请注意，返回的实例实现了Element接口，因此可以直接在返回的对象上指定属性。
    另外，如果存在具有默认值的已知属性， Attr自动创建表示它们的Attr个节点并附加到该元素。
    要创建具有限定名称和命名空间URI的元素，请使用createElementNS方法。
    
    参数
    
    tagName - 要实例化的元素类型的名称。对于XML，这是区分大小写的，否则取决于使用的标记语言的区分大小写。在这种情况下，该名称将通过DOM实现映射到该标记的规范形式。
    
    结果
    
    一种新的 Element与对象 nodeName属性设置为 tagName ，和 localName ， prefix和 namespaceURI设置为 null 。
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集 Document.xmlVersion属性。
  - createDocumentFragment
```
DocumentFragment createDocumentFragment()
```
    创建一个空的 DocumentFragment对象。
    
    结果
    
    一个新的 DocumentFragment 。
  - createTextNode
```
Text createTextNode(String data)
```
    创建给定指定字符串的 Text节点。
    
    参数
    
    data - 节点的数据。
    
    结果
    
    新的 Text对象。
  - createComment
```
Comment createComment(String data)
```
    创建给定指定字符串的 Comment节点。
    
    参数
    
    data - 节点的数据。
    
    结果
    
    新的 Comment对象。
  - createCDATASection
```
CDATASection createCDATASection(String data)
                         throws DOMException
```
    创建值为指定字符串的 CDATASection节点。
    
    参数
    
    data - CDATASection内容的数据。
    
    结果
    
    新的 CDATASection对象。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。
  - createProcessingInstruction
```
ProcessingInstruction createProcessingInstruction(String target,
                                                  String data)
                                           throws DOMException
```
    创建一个给定指定名称和数据字符串的 ProcessingInstruction节点。
    
    参数
    
    target - 处理target的目标部分。不像Document.createElementNS或Document.createAttributeNS ，目标名称上没有对命名空间进行完整的检查。应用程序应调用Document.normalizeDocument() ，其参数“namespaces”设置为true ，以确保目标名称的命名空间格式正确。
    
    data - 节点的数据。
    
    结果
    
    新的 ProcessingInstruction对象。
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：如果指定的目标是不按照规定使用的XML版本的XML名称募集Document.xmlVersion属性。
    NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。
  - createAttribute
```
Attr createAttribute(String name)
              throws DOMException
```
    创建给定名称的Attr 。请注意， Attr实例可以使用setAttributeNode方法设置在Element上。
    要创建具有限定名称和命名空间URI的createAttributeNS ，请使用createAttributeNS方法。
    
    参数
    
    name - 属性的名称。
    
    结果
    
    一种新的Attr与对象nodeName属性设置为name ，和localName ， prefix和namespaceURI设置为null 。属性的值为空字符串。
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集 Document.xmlVersion属性。
  - createEntityReference
```
EntityReference createEntityReference(String name)
                               throws DOMException
```
    创建一个EntityReference对象。此外，如果引用的实体是已知的，的子列表EntityReference节点由相同相应的Entity节点。
    注意：如果Entity节点的任何后代具有未绑定的命名空间前缀，则创建的EntityReference节点的相应后代也将不绑定; （其namespaceURI是null ）。在这种情况下，DOM Level 2和3不支持任何解决名称空间前缀的机制。
    
    参数
    
    name - 要引用的实体的名称。不像Document.createElementNS或Document.createAttributeNS ，实体名称上没有对命名空间进行完整的检查。应用程序应调用Document.normalizeDocument() ，参数“namespaces”设置为true ，以确保实体名称具有良好的命名空间。
    
    结果
    
    新的 EntityReference对象。
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集Document.xmlVersion属性。
    NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。
  - getElementsByTagName
```
NodeList getElementsByTagName(String tagname)
```
    返回 NodeList所有的 Elements文档顺序与给定的标签名称，包含在文档中。
    
    参数
    
    tagname - 要匹配的标签的名称。特殊值“*”匹配所有标签。对于XML， tagname参数区分大小写，否则取决于使用的标记语言的大小写敏感度。
    
    结果
    
    一个新的 NodeList对象包含所有匹配的 Elements 。
  - importNode
```
Node importNode(Node importedNode,
                boolean deep)
         throws DOMException
```
    将节点从另一个文档导入到本文档中，而不从原始文档更改或删除源节点; 此方法创建源节点的新副本。返回的节点没有父节点; （ parentNode是null ）。
    所有节点，导入节点创建由进口文档拥有的节点对象，具有属性值相同的源节点的nodeName和nodeType ，加上与命名空间属性（ prefix ， localName和namespaceURI ）。与cloneNode一样，源节点也没有改变。与导入的节点关联的用户数据不会被转移。但是，如果任何UserDataHandlers已经与相关数据指定沿着这些处理器将与该方法返回之前适当的参数调用。
    附加信息被复制为适合于nodeType ，试图镜像预期如果XML或HTML源的片段从一个文档复制到另一个，认识到这两个文件可以具有在XML的情况下不同的DTD的行为。以下列表描述了每种节点类型的细节。
    
    ATTRIBUTE_NODE
    
    所述ownerElement属性被设置为null和specified标志被设置为true所生成的Attr 。源Attr被递归导入，并且所生成的节点重新组合以形成相应的子树。请注意， deep参数对Attr节点没有影响; 进口时，他们总是带着孩子。
    
    DOCUMENT_FRAGMENT_NODE
    
    如果deep选项设置为true ，则源DocumentFragment被递归导入，并且所生成的节点在导入的DocumentFragment下重新DocumentFragment以形成相应的子树。否则，这只会产生一个空的DocumentFragment 。
    
    DOCUMENT_NODE
    
    Document节点无法导入。
    
    DOCUMENT_TYPE_NODE
    
    DocumentType无法导入节点。
    
    ELEMENT_NODE
    
    源元素的指定的属性节点被导入，并且将所生成Attr节点连接到所生成的Element 。默认属性不被复制，但是如果要导入的文档定义了该元素名称的默认属性，那么它们将被分配。如果importNode deep参数设置为true ，则源元素的后代将被递归导入，并将生成的节点重新组合以形成相应的子树。
    
    ENTITY_NODE
    
    Entity节点可以导入，但是在当前版本的DOM中， DocumentType是只读方式。能力将这些导入的节点添加到DocumentType将考虑除了未来DOM.On进口的发布， publicId ， systemId和notationName属性被复制。如果deep导入，源Entity将被递归导入，并将生成的节点重新组合以形成相应的子树。
    
    ENTITY_REFERENCE_NODE
    
    只有EntityReference本身被复制，即使要求deep导入，因为源和目的地文档可能不同地定义了实体。如果导入的文档为此实体名称提供了定义，则会分配其值。
    
    NOTATION_NODE
    
    Notation节点可以导入，但在当前版本的DOM中， DocumentType是只读方式。将这些导入的节点添加到DocumentType将被考虑添加到将来的DOM.On导入中， publicId和systemId属性被复制。请注意， deep参数对此类型的节点没有影响，因为它们不能有任何子节点。
    
    PROCESSING_INSTRUCTION_NODE
    
    导入的节点从源节点复制其target和data值。请注意， deep参数对此类型的节点没有影响，因为它们不能有任何子节点。
    
    TEXT_NODE，CDATA_SECTION_NODE，COMMENT_NODE
    
    这三种类型的继承节点CharacterData复制他们data个length从那些在源node.Note的属性deep参数对这些类型的节点无效，因为它们不能有任何孩子。
    
    参数
    
    importedNode - 要导入的节点。
    
    deep - 如果true ，递归地导入指定节点下的子树; 如果false ，只导入节点本身，如上所述。这对于不能有EntityReference节点的节点，并且在Attr和EntityReference节点上没有影响。
    
    结果
    
    导入的节点属于此 Document 。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果不支持正在导入的节点类型，则引发。
    INVALID_CHARACTER_ERR：若进口的名字之一是不按照规定使用的XML版本的XML名称Document.xmlVersion属性。例如，当将XML 1.1 [ XML 1.1 ]元素导入XML 1.0文档时，可能会发生这种情况。
    
    从以下版本开始：
    
    DOM级别2
  - createElementNS
```
Element createElementNS(String namespaceURI,
                        String qualifiedName)
                 throws DOMException
```
    创建给定限定名称和命名空间URI的元素。
    按照[ XML Namespaces ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。
    
    参数
    
    namespaceURI - 要创建的元素的命名空间URI。
    
    qualifiedName - 要实例化的元素类型的限定名称。
    
    结果
    
    一个新的Element对象具有以下属性： Attribute Value Node.nodeName qualifiedName Node.namespaceURI namespaceURI Node.prefix prefix, extracted from qualifiedName, or null if there is no prefix Node.localName local name, extracted from qualifiedName Element.tagName qualifiedName
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：若指定的qualifiedName不按照规定使用的XML版本的XML名称Document.xmlVersion属性。
    NAMESPACE_ERR：若所述qualifiedName是畸形限定名，如果qualifiedName具有前缀和namespaceURI是null ，或如果qualifiedName具有前缀为“xml”和namespaceURI距离“不同http://www.w3.org/XML/1998/namespace ” [ XML Namespaces ]，或如果qualifiedName或其前缀为“xmlns”和namespaceURI距离“不同http://www.w3.org/2000/xmlns/ ”，或者如果namespaceURI是“ http://www.w3.org/2000/xmlns/ ”，而本qualifiedName也不其前缀为“xmlns”。
    NOT_SUPPORTED_ERR：如果当前文档不支持"XML"功能，则始终抛出，因为命名空间是由XML定义的。
    
    从以下版本开始：
    
    DOM级别2
  - createAttributeNS
```
Attr createAttributeNS(String namespaceURI,
                       String qualifiedName)
                throws DOMException
```
    创建给定的限定名称和命名空间URI的属性。
    按照[ XML Namespaces ]，应用程序必须使用值null作为方法的namespaceURI参数，如果他们希望没有命名空间。
    
    参数
    
    namespaceURI - 要创建的属性的命名空间URI。
    
    qualifiedName - 要实例化的属性的限定名称。
    
    结果
    
    一个新的Attr对象具有以下属性： Attribute Value Node.nodeName qualifiedName Node.namespaceURI namespaceURI Node.prefix prefix, extracted from qualifiedName, or null if there is no prefix Node.localName local name, extracted from qualifiedName Attr.name qualifiedName Node.nodeValue the empty string
    
    异常
    
    DOMException - INVALID_CHARACTER_ERR：若指定的qualifiedName不按照规定使用的XML版本的XML名称Document.xmlVersion属性。
    NAMESPACE_ERR：若该qualifiedName是错误格式的限定名称，如果qualifiedName有一个前缀， namespaceURI是null ，如果qualifiedName有前缀为“xml”和namespaceURI是“不同http://www.w3.org/XML/1998/namespace ”，如果qualifiedName或其前缀为“xmlns”和namespaceURI距离“不同http://www.w3.org/2000/xmlns/ ”，或者如果namespaceURI是“ http://www.w3.org/2000/xmlns/ ”，而本qualifiedName也不其前缀为“xmlns”。
    NOT_SUPPORTED_ERR：如果当前文档不支持"XML"功能，则始终抛出，因为命名空间是由XML定义的。
    
    从以下版本开始：
    
    DOM级别2
  - getElementsByTagNameNS
```
NodeList getElementsByTagNameNS(String namespaceURI,
                                String localName)
```
    返回 NodeList的所有 Elements具有给定本地名称和命名空间URI在文档顺序。
    
    参数
    
    namespaceURI - 要匹配的元素的命名空间URI。特殊值"*"匹配所有命名空间。
    
    localName - 要匹配的元素的本地名称。特殊值“*”与所有本地名称相匹配。
    
    结果
    
    一个新的 NodeList对象包含所有匹配的 Elements 。
    
    从以下版本开始：
    
    DOM级别2
  - getElementById
```
Element getElementById(String elementId)
```
    返回Element具有与给定值的ID属性。如果不存在这样的元素，则返回null 。如果多个元素的ID属性为该值，那么返回的元素是未定义的。
    预期DOM实现将使用属性Attr.isId来确定属性是否为类型ID。
    注意：除非如此定义，否则名称为“ID”或“id”的属性不是类型ID。
    
    参数
    
    elementId - 元素的唯一 id值。
    
    结果
    
    匹配元素或 null如果没有。
    
    从以下版本开始：
    
    DOM级别2
  - getInputEncoding
```
String getInputEncoding()
```
    指定在解析时用于此文档的编码的属性。这是null当它是不知道的，如Document是在内存中创建的。
    
    从以下版本开始：
    
    DOM 3级
  - getXmlEncoding
```
String getXmlEncoding()
```
    一个属性指定，作为一部分XML declaration ，本文件的编码。这是null当未指定或不知道时，例如当内存中创建Document时。
    
    从以下版本开始：
    
    DOM 3级
  - getXmlStandalone
```
boolean getXmlStandalone()
```
    一个属性指定，作为一部分XML declaration ，本文件是否是单独的。这是false当未指定。
    注意：设置此属性时，不会对该值进行验证。应用程序应使用Document.normalizeDocument()与“验证”参数，以验证值相匹配的validity constraint for standalone document declaration如[定义XML 1.0 ]。
    
    从以下版本开始：
    
    DOM 3级
  - setXmlStandalone
```
void setXmlStandalone(boolean xmlStandalone)
               throws DOMException
```
    一个属性指定，作为一部分XML declaration ，本文件是否是单独的。这是false当未指定。
    注意：设置此属性时，不会对该值进行验证。应用程序应使用Document.normalizeDocument()与“验证”参数，以验证值相匹配的validity constraint for standalone document declaration如[定义XML 1.0 ]。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果此文档不支持“XML”功能，则引发。
    
    从以下版本开始：
    
    DOM 3级
  - getXmlVersion
```
String getXmlVersion()
```
    作为XML declaration的一部分的属性，指定此文档的版本号。如果没有声明，如果此文档支持“XML”功能，则值为"1.0" 。如果此文档不支持“XML”功能，则该值始终为null 。更改此属性将影响检查XML名称中无效字符的方法。应用程序应该调用Document.normalizeDocument() ，以检查在无效字符Node s表示已经是此的一部分Document 。
    DOM应用程序可以使用DOMImplementation.hasFeature(feature, version)方法与参数值为“XMLVersion”和“1.0”（分别地），以确定是否实现支持[ XML 1.0 ]。 DOM应用程序可能使用与参数值“XMLVersion”和“1.1”（分别）相同的方法来确定实现是否支持[ XML 1.1 ]。在这两种情况下，为了支持XML，实现还必须支持本规范中定义的“XML”功能。 Document对象支持的版本为“XMLVersion”功能不能养NOT_SUPPORTED_ERR使用时例外相同的版本号Document.xmlVersion 。
    
    从以下版本开始：
    
    DOM 3级
  - setXmlVersion
```
void setXmlVersion(String xmlVersion)
            throws DOMException
```
    作为XML declaration的一部分的属性，指定此文档的版本号。如果没有声明，如果此文档支持“XML”功能，则值为"1.0" 。如果此文档不支持“XML”功能，则该值始终为null 。更改此属性将影响检查XML名称中无效字符的方法。应用程序应该调用Document.normalizeDocument() ，以检查在无效字符Node s表示已经是此的一部分Document 。
    DOM应用程序可以使用参数值“XMLVersion”和“1.0”（分别）的DOMImplementation.hasFeature(feature, version)方法来确定实现是否支持[ XML 1.0 ]。 DOM应用程序可能使用与参数值“XMLVersion”和“1.1”（分别）相同的方法来确定实现是否支持[ XML 1.1 ]。在这两种情况下，为了支持XML，实现还必须支持本规范中定义的“XML”功能。 Document对象支持的版本为“XMLVersion”功能不能养NOT_SUPPORTED_ERR使用时例外相同的版本号Document.xmlVersion 。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果版本设置为此 Document不支持的值或者该文档不支持“XML”功能，则 Document 。
    
    从以下版本开始：
    
    DOM 3级
  - getStrictErrorChecking
```
boolean getStrictErrorChecking()
```
    指定是否强制执行错误检查的属性。当设置为false ，实行免费不测试通常在DOM操作上定义的每个可能的错误情况下，并没有提出任何DOMException在DOM操作或者报告错误，而使用Document.normalizeDocument() 。如果出现错误，行为是未定义的。此属性默认为true 。
    
    从以下版本开始：
    
    DOM 3级
  - setStrictErrorChecking
```
void setStrictErrorChecking(boolean strictErrorChecking)
```
    指定是否强制执行错误检查的属性。当设置为false ，实行免费不测试通常在DOM操作上定义的每个可能的错误情况下，并没有提出任何DOMException在DOM操作或者报告错误，而使用Document.normalizeDocument() 。如果出现错误，行为是未定义的。此属性默认为true 。
    
    从以下版本开始：
    
    DOM 3级
  - getDocumentURI
```
String getDocumentURI()
```
    文件的位置或null如果未定义）或Document是否使用DOMImplementation.createDocument创建。设置此属性时不执行词法检查; 这可能会导致使用null时返回的值为Node.baseURI 。
    当Document支持功能“HTML”[ DOM Level 2 HTML ]时， Document注意，当计算Document时，HTML BASE元素的href属性优先于此Node.baseURI 。
    
    从以下版本开始：
    
    DOM 3级
  - setDocumentURI
```
void setDocumentURI(String documentURI)
```
    文件的位置或null如果未定义）或Document是否使用DOMImplementation.createDocument创建。设置此属性时不执行词法检查; 这可能会导致一个null使用时返回的值Node.baseURI 。
    当Document支持功能“HTML”[ DOM Level 2 HTML ]时，当计算Node.baseURI时，HTML BASE元素的href属性优先于此Node.baseURI 。
    
    从以下版本开始：
    
    DOM 3级
  - adoptNode
```
Node adoptNode(Node source)
        throws DOMException
```
    尝试从另一个文档中采用节点到本文档。如果支持，它会改变源节点的ownerDocument ，其子节点，以及附加的属性节点（如果有的话）。如果源节点有父，则首先从其父列表的子列表中删除它。这有效地允许将子树从一个文档移动到另一个文档（不像importNode()创建源节点的副本而不是移动它）。当它失败时，应用程序应该使用Document.importNode() 。请注意，如果采用的节点已经是本文档的一部分（即源文档和目标文档是相同的），则该方法仍然具有从其父代的子列表中删除源节点的效果（如果有的话）。以下列表描述了每种节点类型的细节。
    
    ATTRIBUTE_NODE
    
    该ownerElement属性设置为null和specified标志设置为true所采用的Attr 。源Attr被递归地采用。
    
    DOCUMENT_FRAGMENT_NODE
    
    源节点的后代被递归地采用。
    
    DOCUMENT_NODE
    
    Document节点不能采用。
    
    DOCUMENT_TYPE_NODE
    
    DocumentType节点不能采用。
    
    ELEMENT_NODE
    
    采用源元素的指定属性节点。丢弃默认属性，但是如果要采用的文档定义了此元素名称的默认属性，则会分配这些属性。源元素的后代被递归地采用。
    
    ENTITY_NODE
    
    Entity节点不能采用。
    
    ENTITY_REFERENCE_NODE
    
    只有EntityReference节点本身被采用，后代被丢弃，因为源和目的地文档可能不同地定义了实体。如果导入的文档为此实体名称提供了定义，则会分配其值。
    
    NOTATION_NODE
    
    Notation节点不能采用。
    
    PROCESSING_INSTRUCTION_NODE，TEXT_NODE，CDATA_SECTION_NODE，COMMENT_NODE
    
    这些节点都可以被采用。没有细节。
    
    注意：由于它不像Document.importNode()方法那样创建新节点，因此此方法不会引发INVALID_CHARACTER_ERR异常，应用程序应使用Document.normalizeDocument()方法根据正在使用的XML版本检查导入的名称是否不是XML名称。
    
    参数
    
    source - 要移入此文档的节点。
    
    结果
    
    所采用的节点，或 null如果此操作失败，例如源节点来自不同的实现。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：如果源节点的类型为DOCUMENT ， DOCUMENT_TYPE 。
    NO_MODIFICATION_ALLOWED_ERR：源节点只读时引发。
    
    从以下版本开始：
    
    DOM 3级
  - getDomConfig
```
DOMConfiguration getDomConfig()
```
    当调用Document.normalizeDocument()时使用的 Document.normalizeDocument() 。
    
    从以下版本开始：
    
    DOM 3级
  - normalizeDocument
```
void normalizeDocument()
```
    该方法的作用就好像文档正在进行保存和加载循环，将文档置于“正常”形式。因此，这种方法更新的替代树EntityReference节点和标准化Text节点，如在方法中定义Node.normalize() 。
    否则，实际结果取决于在Document.domConfig对象上设置的功能，并管理实际执行的操作。值得注意的是，这种方法也可以使文档命名空间根据所描述的算法进行良好的组合，检查字符归一化，删除CDATASection节点等。详见DOMConfiguration 。
```
  // Keep in the document
 the information defined // in the XML Information Set (Java example)
 DOMConfiguration docConfig = myDocument.getDomConfig();
 docConfig.setParameter("infoset", Boolean.TRUE);
 myDocument.normalizeDocument(); 
```
    生成支持时的突变事件，以反映文档上发生的更改。
    如果该方法中，在调用期间发生诸如试图更新只读节点错误或Node.nodeName包含无效字符根据在使用中，错误或警告（XML版本DOMError.SEVERITY_ERROR或DOMError.SEVERITY_WARNING ）将使用报告DOMErrorHandler与“错误处理程序”参数关联的对象。注意，如果实现无法从错误中恢复，则此方法也可能会报告致命错误（ DOMError.SEVERITY_FATAL_ERROR ）。
    从以下版本开始：
    
    DOM 3级
  - renameNode
```
Node renameNode(Node n,
                String namespaceURI,
                String qualifiedName)
         throws DOMException
```
    重命名类型为ELEMENT_NODE或ATTRIBUTE_NODE的现有节点。
    在可能的情况下，只需更改给定节点的名称，否则将创建具有指定名称的新节点，并使用新节点替换现有节点，如下所述。
    如果简单地改变给定节点的名称是不可能的，则执行以下操作：创建新节点，在新节点上注册任何注册的事件侦听器，从该节点删除附加到旧节点的任何用户数据，如果旧节点有父节点，则将其从父节点移除，如果重新命名的节点为Element其属性移动到新节点，新节点将插入旧节点所在的位置要在其父节点的子节点列表中有一个，则附加到旧节点的用户数据被附加到新节点。
    当重新命名的节点是Element仅移动指定的属性，根据新的元素名称更新来自DTD的默认属性。此外，实现可以从其他模式更新默认属性。应用程序应使用Document.normalizeDocument()来保证这些属性是最新的。
    当要重命名的节点是Attr被附接到一个Element ，首先删除的节点从Element属性地图。然后，一旦重命名，通过修改现有节点或如上所述创建一个新节点，它将被放回。
    此外，
    - 用户数据事件NODE_RENAMED被触发，
    - 当实现支持特征“MutationNameEvents”，参与这一方法中，每个变异操作触发适当的事件，并且在最后的情况下{ http://www.w3.org/2001/xml-events ， DOMElementNameChanged }或{ http://www.w3.org/2001/xml-events ， DOMAttributeNameChanged }进行烧成。
    参数
    
    n - 要重命名的节点。
    
    namespaceURI - 新的命名空间URI。
    
    qualifiedName - 新的合格名称。
    
    结果
    
    重命名的节点。这是指定的节点或创建以替换指定节点的新节点。
    
    异常
    
    DOMException - NOT_SUPPORTED_ERR：当指定节点的类型既不是ELEMENT_NODE也不是ATTRIBUTE_NODE时，或者实现不支持重命名文档元素时引发。
    INVALID_CHARACTER_ERR：如果新的限定名称不是按照规定的使用中的XML版本的XML名称募集Document.xmlVersion属性。
    WRONG_DOCUMENT_ERR：从与此文档不同的文档创建指定节点时引发。
    NAMESPACE_ERR：如果qualifiedName是格式错误的限定名，如果qualifiedName有前缀， namespaceURI是null ，或者qualifiedName的前缀是“xml”，namespaceURI与“ http://www.w3.org/XML/1998/namespace ”[ XML Namespaces ] namespaceURI则引发。还提出，当被重命名的节点是一个属性，如果qualifiedName ，或它的前缀，为“xmlns”和namespaceURI距离“不同http://www.w3.org/2000/xmlns/ ”。
    
    从以下版本开始：
    
    DOM 3级

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Document

Field Summary

Fields inherited from interface org.w3c.dom.Node

方法摘要

Methods inherited from interface org.w3c.dom.Node

方法详细信息

getDoctype

getImplementation

getDocumentElement

createElement

createDocumentFragment

createTextNode

createComment

createCDATASection

createProcessingInstruction

createAttribute

createEntityReference

getElementsByTagName

importNode

createElementNS

createAttributeNS

getElementsByTagNameNS

getElementById

getInputEncoding

getXmlEncoding

getXmlStandalone

setXmlStandalone

getXmlVersion

setXmlVersion

getStrictErrorChecking

setStrictErrorChecking

getDocumentURI

setDocumentURI

adoptNode

getDomConfig

normalizeDocument

renameNode