uTools-Manuals/docs/java/org/w3c/dom/Document.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.w3c.dom 
   </div>
<h2 class="title" title="Interface Document">Interface Document</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../../org/w3c/dom/Node.html" title="界面在org.w3c.dom">Node</a></span>
</dd>
</dl>
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../javax/xml/soap/SOAPPart.html" title="javax.xml.soap中的类">SOAPPart</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Document</span>
extends <a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></pre>
<div class="block">
<span><code>Document</code>接口代表整个HTML或XML文档。</span>
<span>在概念上，它是文档树的根，并提供对文档数据的主访问。</span>
<p> <span>由于元素，文本节点，注释，处理指令等不能存在于<code>Document</code>的上下文<code>Document</code> ， <code>Document</code>接口还包含创建这些对象所需的工厂方法。</span> <span>创建的<code>Node</code>对象具有<code>ownerDocument</code>属性，它们与创建的上下文中的<code>Document</code> 。</span> </p>
<p> <span>另见<a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407">Document Object Model (DOM) Level 3 Core Specification</a> 。</span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Fields inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#ATTRIBUTE_NODE">ATTRIBUTE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#CDATA_SECTION_NODE">CDATA_SECTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#COMMENT_NODE">COMMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_FRAGMENT_NODE">DOCUMENT_FRAGMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_NODE">DOCUMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINED_BY">DOCUMENT_POSITION_CONTAINED_BY</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINS">DOCUMENT_POSITION_CONTAINS</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_DISCONNECTED">DOCUMENT_POSITION_DISCONNECTED</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_FOLLOWING">DOCUMENT_POSITION_FOLLOWING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC">DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_PRECEDING">DOCUMENT_POSITION_PRECEDING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_TYPE_NODE">DOCUMENT_TYPE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ELEMENT_NODE">ELEMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_NODE">ENTITY_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_REFERENCE_NODE">ENTITY_REFERENCE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#NOTATION_NODE">NOTATION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#PROCESSING_INSTRUCTION_NODE">PROCESSING_INSTRUCTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#TEXT_NODE">TEXT_NODE</a></code></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#adoptNode-org.w3c.dom.Node-">adoptNode</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> source)</code>
<div class="block">
              尝试从另一个文档中采用节点到本文档。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Attr.html" title="interface in org.w3c.dom">Attr</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createAttribute-java.lang.String-">createAttribute</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              创建给定名称的 
             <code>Attr</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Attr.html" title="interface in org.w3c.dom">Attr</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createAttributeNS-java.lang.String-java.lang.String-">createAttributeNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)</code>
<div class="block">
              创建给定的限定名称和命名空间URI的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../org/w3c/dom/CDATASection.html" title="interface in org.w3c.dom">CDATASection</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createCDATASection-java.lang.String-">createCDATASection</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</code>
<div class="block">
              创建值为指定字符串的 
             <code>CDATASection</code>节点。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Comment.html" title="interface in org.w3c.dom">Comment</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createComment-java.lang.String-">createComment</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</code>
<div class="block">
              创建给定指定字符串的 
             <code>Comment</code>节点。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../org/w3c/dom/DocumentFragment.html" title="interface in org.w3c.dom">DocumentFragment</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createDocumentFragment--">createDocumentFragment</a></span>()</code>
<div class="block">
              创建一个空的 
             <code>DocumentFragment</code>对象。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createElement-java.lang.String-">createElement</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> tagName)</code>
<div class="block">
              创建指定类型的元素。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createElementNS-java.lang.String-java.lang.String-">createElementNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)</code>
<div class="block">
              创建给定限定名称和命名空间URI的元素。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code><a href="../../../org/w3c/dom/EntityReference.html" title="interface in org.w3c.dom">EntityReference</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createEntityReference-java.lang.String-">createEntityReference</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
              创建一个 
             <code>EntityReference</code>对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code><a href="../../../org/w3c/dom/ProcessingInstruction.html" title="interface in org.w3c.dom">ProcessingInstruction</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createProcessingInstruction-java.lang.String-java.lang.String-">createProcessingInstruction</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</code>
<div class="block">
              创建指定名称和数据字符串的 
             <code>ProcessingInstruction</code>节点。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#createTextNode-java.lang.String-">createTextNode</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</code>
<div class="block">
              创建给定指定字符串的 
             <code>Text</code>节点。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code><a href="../../../org/w3c/dom/DocumentType.html" title="interface in org.w3c.dom">DocumentType</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getDoctype--">getDoctype</a></span>()</code>
<div class="block">
              与本文档相关联的文档类型声明（参见 
             <code>DocumentType</code> ）。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getDocumentElement--">getDocumentElement</a></span>()</code>
<div class="block">
              这是一个方便属性，允许直接访问作为文档的文档元素的子节点。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getDocumentURI--">getDocumentURI</a></span>()</code>
<div class="block">
              文件的位置或 
             <code>null</code>如果未定义，或 
             <code>Document</code>是否使用 
             <code>DOMImplementation.createDocument</code>创建。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../../org/w3c/dom/DOMConfiguration.html" title="interface in org.w3c.dom">DOMConfiguration</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getDomConfig--">getDomConfig</a></span>()</code>
<div class="block">
              调用Document.normalizeDocument()时使用的 
             <code>Document.normalizeDocument()</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getElementById-java.lang.String-">getElementById</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> elementId)</code>
<div class="block">
              返回 
             <code>Element</code>具有与给定值的ID属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code><a href="../../../org/w3c/dom/NodeList.html" title="interface in org.w3c.dom">NodeList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getElementsByTagName-java.lang.String-">getElementsByTagName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> tagname)</code>
<div class="block">
              以文件顺序返回 
             <code>NodeList</code>所有 
             <code>Elements</code>的给定标签名称，并包含在文档中。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code><a href="../../../org/w3c/dom/NodeList.html" title="interface in org.w3c.dom">NodeList</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getElementsByTagNameNS-java.lang.String-java.lang.String-">getElementsByTagNameNS</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
              返回 
             <code>NodeList</code>的所有 
             <code>Elements</code>具有给定本地名称和命名空间URI在文档顺序。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code><a href="../../../org/w3c/dom/DOMImplementation.html" title="interface in org.w3c.dom">DOMImplementation</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getImplementation--">getImplementation</a></span>()</code>
<div class="block">
              处理此文档的 
             <code>DOMImplementation</code>对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getInputEncoding--">getInputEncoding</a></span>()</code>
<div class="block">
              指定在解析时用于此文档的编码的属性。 
            </div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getStrictErrorChecking--">getStrictErrorChecking</a></span>()</code>
<div class="block">
              指定是否强制执行错误检查的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getXmlEncoding--">getXmlEncoding</a></span>()</code>
<div class="block">
              一个属性指定，作为一部分 
             <a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件的编码。 
            </div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getXmlStandalone--">getXmlStandalone</a></span>()</code>
<div class="block">
              一个属性指定，作为一部分 
             <a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件是否是单独的。 
            </div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#getXmlVersion--">getXmlVersion</a></span>()</code>
<div class="block">
              作为XML declaration的一部分的 
             <a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">属性</a> ，指定此文档的版本号。 
            </div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#importNode-org.w3c.dom.Node-boolean-">importNode</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> importedNode, boolean deep)</code>
<div class="block">
<span>将节点从另一个文档导入到本文档中，而不从原始文档更改或删除源节点;</span>
<span>此方法创建源节点的新副本。</span>
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#normalizeDocument--">normalizeDocument</a></span>()</code>
<div class="block">
              该方法的作用就好像文档正在进行保存和加载循环，将文档置于“正常”形式。 
            </div> </td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#renameNode-org.w3c.dom.Node-java.lang.String-java.lang.String-">renameNode</a></span>(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> n, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)</code>
<div class="block">
              重命名类型为 
             <code>ELEMENT_NODE</code>或 
             <code>ATTRIBUTE_NODE</code>的现有节点。 
            </div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#setDocumentURI-java.lang.String-">setDocumentURI</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> documentURI)</code>
<div class="block">
              文件的位置或 
             <code>null</code>如果未定义）或 
             <code>Document</code>是否使用 
             <code>DOMImplementation.createDocument</code>创建。 
            </div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#setStrictErrorChecking-boolean-">setStrictErrorChecking</a></span>(boolean strictErrorChecking)</code>
<div class="block">
              指定是否强制执行错误检查的属性。 
            </div> </td>
</tr>
<tr class="rowColor" id="i29">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#setXmlStandalone-boolean-">setXmlStandalone</a></span>(boolean xmlStandalone)</code>
<div class="block">
              一个属性指定，作为一部分 
             <a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件是否是单独的。 
            </div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/w3c/dom/Document.html#setXmlVersion-java.lang.String-">setXmlVersion</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> xmlVersion)</code>
<div class="block">
              作为XML declaration的一部分的 
             <a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">属性</a> ，指定此文档的版本号。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#appendChild-org.w3c.dom.Node-">appendChild</a>, <a href="../../../org/w3c/dom/Node.html#cloneNode-boolean-">cloneNode</a>, <a href="../../../org/w3c/dom/Node.html#compareDocumentPosition-org.w3c.dom.Node-">compareDocumentPosition</a>, <a href="../../../org/w3c/dom/Node.html#getAttributes--">getAttributes</a>, <a href="../../../org/w3c/dom/Node.html#getBaseURI--">getBaseURI</a>, <a href="../../../org/w3c/dom/Node.html#getChildNodes--">getChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#getFeature-java.lang.String-java.lang.String-">getFeature</a>, <a href="../../../org/w3c/dom/Node.html#getFirstChild--">getFirstChild</a>, <a href="../../../org/w3c/dom/Node.html#getLastChild--">getLastChild</a>, <a href="../../../org/w3c/dom/Node.html#getLocalName--">getLocalName</a>, <a href="../../../org/w3c/dom/Node.html#getNamespaceURI--">getNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#getNextSibling--">getNextSibling</a>, <a href="../../../org/w3c/dom/Node.html#getNodeName--">getNodeName</a>, <a href="../../../org/w3c/dom/Node.html#getNodeType--">getNodeType</a>, <a href="../../../org/w3c/dom/Node.html#getNodeValue--">getNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#getOwnerDocument--">getOwnerDocument</a>, <a href="../../../org/w3c/dom/Node.html#getParentNode--">getParentNode</a>, <a href="../../../org/w3c/dom/Node.html#getPrefix--">getPrefix</a>, <a href="../../../org/w3c/dom/Node.html#getPreviousSibling--">getPreviousSibling</a>, <a href="../../../org/w3c/dom/Node.html#getTextContent--">getTextContent</a>, <a href="../../../org/w3c/dom/Node.html#getUserData-java.lang.String-">getUserData</a>, <a href="../../../org/w3c/dom/Node.html#hasAttributes--">hasAttributes</a>, <a href="../../../org/w3c/dom/Node.html#hasChildNodes--">hasChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#insertBefore-org.w3c.dom.Node-org.w3c.dom.Node-">insertBefore</a>, <a href="../../../org/w3c/dom/Node.html#isDefaultNamespace-java.lang.String-">isDefaultNamespace</a>, <a href="../../../org/w3c/dom/Node.html#isEqualNode-org.w3c.dom.Node-">isEqualNode</a>, <a href="../../../org/w3c/dom/Node.html#isSameNode-org.w3c.dom.Node-">isSameNode</a>, <a href="../../../org/w3c/dom/Node.html#isSupported-java.lang.String-java.lang.String-">isSupported</a>, <a href="../../../org/w3c/dom/Node.html#lookupNamespaceURI-java.lang.String-">lookupNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#lookupPrefix-java.lang.String-">lookupPrefix</a>, <a href="../../../org/w3c/dom/Node.html#normalize--">normalize</a>, <a href="../../../org/w3c/dom/Node.html#removeChild-org.w3c.dom.Node-">removeChild</a>, <a href="../../../org/w3c/dom/Node.html#replaceChild-org.w3c.dom.Node-org.w3c.dom.Node-">replaceChild</a>, <a href="../../../org/w3c/dom/Node.html#setNodeValue-java.lang.String-">setNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#setPrefix-java.lang.String-">setPrefix</a>, <a href="../../../org/w3c/dom/Node.html#setTextContent-java.lang.String-">setTextContent</a>, <a href="../../../org/w3c/dom/Node.html#setUserData-java.lang.String-java.lang.Object-org.w3c.dom.UserDataHandler-">setUserData</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getDoctype--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDoctype</h4> <pre><a href="../../../org/w3c/dom/DocumentType.html" title="interface in org.w3c.dom">DocumentType</a> getDoctype()</pre>
<div class="block">
<span>与本文档相关联的文档类型声明（参见<code>DocumentType</code> ）。</span>
<span>对于没有文档类型声明的XML文档，返回<code>null</code> 。</span>
<span>对于HTML文档，可以返回<code>DocumentType</code>对象，而不管HTML文档中是否存在文档类型声明。</span>
<br/>
<span>这提供了直接访问<code>DocumentType</code>节点，这个<code>Document</code>子节点。</span>
<span>该节点可以在文档创建时设置，稍后通过使用子节点操作方法（例如<code>Node.insertBefore</code>或<code>Node.replaceChild</code> 。</span>
<span>然而，请注意，虽然一些实现可以实例化支持除“核心”之外的其他功能的不同类型的<code>Document</code>对象，例如“HTML”[ <a href="http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109">DOM Level 2 HTML</a> ]，基于在创建时<code>DocumentType</code> DocumentType，之后更改它不太可能导致在更改支持的功能。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getImplementation--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getImplementation</h4> <pre><a href="../../../org/w3c/dom/DOMImplementation.html" title="interface in org.w3c.dom">DOMImplementation</a> getImplementation()</pre>
<div class="block">
<span>处理此文档的<code>DOMImplementation</code>对象。</span>
<span>DOM应用程序可以使用来自多个实现的对象。</span>
</div> </li>
</ul> <a name="getDocumentElement--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDocumentElement</h4> <pre><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> getDocumentElement()</pre>
<div class="block">
            这是一个方便属性，允许直接访问作为文档的文档元素的子节点。 
          </div> </li>
</ul> <a name="createElement-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createElement</h4> <pre><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> createElement(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> tagName)
               throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>创建指定类型的元素。</span>
<span>请注意，返回的实例实现了<code>Element</code>接口，因此可以直接在返回的对象上指定属性。</span>
<br/>
<span>另外，如果存在具有默认值的已知属性， <code>Attr</code>自动创建表示它们的<code>Attr</code>个节点并附加到该元素。</span>
<br/>
<span>要创建具有限定名称和命名空间URI的元素，请使用<code>createElementNS</code>方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>tagName</code> - 要实例化的元素类型的名称。</span>
<span>对于XML，这是区分大小写的，否则取决于使用的标记语言的区分大小写。</span>
<span>在这种情况下，该名称将通过DOM实现映射到该标记的规范形式。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一种新的 
            <code>Element</code>与对象 
            <code>nodeName</code>属性设置为 
            <code>tagName</code> ，和 
            <code>localName</code> ， 
            <code>prefix</code>和 
            <code>namespaceURI</code>设置为 
            <code>null</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集 
            <code>Document.xmlVersion</code>属性。 
           </dd>
</dl> </li>
</ul> <a name="createDocumentFragment--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDocumentFragment</h4> <pre><a href="../../../org/w3c/dom/DocumentFragment.html" title="interface in org.w3c.dom">DocumentFragment</a> createDocumentFragment()</pre>
<div class="block">
            创建一个空的 
           <code>DocumentFragment</code>对象。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个新的 
            <code>DocumentFragment</code> 。 
           </dd>
</dl> </li>
</ul> <a name="createTextNode-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createTextNode</h4> <pre><a href="../../../org/w3c/dom/Text.html" title="interface in org.w3c.dom">Text</a> createTextNode(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</pre>
<div class="block">
            创建给定指定字符串的 
           <code>Text</code>节点。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>data</code> - 节点的数据。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>Text</code>对象。 
           </dd>
</dl> </li>
</ul> <a name="createComment-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createComment</h4> <pre><a href="../../../org/w3c/dom/Comment.html" title="interface in org.w3c.dom">Comment</a> createComment(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)</pre>
<div class="block">
            创建给定指定字符串的 
           <code>Comment</code>节点。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>data</code> - 节点的数据。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>Comment</code>对象。 
           </dd>
</dl> </li>
</ul> <a name="createCDATASection-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createCDATASection</h4> <pre><a href="../../../org/w3c/dom/CDATASection.html" title="interface in org.w3c.dom">CDATASection</a> createCDATASection(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)
                         throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
            创建值为指定字符串的 
           <code>CDATASection</code>节点。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>data</code> - 
            <code>CDATASection</code>内容的数据。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>CDATASection</code>对象。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。 
           </dd>
</dl> </li>
</ul> <a name="createProcessingInstruction-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createProcessingInstruction</h4> <pre><a href="../../../org/w3c/dom/ProcessingInstruction.html" title="interface in org.w3c.dom">ProcessingInstruction</a> createProcessingInstruction(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> target,
                                                  <a href="../../../java/lang/String.html" title="class in java.lang">String</a> data)
                                           throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
            创建一个给定指定名称和数据字符串的 
           <code>ProcessingInstruction</code>节点。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>target</code> - 处理<code>target</code>的目标部分。不像<code>Document.createElementNS</code>或<code>Document.createAttributeNS</code> ，目标名称上没有对命名空间进行完整的检查。</span>
<span>应用程序应调用<code>Document.normalizeDocument()</code> ，其参数“namespaces”设置为<code>true</code> ，以确保目标名称的命名空间格式正确。</span>
</dd>
<dd>
<code>data</code> - 节点的数据。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>ProcessingInstruction</code>对象。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：如果指定的目标是不按照规定使用的XML版本的XML名称募集<code>Document.xmlVersion</code>属性。</span>
<br/>
<span>NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。</span>
</dd>
</dl> </li>
</ul> <a name="createAttribute-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createAttribute</h4> <pre><a href="../../../org/w3c/dom/Attr.html" title="interface in org.w3c.dom">Attr</a> createAttribute(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
              throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>创建给定名称的<code>Attr</code> 。</span>
<span>请注意， <code>Attr</code>实例可以使用<code>setAttributeNode</code>方法设置在<code>Element</code>上。</span>
<br/>
<span>要创建具有限定名称和命名空间URI的<code>createAttributeNS</code> ，请使用<code>createAttributeNS</code>方法。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性的名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一种新的<code>Attr</code>与对象<code>nodeName</code>属性设置为<code>name</code> ，和<code>localName</code> ， <code>prefix</code>和<code>namespaceURI</code>设置为<code>null</code> 。</span>
<span>属性的值为空字符串。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集 
            <code>Document.xmlVersion</code>属性。 
           </dd>
</dl> </li>
</ul> <a name="createEntityReference-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createEntityReference</h4> <pre><a href="../../../org/w3c/dom/EntityReference.html" title="interface in org.w3c.dom">EntityReference</a> createEntityReference(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
                               throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>创建一个<code>EntityReference</code>对象。</span>
<span>此外，如果引用的实体是已知的，的子列表<code>EntityReference</code>节点由相同相应的<code>Entity</code>节点。</span>
<p> <span><b>注意：</b>如果<code>Entity</code>节点的任何后代具有未绑定的命名空间前缀，则创建的<code>EntityReference</code>节点的相应后代也将不绑定;</span> <span>（其<code>namespaceURI</code>是<code>null</code> ）。</span> <span>在这种情况下，DOM Level 2和3不支持任何解决名称空间前缀的机制。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 要引用的实体的名称。不像<code>Document.createElementNS</code>或<code>Document.createAttributeNS</code> ，实体名称上没有对命名空间进行完整的检查。</span>
<span>应用程序应调用<code>Document.normalizeDocument()</code> ，参数“namespaces”设置为<code>true</code> ，以确保实体名称具有良好的命名空间。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>EntityReference</code>对象。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：如果指定的名称是不按照规定使用的XML版本的XML名称募集<code>Document.xmlVersion</code>属性。</span>
<br/>
<span>NOT_SUPPORTED_ERR：如果此文档是HTML文档，则引发。</span>
</dd>
</dl> </li>
</ul> <a name="getElementsByTagName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElementsByTagName</h4> <pre><a href="../../../org/w3c/dom/NodeList.html" title="interface in org.w3c.dom">NodeList</a> getElementsByTagName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> tagname)</pre>
<div class="block">
            返回 
           <code>NodeList</code>所有的 
           <code>Elements</code>文档顺序与给定的标签名称，包含在文档中。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>tagname</code> - 要匹配的标签的名称。</span>
<span>特殊值“*”匹配所有标签。</span>
<span>对于XML， <code>tagname</code>参数区分大小写，否则取决于使用的标记语言的大小写敏感度。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个新的 
            <code>NodeList</code>对象包含所有匹配的 
            <code>Elements</code> 。 
           </dd>
</dl> </li>
</ul> <a name="importNode-org.w3c.dom.Node-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>importNode</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> importNode(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> importedNode,
                boolean deep)
         throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>将节点从另一个文档导入到本文档中，而不从原始文档更改或删除源节点;</span>
<span>此方法创建源节点的新副本。</span>
<span>返回的节点没有父节点;</span>
<span>（ <code>parentNode</code>是<code>null</code> ）。</span>
<br/>
<span>所有节点，导入节点创建由进口文档拥有的节点对象，具有属性值相同的源节点的<code>nodeName</code>和<code>nodeType</code> ，加上与命名空间属性（ <code>prefix</code> ， <code>localName</code>和<code>namespaceURI</code> ）。</span>
<span>与<code>cloneNode</code>一样，源节点也没有改变。</span>
<span>与导入的节点关联的用户数据不会被转移。</span>
<span>但是，如果任何<code>UserDataHandlers</code>已经与相关数据指定沿着这些处理器将与该方法返回之前适当的参数调用。</span>
<br/>
<span>附加信息被复制为适合于<code>nodeType</code> ，试图镜像预期如果XML或HTML源的片段从一个文档复制到另一个，认识到这两个文件可以具有在XML的情况下不同的DTD的行为。</span>
<span>以下列表描述了每种节点类型的细节。</span>
<dl>
<dt>
<span>ATTRIBUTE_NODE</span>
</dt>
<dd>
<span>所述<code>ownerElement</code>属性被设置为<code>null</code>和<code>specified</code>标志被设置为<code>true</code>所生成的<code>Attr</code> 。</span>
<span>源<code>Attr</code>被递归导入，并且所生成的节点重新组合以形成相应的子树。</span>
<span>请注意， <code>deep</code>参数对<code>Attr</code>节点没有影响;</span>
<span>进口时，他们总是带着孩子。</span>
</dd>
<dt>
<span>DOCUMENT_FRAGMENT_NODE</span>
</dt>
<dd>
<span>如果<code>deep</code>选项设置为<code>true</code> ，则源<code>DocumentFragment</code>被递归导入，并且所生成的节点在导入的<code>DocumentFragment</code>下重新<code>DocumentFragment</code>以形成相应的子树。</span>
<span>否则，这只会产生一个空的<code>DocumentFragment</code> 。</span>
</dd>
<dt>
<span>DOCUMENT_NODE</span>
</dt>
<dd>
<span><code>Document</code>节点无法导入。</span>
</dd>
<dt>
<span>DOCUMENT_TYPE_NODE</span>
</dt>
<dd>
<span><code>DocumentType</code>无法导入节点。</span>
</dd>
<dt>
<span>ELEMENT_NODE</span>
</dt>
<dd>
<span>源元素的<em>指定的</em>属性节点被导入，并且将所生成<code>Attr</code>节点连接到所生成的<code>Element</code> 。</span>
<span>默认属性<em>不</em>被复制，但是如果要导入的文档定义了该元素名称的默认属性，那么它们将被分配。</span>
<span>如果<code>importNode</code> <code>deep</code>参数设置为<code>true</code> ，则源元素的后代将被递归导入，并将生成的节点重新组合以形成相应的子树。</span>
</dd>
<dt>
<span>ENTITY_NODE</span>
</dt>
<dd>
<span><code>Entity</code>节点可以导入，但是在当前版本的DOM中， <code>DocumentType</code>是只读方式。</span>
<span>能力将这些导入的节点添加到<code>DocumentType</code>将考虑除了未来DOM.On进口的发布， <code>publicId</code> ， <code>systemId</code>和<code>notationName</code>属性被复制。</span>
<span>如果<code>deep</code>导入，源<code>Entity</code>将被递归导入，并将生成的节点重新组合以形成相应的子树。</span>
</dd>
<dt>
<span>ENTITY_REFERENCE_NODE</span>
</dt>
<dd>
<span>只有<code>EntityReference</code>本身被复制，即使要求<code>deep</code>导入，因为源和目的地文档可能不同地定义了实体。</span>
<span>如果导入的文档为此实体名称提供了定义，则会分配其值。</span>
</dd>
<dt>
<span>NOTATION_NODE</span>
</dt>
<dd>
<span><code>Notation</code>节点可以导入，但在当前版本的DOM中， <code>DocumentType</code>是只读方式。</span>
<span>将这些导入的节点添加到<code>DocumentType</code>将被考虑添加到将来的DOM.On导入中， <code>publicId</code>和<code>systemId</code>属性被复制。</span>
<span>请注意， <code>deep</code>参数对此类型的节点没有影响，因为它们不能有任何子节点。</span>
</dd>
<dt>
<span>PROCESSING_INSTRUCTION_NODE</span>
</dt>
<dd>
<span>导入的节点从源节点复制其<code>target</code>和<code>data</code>值。请注意， <code>deep</code>参数对此类型的节点没有影响，因为它们不能有任何子节点。</span>
</dd>
<dt>
<span>TEXT_NODE，CDATA_SECTION_NODE，COMMENT_NODE</span>
</dt>
<dd>
<span>这三种类型的继承节点<code>CharacterData</code>复制他们<code>data</code>个<code>length</code>从那些在源node.Note的属性<code>deep</code>参数对这些类型的节点无效，因为它们不能有任何孩子。</span>
</dd>
</dl>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>importedNode</code> - 要导入的节点。 
           </dd>
<dd>
<span><code>deep</code> - 如果<code>true</code> ，递归地导入指定节点下的子树;</span>
<span>如果<code>false</code> ，只导入节点本身，如上所述。</span>
<span>这对于不能有<code>EntityReference</code>节点的节点，并且在<code>Attr</code>和<code>EntityReference</code>节点上没有影响。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             导入的节点属于此 
            <code>Document</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：如果不支持正在导入的节点类型，则引发。</span>
<br/>
<span>INVALID_CHARACTER_ERR：若进口的名字之一是不按照规定使用的XML版本的XML名称<code>Document.xmlVersion</code>属性。</span>
<span>例如，当将XML 1.1 [ <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]元素导入XML 1.0文档时，可能会发生这种情况。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM级别2 
           </dd>
</dl> </li>
</ul> <a name="createElementNS-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createElementNS</h4> <pre><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> createElementNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
                        <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)
                 throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>创建给定限定名称和命名空间URI的元素。</span>
<br/>
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，应用程序必须使用值<code>null</code>作为方法的namespaceURI参数，如果他们希望没有命名空间。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要创建的元素的命名空间URI。 
           </dd>
<dd>
<code>qualifiedName</code> - 要实例化的元素类型的限定名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个新的<code>Element</code>对象具有以下属性：</span>
<span>  Attribute Value   <code>Node.nodeName</code> <code>qualifiedName</code> <code>Node.namespaceURI</code> <code>namespaceURI</code> <code>Node.prefix</code> prefix, extracted from <code>qualifiedName</code>, or <code>null</code> if there is no prefix   <code>Node.localName</code> local name, extracted from <code>qualifiedName</code> <code>Element.tagName</code> <code>qualifiedName</code> </span>
<table border="1" cellpadding="3">
</table>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：若指定的<code>qualifiedName</code>不按照规定使用的XML版本的XML名称<code>Document.xmlVersion</code>属性。</span>
<br/>
<span>NAMESPACE_ERR：若所述<code>qualifiedName</code>是畸形限定名，如果<code>qualifiedName</code>具有前缀和<code>namespaceURI</code>是<code>null</code> ，或如果<code>qualifiedName</code>具有前缀为“xml”和<code>namespaceURI</code>距离“不同<a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a> ” [ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，或如果<code>qualifiedName</code>或其前缀为“xmlns”和<code>namespaceURI</code>距离“不同<a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> ”，或者如果<code>namespaceURI</code>是“ <a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> ”，而本<code>qualifiedName</code>也不其前缀为“xmlns”。</span>
<br/>
<span>NOT_SUPPORTED_ERR：如果当前文档不支持<code>"XML"</code>功能，则始终抛出，因为命名空间是由XML定义的。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM级别2 
           </dd>
</dl> </li>
</ul> <a name="createAttributeNS-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createAttributeNS</h4> <pre><a href="../../../org/w3c/dom/Attr.html" title="interface in org.w3c.dom">Attr</a> createAttributeNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
                       <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)
                throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>创建给定的限定名称和命名空间URI的属性。</span>
<br/>
<span>按照[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ]，应用程序必须使用值<code>null</code>作为方法的<code>namespaceURI</code>参数，如果他们希望没有命名空间。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要创建的属性的命名空间URI。 
           </dd>
<dd>
<code>qualifiedName</code> - 要实例化的属性的限定名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个新的<code>Attr</code>对象具有以下属性：</span>
<span>   Attribute Value   <code>Node.nodeName</code> qualifiedName    <code>Node.namespaceURI</code> <code>namespaceURI</code> <code>Node.prefix</code> prefix, extracted from <code>qualifiedName</code>, or <code>null</code> if there is no prefix   <code>Node.localName</code> local name, extracted from <code>qualifiedName</code> <code>Attr.name</code> <code>qualifiedName</code> <code>Node.nodeValue</code> the empty string  </span>
<table border="1" cellpadding="3">
</table>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - INVALID_CHARACTER_ERR：若指定的<code>qualifiedName</code>不按照规定使用的XML版本的XML名称<code>Document.xmlVersion</code>属性。</span>
<br/>
<span>NAMESPACE_ERR：若该<code>qualifiedName</code>是错误格式的限定名称，如果<code>qualifiedName</code>有一个前缀， <code>namespaceURI</code>是<code>null</code> ，如果<code>qualifiedName</code>有前缀为“xml”和<code>namespaceURI</code>是“不同<a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a> ”，如果<code>qualifiedName</code>或其前缀为“xmlns”和<code>namespaceURI</code>距离“不同<a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> ”，或者如果<code>namespaceURI</code>是“ <a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> ”，而本<code>qualifiedName</code>也不其前缀为“xmlns”。</span>
<br/>
<span>NOT_SUPPORTED_ERR：如果当前文档不支持<code>"XML"</code>功能，则始终抛出，因为命名空间是由XML定义的。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM级别2 
           </dd>
</dl> </li>
</ul> <a name="getElementsByTagNameNS-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElementsByTagNameNS</h4> <pre><a href="../../../org/w3c/dom/NodeList.html" title="interface in org.w3c.dom">NodeList</a> getElementsByTagNameNS(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
                                <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</pre>
<div class="block">
            返回 
           <code>NodeList</code>的所有 
           <code>Elements</code>具有给定本地名称和命名空间URI在文档顺序。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>namespaceURI</code> - 要匹配的元素的命名空间URI。</span>
<span>特殊值<code>"*"</code>匹配所有命名空间。</span>
</dd>
<dd>
<span><code>localName</code> - 要匹配的元素的本地名称。</span>
<span>特殊值“*”与所有本地名称相匹配。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个新的 
            <code>NodeList</code>对象包含所有匹配的 
            <code>Elements</code> 。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM级别2 
           </dd>
</dl> </li>
</ul> <a name="getElementById-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElementById</h4> <pre><a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> getElementById(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> elementId)</pre>
<div class="block">
<span>返回<code>Element</code>具有与给定值的ID属性。</span>
<span>如果不存在这样的元素，则返回<code>null</code> 。</span>
<span>如果多个元素的ID属性为该值，那么返回的元素是未定义的。</span>
<br/>
<span>预期DOM实现将使用属性<code>Attr.isId</code>来确定属性是否为类型ID。</span>
<p> <span><b>注意：</b>除非如此定义，否则名称为“ID”或“id”的属性不是类型ID。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>elementId</code> - 元素的唯一 
            <code>id</code>值。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             匹配元素或 
            <code>null</code>如果没有。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM级别2 
           </dd>
</dl> </li>
</ul> <a name="getInputEncoding--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getInputEncoding</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getInputEncoding()</pre>
<div class="block">
<span>指定在解析时用于此文档的编码的属性。</span>
<span>这是<code>null</code>当它是不知道的，如<code>Document</code>是在内存中创建的。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getXmlEncoding--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getXmlEncoding</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getXmlEncoding()</pre>
<div class="block">
<span>一个属性指定，作为一部分<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件的编码。</span>
<span>这是<code>null</code>当未指定或不知道时，例如当内存中创建<code>Document</code>时。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getXmlStandalone--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getXmlStandalone</h4> <pre>boolean getXmlStandalone()</pre>
<div class="block">
<span>一个属性指定，作为一部分<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件是否是单独的。</span>
<span>这是<code>false</code>当未指定。</span>
<p> <span><b>注意：</b>设置此属性时，不会对该值进行验证。</span> <span>应用程序应使用<code>Document.normalizeDocument()</code>与“验证”参数，以验证值相匹配的<a href="http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd">validity constraint for standalone document declaration</a>如[定义<a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="setXmlStandalone-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setXmlStandalone</h4> <pre>void setXmlStandalone(boolean xmlStandalone)
               throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>一个属性指定，作为一部分<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">XML declaration</a> ，本文件是否是单独的。</span>
<span>这是<code>false</code>当未指定。</span>
<p> <span><b>注意：</b>设置此属性时，不会对该值进行验证。</span> <span>应用程序应使用<code>Document.normalizeDocument()</code>与“验证”参数，以验证值相匹配的<a href="http://www.w3.org/TR/2004/REC-xml-20040204#sec-rmd">validity constraint for standalone document declaration</a>如[定义<a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]。</span> </p>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：如果此文档不支持“XML”功能，则引发。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getXmlVersion--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getXmlVersion</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getXmlVersion()</pre>
<div class="block">
<span>作为XML declaration的一部分的<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">属性</a> ，指定此文档的版本号。</span>
<span>如果没有声明，如果此文档支持“XML”功能，则值为<code>"1.0"</code> 。</span>
<span>如果此文档不支持“XML”功能，则该值始终为<code>null</code> 。</span>
<span>更改此属性将影响检查XML名称中无效字符的方法。</span>
<span>应用程序应该调用<code>Document.normalizeDocument()</code> ，以检查在无效字符<code>Node</code> s表示已经是此的一部分<code>Document</code> 。</span>
<br/>
<span>DOM应用程序可以使用<code>DOMImplementation.hasFeature(feature, version)</code>方法与参数值为“XMLVersion”和“1.0”（分别地），以确定是否实现支持[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]。</span>
<span>DOM应用程序可能使用与参数值“XMLVersion”和“1.1”（分别）相同的方法来确定实现是否支持[ <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]。</span>
<span>在这两种情况下，为了支持XML，实现还必须支持本规范中定义的“XML”功能。</span>
<span><code>Document</code>对象支持的版本为“XMLVersion”功能不能养<code>NOT_SUPPORTED_ERR</code>使用时例外相同的版本号<code>Document.xmlVersion</code> 。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="setXmlVersion-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setXmlVersion</h4> <pre>void setXmlVersion(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> xmlVersion)
            throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>作为XML declaration的一部分的<a href="http://www.w3.org/TR/2004/REC-xml-20040204#NT-XMLDecl">属性</a> ，指定此文档的版本号。</span>
<span>如果没有声明，如果此文档支持“XML”功能，则值为<code>"1.0"</code> 。</span>
<span>如果此文档不支持“XML”功能，则该值始终为<code>null</code> 。</span>
<span>更改此属性将影响检查XML名称中无效字符的方法。</span>
<span>应用程序应该调用<code>Document.normalizeDocument()</code> ，以检查在无效字符<code>Node</code> s表示已经是此的一部分<code>Document</code> 。</span>
<br/>
<span>DOM应用程序可以使用参数值“XMLVersion”和“1.0”（分别）的<code>DOMImplementation.hasFeature(feature, version)</code>方法来确定实现是否支持[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]。</span>
<span>DOM应用程序可能使用与参数值“XMLVersion”和“1.1”（分别）相同的方法来确定实现是否支持[ <a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]。</span>
<span>在这两种情况下，为了支持XML，实现还必须支持本规范中定义的“XML”功能。</span>
<span><code>Document</code>对象支持的版本为“XMLVersion”功能不能养<code>NOT_SUPPORTED_ERR</code>使用时例外相同的版本号<code>Document.xmlVersion</code> 。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：如果版本设置为此 
            <code>Document</code>不支持的值或者该文档不支持“XML”功能，则 
            <code>Document</code> 。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getStrictErrorChecking--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getStrictErrorChecking</h4> <pre>boolean getStrictErrorChecking()</pre>
<div class="block">
<span>指定是否强制执行错误检查的属性。</span>
<span>当设置为<code>false</code> ，实行免费不测试通常在DOM操作上定义的每个可能的错误情况下，并没有提出任何<code>DOMException</code>在DOM操作或者报告错误，而使用<code>Document.normalizeDocument()</code> 。</span>
<span>如果出现错误，行为是未定义的。</span>
<span>此属性默认为<code>true</code> 。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="setStrictErrorChecking-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setStrictErrorChecking</h4> <pre>void setStrictErrorChecking(boolean strictErrorChecking)</pre>
<div class="block">
<span>指定是否强制执行错误检查的属性。</span>
<span>当设置为<code>false</code> ，实行免费不测试通常在DOM操作上定义的每个可能的错误情况下，并没有提出任何<code>DOMException</code>在DOM操作或者报告错误，而使用<code>Document.normalizeDocument()</code> 。</span>
<span>如果出现错误，行为是未定义的。</span>
<span>此属性默认为<code>true</code> 。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getDocumentURI--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDocumentURI</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getDocumentURI()</pre>
<div class="block">
<span>文件的位置或<code>null</code>如果未定义）或<code>Document</code>是否使用<code>DOMImplementation.createDocument</code>创建。</span>
<span>设置此属性时不执行词法检查;</span>
<span>这可能会导致使用<code>null</code>时返回的值为<code>Node.baseURI</code> 。</span>
<br/>
<span>当<code>Document</code>支持功能“HTML”[ <a href="http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109">DOM Level 2 HTML</a> ]时， <code>Document</code>注意，当计算<code>Document</code>时，HTML BASE元素的href属性优先于此<code>Node.baseURI</code> 。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="setDocumentURI-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDocumentURI</h4> <pre>void setDocumentURI(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> documentURI)</pre>
<div class="block">
<span>文件的位置或<code>null</code>如果未定义）或<code>Document</code>是否使用<code>DOMImplementation.createDocument</code>创建。</span>
<span>设置此属性时不执行词法检查;</span>
<span>这可能会导致一个<code>null</code>使用时返回的值<code>Node.baseURI</code> 。</span>
<br/>
<span>当<code>Document</code>支持功能“HTML”[ <a href="http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109">DOM Level 2 HTML</a> ]时，当计算Node.baseURI时，HTML BASE元素的href属性优先于此<code>Node.baseURI</code> 。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="adoptNode-org.w3c.dom.Node-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>adoptNode</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> adoptNode(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> source)
        throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>尝试从另一个文档中采用节点到本文档。</span>
<span>如果支持，它会改变源节点的<code>ownerDocument</code> ，其子节点，以及附加的属性节点（如果有的话）。</span>
<span>如果源节点有父，则首先从其父列表的子列表中删除它。</span>
<span>这有效地允许将子树从一个文档移动到另一个文档（不像<code>importNode()</code>创建源节点的副本而不是移动它）。</span>
<span>当它失败时，应用程序应该使用<code>Document.importNode()</code> 。</span>
<span>请注意，如果采用的节点已经是本文档的一部分（即源文档和目标文档是相同的），则该方法仍然具有从其父代的子列表中删除源节点的效果（如果有的话）。</span>
<span>以下列表描述了每种节点类型的细节。</span>
<dl>
<dt>
<span>ATTRIBUTE_NODE</span>
</dt>
<dd>
<span>该<code>ownerElement</code>属性设置为<code>null</code>和<code>specified</code>标志设置为<code>true</code>所采用的<code>Attr</code> 。</span>
<span>源<code>Attr</code>被递归地采用。</span>
</dd>
<dt>
<span>DOCUMENT_FRAGMENT_NODE</span>
</dt>
<dd>
<span>源节点的后代被递归地采用。</span>
</dd>
<dt>
<span>DOCUMENT_NODE</span>
</dt>
<dd>
<span><code>Document</code>节点不能采用。</span>
</dd>
<dt>
<span>DOCUMENT_TYPE_NODE</span>
</dt>
<dd>
<span><code>DocumentType</code>节点不能采用。</span>
</dd>
<dt>
<span>ELEMENT_NODE</span>
</dt>
<dd>
<span>采用源元素的<em>指定</em>属性节点。</span>
<span>丢弃默认属性，但是如果要采用的文档定义了此元素名称的默认属性，则会分配这些属性。</span>
<span>源元素的后代被递归地采用。</span>
</dd>
<dt>
<span>ENTITY_NODE</span>
</dt>
<dd>
<span><code>Entity</code>节点不能采用。</span>
</dd>
<dt>
<span>ENTITY_REFERENCE_NODE</span>
</dt>
<dd>
<span>只有<code>EntityReference</code>节点本身被采用，后代被丢弃，因为源和目的地文档可能不同地定义了实体。</span>
<span>如果导入的文档为此实体名称提供了定义，则会分配其值。</span>
</dd>
<dt>
<span>NOTATION_NODE</span>
</dt>
<dd>
<span><code>Notation</code>节点不能采用。</span>
</dd>
<dt>
<span>PROCESSING_INSTRUCTION_NODE，TEXT_NODE，CDATA_SECTION_NODE，COMMENT_NODE</span>
</dt>
<dd>
<span>这些节点都可以被采用。</span>
<span>没有细节。</span>
</dd>
</dl>
<p> <span><b>注意：</b>由于它不像<code>Document.importNode()</code>方法那样创建新节点，因此此方法不会引发<code>INVALID_CHARACTER_ERR</code>异常，应用程序应使用<code>Document.normalizeDocument()</code>方法根据正在使用的XML版本检查导入的名称是否不是XML名称。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 要移入此文档的节点。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             所采用的节点，或 
            <code>null</code>如果此操作失败，例如源节点来自不同的实现。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：如果源节点的类型为<code>DOCUMENT</code> ， <code>DOCUMENT_TYPE</code> 。</span>
<br/>
<span>NO_MODIFICATION_ALLOWED_ERR：源节点只读时引发。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="getDomConfig--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDomConfig</h4> <pre><a href="../../../org/w3c/dom/DOMConfiguration.html" title="interface in org.w3c.dom">DOMConfiguration</a> getDomConfig()</pre>
<div class="block">
            当调用Document.normalizeDocument()时使用的 
           <code>Document.normalizeDocument()</code> 。 
          </div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="normalizeDocument--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>normalizeDocument</h4> <pre>void normalizeDocument()</pre>
<div class="block">
<span>该方法的作用就好像文档正在进行保存和加载循环，将文档置于“正常”形式。</span>
<span>因此，这种方法更新的替代树<code>EntityReference</code>节点和标准化<code>Text</code>节点，如在方法中定义<code>Node.normalize()</code> 。</span>
<br/>
<span>否则，实际结果取决于在<code>Document.domConfig</code>对象上设置的功能，并管理实际执行的操作。</span>
<span>值得注意的是，这种方法也可以使文档命名空间根据所描述的算法进行良好的组合，检查字符归一化，删除<code>CDATASection</code>节点等。详见<code>DOMConfiguration</code> 。</span>
<pre>  <span>// 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();</span> </pre>
<br/>
<span>生成支持时的突变事件，以反映文档上发生的更改。</span>
<br/>
<span>如果该方法中，在调用期间发生诸如试图更新只读节点错误或<code>Node.nodeName</code>包含无效字符根据在使用中，错误或警告（XML版本<code>DOMError.SEVERITY_ERROR</code>或<code>DOMError.SEVERITY_WARNING</code> ）将使用报告<code>DOMErrorHandler</code>与“错误处理程序”参数关联的对象。</span>
<span>注意，如果实现无法从错误中恢复，则此方法也可能会报告致命错误（ <code>DOMError.SEVERITY_FATAL_ERROR</code> ）。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> <a name="renameNode-org.w3c.dom.Node-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>renameNode</h4> <pre><a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> renameNode(<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a> n,
                <a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
                <a href="../../../java/lang/String.html" title="class in java.lang">String</a> qualifiedName)
         throws <a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></pre>
<div class="block">
<span>重命名类型为<code>ELEMENT_NODE</code>或<code>ATTRIBUTE_NODE</code>的现有节点。</span>
<br/>
<span>在可能的情况下，只需更改给定节点的名称，否则将创建具有指定名称的新节点，并使用新节点替换现有节点，如下所述。</span>
<br/>
<span>如果简单地改变给定节点的名称是不可能的，则执行以下操作：创建新节点，在新节点上注册任何注册的事件侦听器，从该节点删除附加到旧节点的任何用户数据，如果旧节点有父节点，则将其从父节点移除，如果重新命名的节点为<code>Element</code>其属性移动到新节点，新节点将插入旧节点所在的位置要在其父节点的子节点列表中有一个，则附加到旧节点的用户数据被附加到新节点。</span>
<br/>
<span>当重新命名的节点是<code>Element</code>仅移动指定的属性，根据新的元素名称更新来自DTD的默认属性。</span>
<span>此外，实现可以从其他模式更新默认属性。</span>
<span>应用程序应使用<code>Document.normalizeDocument()</code>来保证这些属性是最新的。</span>
<br/>
<span>当要重命名的节点是<code>Attr</code>被附接到一个<code>Element</code> ，首先删除的节点从<code>Element</code>属性地图。</span>
<span>然后，一旦重命名，通过修改现有节点或如上所述创建一个新节点，它将被放回。</span>
<br/>
<span>此外，</span>
<ul>
<li> <span>用户数据事件<code>NODE_RENAMED</code>被触发，</span> </li>
<li> <span>当实现支持特征“MutationNameEvents”，参与这一方法中，每个变异操作触发适当的事件，并且在最后的情况下{ <code>http://www.w3.org/2001/xml-events</code> ， <code>DOMElementNameChanged</code> }或{ <code>http://www.w3.org/2001/xml-events</code> ， <code>DOMAttributeNameChanged</code> }进行烧成。</span> </li>
</ul>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>n</code> - 要重命名的节点。 
           </dd>
<dd>
<code>namespaceURI</code> - 新的命名空间URI。 
           </dd>
<dd>
<code>qualifiedName</code> - 新的合格名称。 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>重命名的节点。</span>
<span>这是指定的节点或创建以替换指定节点的新节点。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../org/w3c/dom/DOMException.html" title="class in org.w3c.dom">DOMException</a></code> - NOT_SUPPORTED_ERR：当指定节点的类型既不是<code>ELEMENT_NODE</code>也不是<code>ATTRIBUTE_NODE</code>时，或者实现不支持重命名文档元素时引发。</span>
<br/>
<span>INVALID_CHARACTER_ERR：如果新的限定名称不是按照规定的使用中的XML版本的XML名称募集<code>Document.xmlVersion</code>属性。</span>
<br/>
<span>WRONG_DOCUMENT_ERR：从与此文档不同的文档创建指定节点时引发。</span>
<br/>
<span>NAMESPACE_ERR：如果<code>qualifiedName</code>是格式错误的限定名，如果<code>qualifiedName</code>有前缀， <code>namespaceURI</code>是<code>null</code> ，或者<code>qualifiedName</code>的前缀是“xml”，namespaceURI与“ <a href="http://www.w3.org/XML/1998/namespace">http://www.w3.org/XML/1998/namespace</a> ”[ <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/">XML Namespaces</a> ] <code>namespaceURI</code>则引发。</span>
<span>还提出，当被重命名的节点是一个属性，如果<code>qualifiedName</code> ，或它的前缀，为“xmlns”和<code>namespaceURI</code>距离“不同<a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> ”。</span>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             DOM 3级 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>