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

<div class="header">
<div class="subTitle">
     javax.xml.bind.annotation 
   </div>
<h2 class="title" title="Interface DomHandler">Interface DomHandler&lt;ElementT,ResultT extends <a href="../../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a>&gt;</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../../javax/xml/bind/annotation/W3CDomHandler.html" title="javax.xml.bind.annotation中的类">W3CDomHandler</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">DomHandler&lt;ElementT,ResultT extends <a href="../../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a>&gt;</span></pre>
<div class="block">
<span>将元素（及其后代）从/转换为DOM（或类似的）表示形式。</span>
<p> <span>该接口的实现将与<a href="../../../../javax/xml/bind/annotation/XmlAnyElement.html" title="javax.xml.bind.annotation中的注释"><code>XmlAnyElement</code></a>注释一起使用，以将XML的元素映射到信息集的表示形式，如W3C DOM。</span> </p>
<p> <span>实现隐藏了XML的一部分如何转换成这种类似DOM的表示形式，允许JAXB提供者使用任意这样的库。</span> </p>
<p> <span>此接口旨在由库编写器实现并由JAXB提供程序使用。</span> <span>这些方法都不是从应用程序中调用的。</span> </p>
</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">
<!-- ========== 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="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ResultT</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/DomHandler.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/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ElementT</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/DomHandler.html#getElement-ResultT-">getElement</a></span>(<a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ResultT</a> rt)</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="altColor" id="i2">
<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/DomHandler.html#marshal-ElementT-javax.xml.bind.ValidationEventHandler-">marshal</a></span>(<a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ElementT</a> n, <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>
</tbody>
</table> </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="createUnmarshaller-javax.xml.bind.ValidationEventHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createUnmarshaller</h4> <pre><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ResultT</a> createUnmarshaller(<a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</pre>
<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="paramLabel">参数</span>
</dt>
<dd>
<span><code>errorHandler</code> -如果此方法的调用和调用之间发生任何错误<a href="../../../../javax/xml/bind/annotation/DomHandler.html#getElement-ResultT-"><code>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.Result-">
<!-- --> </a><a name="getElement-ResultT-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElement</h4> <pre><a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ElementT</a> getElement(<a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ResultT</a> rt)</pre>
<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="paramLabel">参数</span>
</dt>
<dd>
<span><code>rt</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>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-java.lang.Object-javax.xml.bind.ValidationEventHandler-">
<!-- --> </a><a name="marshal-ElementT-javax.xml.bind.ValidationEventHandler-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>marshal</h4> <pre><a href="../../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> marshal(<a href="../../../../javax/xml/bind/annotation/DomHandler.html" title="type parameter in DomHandler">ElementT</a> n,
               <a href="../../../../javax/xml/bind/ValidationEventHandler.html" title="interface in javax.xml.bind">ValidationEventHandler</a> errorHandler)</pre>
<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="paramLabel">参数</span>
</dt>
<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>