uTools-Manuals/docs/java/javax/xml/bind/ValidationEventHandler.html

<div class="header">
<div class="subTitle">
     javax.xml.bind 
   </div>
<h2 class="title" title="Interface ValidationEventHandler">Interface ValidationEventHandler</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        所有已知实现类：
       </dt>
<dd>
<span><a href="../../../javax/xml/bind/helpers/DefaultValidationEventHandler.html" title="javax.xml.bind.helpers中的类">DefaultValidationEventHandler</a> ， <a href="../../../javax/xml/bind/util/ValidationEventCollector.html" title="javax.xml.bind.util中的类">ValidationEventCollector</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">ValidationEventHandler</span></pre>
<div class="block">
<span>用于验证错误的基本事件处理程序接口。</span>
<p> <span>如果应用程序需要实现自定义的事件处理，它必须实现此接口，然后用要么注册它<a href="../../../javax/xml/bind/Unmarshaller.html#setEventHandler-javax.xml.bind.ValidationEventHandler-"><code>Unmarshaller</code></a> ，该<a href="../../../javax/xml/bind/Validator.html#setEventHandler-javax.xml.bind.ValidationEventHandler-"><code>Validator</code></a> ，或<a href="../../../javax/xml/bind/Marshaller.html#setEventHandler-javax.xml.bind.ValidationEventHandler-"><code>Marshaller</code></a> 。</span> <span>然后，JAXB提供程序将向这些事件处理程序报告解密，组织和验证操作期间遇到的验证错误和警告。</span> </p>
<p> <span>如果<tt>handleEvent</tt>方法抛出未经检查的运行时异常，则JAXB提供程序必须将该方法视为返回false，有效地终止当前正在进行的任何操作（unmarshal，validate或marshal）。</span> </p>
<p> <span>修改事件处理程序中的Java内容树不受规范的限制，并可能导致意外的行为。</span> </p>
<p> <span>遇到致命错误后，未能从<tt>handleEvent</tt>方法返回虚假的内容<tt>未被</tt>规范定义，可能会导致意外的行为。</span> </p>
<p> <span><b>默认事件处理程序</b></span> </p>
<blockquote>
<span>See: <a href="Validator.html#defaulthandler">Validator javadocs</a></span>
</blockquote>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         JAXB1.0 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/xml/bind/Unmarshaller.html" title="javax.xml.bind中的接口"><code>Unmarshaller</code></a> ， <a href="../../../javax/xml/bind/Validator.html" title="javax.xml.bind中的接口"><code>Validator</code></a> ， <a href="../../../javax/xml/bind/Marshaller.html" title="javax.xml.bind中的接口"><code>Marshaller</code></a> ， <a href="../../../javax/xml/bind/ValidationEvent.html" title="javax.xml.bind中的接口"><code>ValidationEvent</code></a> ， <a href="../../../javax/xml/bind/util/ValidationEventCollector.html" title="javax.xml.bind.util中的类"><code>ValidationEventCollector</code></a></span>
</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>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/bind/ValidationEventHandler.html#handleEvent-javax.xml.bind.ValidationEvent-">handleEvent</a></span>(<a href="../../../javax/xml/bind/ValidationEvent.html" title="interface in javax.xml.bind">ValidationEvent</a> event)</code>
<div class="block">
              接收验证警告或错误的通知。 
            </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="handleEvent-javax.xml.bind.ValidationEvent-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>handleEvent</h4> <pre>boolean handleEvent(<a href="../../../javax/xml/bind/ValidationEvent.html" title="interface in javax.xml.bind">ValidationEvent</a> event)</pre>
<div class="block">
<span>接收验证警告或错误的通知。</span>
<span>ValidationEvent将在<a href="../../../javax/xml/bind/ValidationEventLocator.html" title="javax.xml.bind中的接口">其中</a>嵌入一个<a href="../../../javax/xml/bind/ValidationEventLocator.html" title="javax.xml.bind中的接口"><code>ValidationEventLocator</code></a> ，指示发生错误或警告的位置。</span>
<p> <span>如果从该方法抛出未检查的运行时异常，则JAXB提供程序将将其视为返回false并中断当前解组，验证或组织操作。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>event</code> - 封装的验证事件信息。</span>
<span>如果此参数为空，则为提供者错误。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             如果JAXB提供者应该尝试继续当前的解组，验证或编组操作处理此警告/错误，错误后，如果提供者应该用适当 
            <tt><tt>UnmarshalException，ValidationException，</tt></tt>或 
            <tt>MarshalException</tt>终止当前的操作正确的。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果事件对象为空。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>