Document (Java Platform SE 8 )

All Superinterfaces:

Node

所有已知实现类：

SOAPPart
```
public interface Document
extends Node
```
的 Document接口代表整个HTML或XML文档。从概念上讲，它是文档树的根，并提供了对文档数据的基本访问。
从元素、文本节点、注释、处理指令，不存在一个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()`调用时使用。
`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文档或文档类型声明下。
this提供了直接访问的 DocumentType节点，这 Document子节点。这个节点可以设置文件的创建时间和通过子节点的操作方法使用后的改变，如 Node.insertBefore，或 Node.replaceChild。注意，然而，当一些实现可能实例化不同类型 Document对象支持比“核心”的附加功能，如“HTML”[ DOM Level 2 HTML ]，基于在创建时指定的 DocumentType，改变之后是导致改变的功能支持，很可能。

从以下版本开始：

DOM级别3

getImplementation
```
DOMImplementation getImplementation()
```
的 DOMImplementation对象处理这个文件。DOM应用程序可能使用多个实现的对象。

getDocumentElement
```
Element getDocumentElement()
```
这是一个方便的属性，它允许直接访问是文档的文档元素的子节点。

createElement
```
Element createElement(String tagName)
               throws DOMException
```
创建指定的类型的元素。注意，实例恢复实施 Element接口，所以属性可以对返回的对象直接指定。
in之外，如果有已知的属性的默认值， Attr节点代表他们是自动创建并连接到元。
to创建一个合格的名称和命名空间URI的一个元素，使用 createElementNS方法。

参数

tagName -元素类型的实例的名称。对于XML，这是区分大小写的，否则它取决于使用中的标记语言的情况下的灵敏度。在这种情况下，这个名字是由DOM实现映射到标记的正则形式。

结果

一个新的 nodeName Element对象属性设置为 tagName，和 localName， prefix，和 namespaceURI设置 null。

异常

DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的名称不是一个XML的名字了。

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 -处理指令的目标的一部分。不像 Document.createElementNS或 Document.createAttributeNS，没有命名空间以及形成的检测是目标的名字了。应用程序应该调用 Document.normalizeDocument()用参数“命名空间”设置为 true为了确保目标名称空间形成。

data为节点的数据。

结果

新 ProcessingInstruction对象。

异常

DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的目标不是一个XML的名字了。
not_supported_err：如果该文件是一个HTML文件了。

createAttribute
```
Attr createAttribute(String name)
              throws DOMException
```
创建一个给定的名称 Attr。注意，然后 Attr实例可以设置使用 setAttributeNode方法 Element。
to创建一个合格的名称和命名空间URI的属性，使用 createAttributeNS方法。

参数

name -属性的名称。

结果

一个新的 nodeName Attr对象属性设置为 name，和 localName， prefix，和 namespaceURI设置 null。属性的值是空字符串。

异常

DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的名称不是一个XML的名字了。

createEntityReference
```
EntityReference createEntityReference(String name)
                               throws DOMException
```
创建一个 EntityReference对象。此外，如果引用的实体是已知的，对 EntityReference节点的子列表是一样的，相应的 Entity节点。
注：如果任何后代的Entity节点有一个绑定命名空间前缀，所创建的EntityReference节点对应的后裔也松散；（其namespaceURI是null）。DOM级别2和3不支持任何的解决机制中的命名空间前缀，在这种情况下。

参数

name -参考实体的名称。不像 Document.createElementNS或 Document.createAttributeNS，没有命名空间以及形成的检查是对实体的名字了。应用程序应该调用 Document.normalizeDocument()用参数“命名空间”设置为 true为了确保实体名称的命名空间以及形成。

结果

新 EntityReference对象。

异常

DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的名称不是一个XML的名字了。
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）。
for所有节点，将节点创建由进口文件拥有一个节点对象，属性值的源节点的 nodeName和 nodeType相同，加上相关属性的命名空间（ prefix， localName，和 namespaceURI）。在 cloneNode操作，源节点是不会改变的。与导入节点相关的用户数据不被执行。然而，如果任何 UserDataHandlers已规定以及相关数据的处理程序将调用相应的参数，在该方法返回。
additional信息复制为适当的 nodeType，试图反映行为如果XML或HTML源从一个文件复制到另一个片段的预期，认识到两个文件可能有不同的DTD的XML实例。下面的列表为每个类型的节点介绍了具体的细节。

attribute_node

的 ownerElement属性设置为 null和 specified标志设置为 true上产生的 Attr。的源 Attr后裔递归进口和由此产生的节点重新组合形成相应的子树。请注意， deep参数对 Attr节点没有影响；他们总是把他们的孩子与他们当进口。

document_fragment_node

如果 deep选项被设置为 true的后裔，源 DocumentFragment递归进口和由此产生的节点重新进口 DocumentFragment下形成相应的子树。否则，这只是生成一个空的 DocumentFragment。

document_node

Document节点无法导入。

document_type_node

DocumentType节点无法导入。

element_node

指定属性的源元素节点都是进口的，并且产生的 Attr节点连接到产生 Element。默认属性不会被复制，虽然如果文档被导入到为这个元素的名称定义默认属性，则这些属性将被分配。如果 importNode deep参数被设置为 true，源元素的后代递归进口和由此产生的节点重新组合形成相应的子树。

entity_node

Entity节点可以进口，但是在DOM的 DocumentType的当前版本是只读的。对一个 DocumentType添加这些进口节点能力将被添加到未来版本的DOM。进出的 publicId， systemId，和 notationName属性复制。如果请求 deep导入的源 Entity后裔递归进口和由此产生的节点重新组合形成相应的子树。

entity_reference_node

只有 EntityReference本身被复制，即使是要求 deep进口，因为源和目标文件可能有不同的定义的实体。如果导入的文档为这个实体名称提供了一个定义，它的值将被分配。

notation_node

Notation节点可以进口，但是在DOM的 DocumentType的当前版本是只读的。对一个 DocumentType添加这些进口节点能力将被添加到未来版本的DOM。进出的 publicId和 systemId属性复制。请注意， deep参数由于他们不能有孩子对这种类型的节点没有影响。

processing_instruction_node

进口节点副本与源节点的 target和 data值。注意 deep参数由于他们不能有孩子对这种类型的节点没有影响。

text_node，cdata_section_node，comment_node

这三种类型的节点继承 CharacterData复制他们的 data和 length属性与源节点。注意 deep参数由于他们不能有孩子对这些类型的节点没有影响。

参数

importedNode -进口结。

deep -如果 true，递归导入指定节点下的子树；如果 false，只导入节点本身，如上面所解释。这没有影响到节点不能有孩子，和 Attr，和 EntityReference节点。

结果

进口节点属于这个 Document。

异常

DOMException - not_supported_err：如果节点的类型不支持提高进口。
invalid_character_err：如果有进口的名字不是一个XML名称根据使用的 Document.xmlVersion属性指定的XML版本了。这可能发生在导入XML 1.1 [ XML 1.1 ]元素转化成一个XML 1文档，例如。

从以下版本开始：

DOM级别2

createElementNS

Element createElementNS(String namespaceURI,
                        String qualifiedName)
                 throws DOMException

创建一个元素的名称和命名空间URI。
per [ 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：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的 qualifiedName不是XML的名字了。
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。
per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。

参数

namespaceURI -属性创建命名空间URI。

qualifiedName -属性的限定名来实例化。

结果

一个新的具有以下属性：

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

Attr对象

异常

DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的 qualifiedName不是XML的名字了。
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。如果一个元素有一个具有该值的标识属性，则返回的是未定义的。
DOM实现预期使用属性 Attr.isId确定如果一个属性是
注：属性的名称的“身份”或“身份”不是类型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()为了检查在已经被这 Document部分 Nodes无效字符。
DOM应用程序可以使用 DOMImplementation.hasFeature(feature, version)方法与参数值”xmlversion”和“1”（分别）来确定是否支持 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()为了检查在已经被这 Document部分 Nodes无效字符。
DOM应用程序可以使用 DOMImplementation.hasFeature(feature, version)方法与参数值”xmlversion”和“1”（分别）来确定是否支持 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”特征。

从以下版本开始：

DOM级别3

getStrictErrorChecking
```
boolean getStrictErrorChecking()
```
指定是否执行错误检查的属性。当设置为 false，实施免费不测试每个可能的错误情况对DOM操作通常定义，不提高DOM操作或错误报告的任何 DOMException同时使用 Document.normalizeDocument()。在错误的情况下，行为是未定义的。这是 true默认属性。

从以下版本开始：

DOM级别3

setStrictErrorChecking
```
void setStrictErrorChecking(boolean strictErrorChecking)
```
指定是否执行错误检查的属性。当设置为 false，实施免费不测试每个可能的错误情况对DOM操作通常定义，不提高DOM操作或错误报告的任何 DOMException同时使用 Document.normalizeDocument()。在出错的情况下，该行为是未定义的。这是 true默认属性。

从以下版本开始：

DOM级别3

getDocumentURI
```
String getDocumentURI()
```
该文件或 null位置如果未定义或者 Document创建使用 DOMImplementation.createDocument。没有词汇检查进行设置此属性时；这可能会导致一个 null返回值时使用 Node.baseURI。
当心，当 Document支持特征的“HTML”[ DOM Level 2 HTML ]，HTML的基础元素的href属性优先于此属性时，计算 Node.baseURI。

从以下版本开始：

DOM级别3

setDocumentURI
```
void setDocumentURI(String documentURI)
```
该文件或 null位置如果未定义或者 Document创建使用 DOMImplementation.createDocument。没有词汇检查进行设置此属性时；这可能会导致一个 null返回值时使用 Node.baseURI。
当心，当 Document支持特征的“HTML”[ DOM Level 2 HTML ]，HTML的基础元素的href属性优先于此属性时，计算 Node.baseURI。

从以下版本开始：

DOM级别3

adoptNode
```
Node adoptNode(Node source)
        throws DOMException
```
试图从另一个文档到该文档的节点。如果支持的话，它改变了源节点的 ownerDocument孩子，以及附加的属性节点，如果有任何。如果源节点有一个父节点，则首先从它的父节点的子列表中删除它。这有效地允许从一个文件移动到另一个树（不像 importNode()创建一个拷贝的源节点而非移动）。当它失败时，应用程序应该使用 Document.importNode()相反。请注意，如果所采用的节点已经是本文档的一部分（即源和目标文档是相同的），这种方法仍然具有从它的父的子列表中删除源节点的效果，如果有。下面的列表为每个类型的节点介绍了具体的细节。

attribute_node

的 ownerElement属性设置为 null和 specified旗帜是采用 Attr设置 true。的源 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例外，和程序应该按照使用的XML版本引进的名字不是XML名称中使用Document.normalizeDocument()方法检查。

参数

source -移动到该文件的节点。

结果

所采用的节点，或 null如果操作失败，如当源节点来自一个不同的实现。

异常

DOMException - not_supported_err：如果源节点的类型是 DOCUMENT， DOCUMENT_TYPE提出。
no_modification_allowed_err：源节点时，只读了。

从以下版本开始：

DOM级别3

getDomConfig
```
DOMConfiguration getDomConfig()
```
配置 Document.normalizeDocument()调用时使用。

从以下版本开始：

DOM级别3

normalizeDocument
```
void normalizeDocument()
```
这种方法的作用，似乎是要通过一个保存和加载周期，把文档的“正常”的形式。因此，此方法更新 EntityReference节点替换树和规范 Text节点，在方法 Node.normalize()定义。
否则，实际结果取决于功能被设置在 Document.domConfig对象和管理业务实际发生。很明显这种方法还可以根据算法描述，使形成的文件命名空间，检查字符归一化，消除 CDATASection节点，等看到 DOMConfiguration详情。
```
保存在文档中信息的XML信息定义/套（java的例子）domconfiguration docconfig = getdomconfig()提供；docconfig。设置参数（“信息集合”，布尔。真的）；normalizedocument()提供；
```
mutation事件，支持时，产生反映的文件发生的变化。
如果发生错误这一方法的调用中，例如尝试更新只读节点或 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现有节点。
when可能这只是改变给定的节点名称，否则这将创建一个具有指定名称的新节点，新节点如下所述替代现有的节点。
if只要改变给定节点的名称是不可能的，则执行以下操作：创建的新节点，任何注册的事件侦听器是新的节点注册，任何用户数据连接到旧的节点从节点删除旧的节点，如果它有一个从母体取出，这孩子们搬到新的节点，如果重命名节点是一个 Element属性移动到新节点，新节点插入的位置用来如果它有一个在其母的子节点列表有旧的节点，用户数据被连接到旧的节点连接到新的节点。
when节点被改名是一个 Element只有指定的属性是感动，默认属性源于DTD是根据新的元素名称更新。此外，实现可能会更新其他架构的默认属性。应用程序应该使用 Document.normalizeDocument()保证这些属性都是最新的。
when节点被改名为 Attr，连接到一个 Element，节点首先从 Element删除属性图。然后，一旦重命名，通过修改现有的节点或创建一个新的，如上所述，它被放回。
in之外，
- 用户数据的事件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：如果根据在使用中的 Document.xmlVersion属性指定的XML版本的新名称不能是一个XML的名字了。
wrong_document_err：当指定的节点创建从一个不同的文件到这个文件。
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/”。

从以下版本开始：

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