uTools-Manuals/docs/java/javax/xml/bind/annotation/W3CDomHandler.html

<div class="header">
<div class="subTitle">
     javax.xml.bind.annotation 
   </div>
<h2 class="title" title="Class W3CDomHandler">Class W3CDomHandler</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.xml.bind.annotation.W3CDomHandler</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </dt>
<dd>
<span><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="javax.xml.bind.annotation中的接口">DomHandler</a> &lt; <a href="../../../../org/w3c/dom/Element.html" title="界面在org.w3c.dom">Element</a> ， <a href="../../../../javax/xml/transform/dom/DOMResult.html" title="javax.xml.transform.dom中的类">DOMResult</a> &gt;</span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">W3CDomHandler</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="interface in javax.xml.bind.annotation">DomHandler</a>&lt;<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a>,<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a>&gt;</pre>
<div class="block">
<span><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="javax.xml.bind.annotation中的接口"><code>DomHandler</code></a> W3C DOM实现（ <code>org.w3c.dom</code>包）</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         JAXB2.0 
       </dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#W3CDomHandler--">W3CDomHandler</a></span>()</code>
<div class="block">
              默认构造函数。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#W3CDomHandler-javax.xml.parsers.DocumentBuilder-">W3CDomHandler</a></span>(<a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a> builder)</code>
<div class="block">
              构造函数，允许应用程序指定要使用的DOM实现。 
            </div> </td>
</tr>
</tbody>
</table> </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="t4"><span><a href="javascript:show(8);">具体的方法</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="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#createUnmarshaller-javax.xml.bind.ValidationEventHandler-">createUnmarshaller</a></span>(<a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</code>
<div class="block">
<span>当JAXB提供者需要将文档的一部分解组成信息集表示时，它首先调用此方法来创建一个<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a>对象。</span>
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#getBuilder--">getBuilder</a></span>()</code> </td>
</tr>
<tr class="altColor" id="i2">
<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="../../../../javax/xml/bind/annotation/W3CDomHandler.html#getElement-javax.xml.transform.dom.DOMResult-">getElement</a></span>(<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a> r)</code>
<div class="block">
<span>一旦发送到<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a> 。</span>
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#marshal-org.w3c.dom.Element-javax.xml.bind.ValidationEventHandler-">marshal</a></span>(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> element, <a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</code>
<div class="block">
              当JAXB提供程序需要将元素编组为XML时，将调用此方法。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html#setBuilder-javax.xml.parsers.DocumentBuilder-">setBuilder</a></span>(<a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a> builder)</code> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="W3CDomHandler--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>W3CDomHandler</h4> <pre>public W3CDomHandler()</pre>
<div class="block">
<span>默认构造函数。</span>
<span>由JAXB提供者决定要使用哪个DOM实现或如何配置。</span>
</div> </li>
</ul> <a name="W3CDomHandler-javax.xml.parsers.DocumentBuilder-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>W3CDomHandler</h4> <pre>public W3CDomHandler(<a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a> builder)</pre>
<div class="block">
            构造函数，允许应用程序指定要使用的DOM实现。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>builder</code> - 不能为空。</span>
<span>JAXB使用这个<a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="javax.xml.parsers中的类"><code>DocumentBuilder</code></a>来创建一个新的元素。</span>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getBuilder--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBuilder</h4> <pre>public <a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a> getBuilder()</pre> </li>
</ul> <a name="setBuilder-javax.xml.parsers.DocumentBuilder-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBuilder</h4> <pre>public void setBuilder(<a href="../../../../javax/xml/parsers/DocumentBuilder.html" title="class in javax.xml.parsers">DocumentBuilder</a> builder)</pre> </li>
</ul> <a name="createUnmarshaller-javax.xml.bind.ValidationEventHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createUnmarshaller</h4> <pre>public <a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a> createUnmarshaller(<a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#createUnmarshaller-javax.xml.bind.ValidationEventHandler-">DomHandler</a></code>复制</span>
</div>
<div class="block">
<span>当JAXB提供者需要将文档的一部分解组成信息集表示时，它首先调用此方法来创建一个<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a>对象。</span>
<p> <span>然后，JAXB提供者将把XML的一部分发送给给定的结果。</span> <span>这样的部分总是形成一个植根于元素的整个XML文档的子树。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#createUnmarshaller-javax.xml.bind.ValidationEventHandler-">createUnmarshaller</a></code>在界面 
            <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="interface in javax.xml.bind.annotation">DomHandler</a>&lt;<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a>,<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a>&gt;</code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>errorHandler</code> -如果此方法的调用和调用之间发生任何错误<a href="../../../../javax/xml/bind/annotation/DomHandler.html#getElement-ResultT-"><code>DomHandler.getElement(Result)</code></a> ，他们必须报该处理程序。</span>
<span>调用者必须提供一个非空的错误处理程序。</span>
<span><a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口">从此</a>方法创建的<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a>对象可能会保留对此错误处理程序的引用。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果操作失败，则为null。</span>
<span>该错误必须已报告给错误处理程序。</span>
</dd>
</dl> </li>
</ul> <a name="getElement-javax.xml.transform.dom.DOMResult-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElement</h4> <pre>public <a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> getElement(<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a> r)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面： <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#getElement-ResultT-">DomHandler</a></code>复制</span>
</div>
<div class="block">
<span>一旦发送到<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a> 。</span>
<span>此方法由JAXB提供程序调用以获取未编组的元素表示。</span>
<p> <span>该方法的多次调用可能会返回不同的对象。</span> <span>只有当整个子树被馈送到<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a>对象时，才能调用此方法。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#getElement-ResultT-">getElement</a></code>在界面 
            <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="interface in javax.xml.bind.annotation">DomHandler</a>&lt;<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a>,<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a>&gt;</code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>r</code> -该<a href="../../../../javax/xml/transform/Result.html" title="javax.xml.transform中的接口"><code>Result</code></a>通过创建的对象<a href="../../../../javax/xml/bind/annotation/DomHandler.html#createUnmarshaller-javax.xml.bind.ValidationEventHandler-"><code>DomHandler.createUnmarshaller(ValidationEventHandler)</code></a> 。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果操作失败，则为null。</span>
<span>该错误必须已报告给错误处理程序。</span>
</dd>
</dl> </li>
</ul> <a name="marshal-org.w3c.dom.Element-javax.xml.bind.ValidationEventHandler-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>marshal</h4> <pre>public <a href="../../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> marshal(<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a> element,
                      <a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</pre>
<div class="block">
<span class="descfrmTypeLabel">说明从界面复制： <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#marshal-ElementT-javax.xml.bind.ValidationEventHandler-">DomHandler</a></code></span>
</div>
<div class="block">
<span>当JAXB提供程序需要将元素编组为XML时，将调用此方法。</span>
<p> <span>如果非空，则返回的<a href="../../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>Source</code></a>必须包含一个以一个元素为根的整个文档，然后将其编入JAXB提供程序编组的更大的文档。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/xml/bind/annotation/DomHandler.html#marshal-ElementT-javax.xml.bind.ValidationEventHandler-">marshal</a></code>在界面 
            <code><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="interface in javax.xml.bind.annotation">DomHandler</a>&lt;<a href="../../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a>,<a href="../../../../javax/xml/transform/dom/DOMResult.html" title="class in javax.xml.transform.dom">DOMResult</a>&gt;</code>
</dd>
<dd>
<span><code>errorHandler</code> - 接收在将元素转换为<a href="../../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>Source</code></a>的过程中发生的任何错误。</span>
<span>调用者必须提供一个非空的错误处理程序。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>如果有错误，则为null。</span>
<span>该错误应该已经被报告给处理程序。</span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>