uTools-Manuals/docs/java/org/xml/sax/SAXParseException.html

<div class="header">
<div class="subTitle">
     compact2, compact3 
   </div>
<div class="subTitle">
     org.xml.sax 
   </div>
<h2 class="title" title="Class SAXParseException">Class SAXParseException</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><a href="../../../java/lang/Throwable.html" title="class in java.lang">java.lang.Throwable</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/lang/Exception.html" title="class in java.lang">java.lang.Exception</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">org.xml.sax.SAXException</a></li>
<li>
<ul class="inheritance">
<li>org.xml.sax.SAXParseException</li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Implemented Interfaces: 
       </dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">SAXParseException</span>
extends <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></pre>
<div class="block">
<span>封装XML解析错误或警告。</span>
<blockquote>
<span><em>This module, both source code and documentation, is in the Public Domain, and comes with <strong>NO WARRANTY</strong>.</em> See <a href="http://www.saxproject.org">http://www.saxproject.org</a> for further information.</span>
</blockquote>
<p> <span>此异常可能包括用于定位原始XML文档中的错误的信息，就像来自<a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a>对象一样。</span> <span>请注意，尽管应用程序将收到一个SAXParseException作为<a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a>接口中处理程序的参数，但该应用程序实际上并不需要抛出该异常;</span> <span>相反，它可以简单地读取其中的信息，并采取不同的动作。</span> </p>
<p> <span>由于这个例外是的子类<a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a> ，它继承了包装其他异常的能力。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         SAX 1.0 
       </dd>
<dt>
<span class="simpleTagLabel">Version:</span>
</dt>
<dd>
         2.0.1（sax2r2） 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a> ， <a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a> ， <a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> ， <a href="../../../serialized-form.html#org.xml.sax.SAXParseException">Serialized Form</a></span>
</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="../../../org/xml/sax/SAXParseException.html#SAXParseException-java.lang.String-org.xml.sax.Locator-">SAXParseException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message, <a href="../../../org/xml/sax/Locator.html" title="interface in org.xml.sax">Locator</a> locator)</code>
<div class="block">
              从消息和定位器创建新的SAXParseException。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/xml/sax/SAXParseException.html#SAXParseException-java.lang.String-org.xml.sax.Locator-java.lang.Exception-">SAXParseException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message, <a href="../../../org/xml/sax/Locator.html" title="interface in org.xml.sax">Locator</a> locator, <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a> e)</code>
<div class="block">
              在SAXParseException中包装一个现有的异常。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/xml/sax/SAXParseException.html#SAXParseException-java.lang.String-java.lang.String-java.lang.String-int-int-">SAXParseException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId, int lineNumber, int columnNumber)</code>
<div class="block">
              创建一个新的SAXParseException。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../org/xml/sax/SAXParseException.html#SAXParseException-java.lang.String-java.lang.String-java.lang.String-int-int-java.lang.Exception-">SAXParseException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId, int lineNumber, int columnNumber, <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a> e)</code>
<div class="block">
              创建一个新的SAXParseException与嵌入式异常。 
            </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>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/SAXParseException.html#getColumnNumber--">getColumnNumber</a></span>()</code>
<div class="block">
              发生异常的文本结尾的列号。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../org/xml/sax/SAXParseException.html#getLineNumber--">getLineNumber</a></span>()</code>
<div class="block">
              出现异常的文本结尾的行号。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<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/xml/sax/SAXParseException.html#getPublicId--">getPublicId</a></span>()</code>
<div class="block">
              获取发生异常的实体的公共标识符。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<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/xml/sax/SAXParseException.html#getSystemId--">getSystemId</a></span>()</code>
<div class="block">
              获取发生异常的实体的系统标识符。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<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/xml/sax/SAXParseException.html#toString--">toString</a></span>()</code>
<div class="block">
              覆盖toString以提供更详细的错误消息。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.xml.sax.SAXException">
<!-- --> </a> <h3>Methods inherited from class org.xml.sax.<a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></h3> <code><a href="../../../org/xml/sax/SAXException.html#getCause--">getCause</a>, <a href="../../../org/xml/sax/SAXException.html#getException--">getException</a>, <a href="../../../org/xml/sax/SAXException.html#getMessage--">getMessage</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Throwable">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></h3> <code><a href="../../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-">addSuppressed</a>, <a href="../../../java/lang/Throwable.html#fillInStackTrace--">fillInStackTrace</a>, <a href="../../../java/lang/Throwable.html#getLocalizedMessage--">getLocalizedMessage</a>, <a href="../../../java/lang/Throwable.html#getStackTrace--">getStackTrace</a>, <a href="../../../java/lang/Throwable.html#getSuppressed--">getSuppressed</a>, <a href="../../../java/lang/Throwable.html#initCause-java.lang.Throwable-">initCause</a>, <a href="../../../java/lang/Throwable.html#printStackTrace--">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-">setStackTrace</a></code></li>
</ul>
<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#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="SAXParseException-java.lang.String-org.xml.sax.Locator-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SAXParseException</h4> <pre>public SAXParseException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message,
                         <a href="../../../org/xml/sax/Locator.html" title="interface in org.xml.sax">Locator</a> locator)</pre>
<div class="block">
<span>从消息和定位器创建新的SAXParseException。</span>
<p> <span>当应用程序在<a href="../../../org/xml/sax/ContentHandler.html" title="org.xml.sax中的接口"><code>ContentHandler</code></a>回调中创建自己的异常时，此构造函数特别有用。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>message</code> - 错误或警告信息。 
           </dd>
<dd>
<code>locator</code> - 错误或警告的定位器对象（可能为null）。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a></span>
</dd>
</dl> </li>
</ul> <a name="SAXParseException-java.lang.String-org.xml.sax.Locator-java.lang.Exception-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SAXParseException</h4> <pre>public SAXParseException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message,
                         <a href="../../../org/xml/sax/Locator.html" title="interface in org.xml.sax">Locator</a> locator,
                         <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a> e)</pre>
<div class="block">
<span>在SAXParseException中包装一个现有的异常。</span>
<p> <span>当应用程序在<a href="../../../org/xml/sax/ContentHandler.html" title="org.xml.sax中的接口"><code>ContentHandler</code></a>回调中创建自己的异常时，此构造函数特别有用，并且需要包装不是<a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a>的子类的<a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类">现有异常</a> 。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>message</code> - 错误或警告消息，或null，以使用嵌入式异常中的消息。 
           </dd>
<dd>
<code>locator</code> - 错误或警告的定位器对象（可能为null）。 
           </dd>
<dd>
<code>e</code> - 任何异常。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a></span>
</dd>
</dl> </li>
</ul> <a name="SAXParseException-java.lang.String-java.lang.String-java.lang.String-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SAXParseException</h4> <pre>public SAXParseException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message,
                         <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId,
                         <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId,
                         int lineNumber,
                         int columnNumber)</pre>
<div class="block">
<span>创建一个新的SAXParseException。</span>
<p> <span>此构造函数对解析器作者最有用。</span> </p>
<p> <span>除消息之外的所有参数如同由<a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a>提供的<a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口">一样</a> 。</span> <span>例如，如果系统标识符是URL（包括相对文件名），则调用者必须在创建异常之前完全解析它。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>message</code> - 错误或警告信息。 
           </dd>
<dd>
<code>publicId</code> - 生成错误或警告的实体的公共标识符。 
           </dd>
<dd>
<code>systemId</code> - 生成错误或警告的实体的系统标识符。 
           </dd>
<dd>
<code>lineNumber</code> - 导致错误或警告的文本结尾的行号。 
           </dd>
<dd>
<code>columnNumber</code> - 导致错误或警告的文本结尾的列号。 
           </dd>
</dl> </li>
</ul> <a name="SAXParseException-java.lang.String-java.lang.String-java.lang.String-int-int-java.lang.Exception-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SAXParseException</h4> <pre>public SAXParseException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> message,
                         <a href="../../../java/lang/String.html" title="class in java.lang">String</a> publicId,
                         <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId,
                         int lineNumber,
                         int columnNumber,
                         <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a> e)</pre>
<div class="block">
<span>创建一个新的SAXParseException与嵌入式异常。</span>
<p> <span>此构造函数对于需要包装不是<a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类"><code>SAXException</code></a>的子类的<a href="../../../org/xml/sax/SAXException.html" title="在org.xml.sax中的类">异常的</a>解析器作者最有用。</span> </p>
<p> <span>除消息和异常的所有参数均如同它们由一个提供<a href="../../../org/xml/sax/Locator.html" title="org.xml.sax中的接口"><code>Locator</code></a> 。</span> <span>例如，如果系统标识符是URL（包括相对文件名），则调用者必须在创建异常之前完全解析它。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>message</code> - 错误或警告消息，或使用来自嵌入式异常的消息为null。 
           </dd>
<dd>
<code>publicId</code> - 生成错误或警告的实体的公共标识符。 
           </dd>
<dd>
<code>systemId</code> - 生成错误或警告的实体的系统标识符。 
           </dd>
<dd>
<code>lineNumber</code> - 导致错误或警告的文本结尾的行号。 
           </dd>
<dd>
<code>columnNumber</code> - 导致错误或警告的文本结尾的列号。 
           </dd>
<dd>
<code>e</code> - 嵌入这一个的另一个例外。 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getPublicId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPublicId</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPublicId()</pre>
<div class="block">
            获取发生异常的实体的公共标识符。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             包含公共标识符的字符串，如果没有可用，则为null。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/Locator.html#getPublicId--"><code>Locator.getPublicId()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSystemId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSystemId</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getSystemId()</pre>
<div class="block">
<span>获取发生异常的实体的系统标识符。</span>
<p> <span>如果系统标识符是一个URL，它将被完全解析。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             包含系统标识符的字符串，如果没有可用，则为空。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/Locator.html#getSystemId--"><code>Locator.getSystemId()</code></a>
</dd>
</dl> </li>
</ul> <a name="getLineNumber--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLineNumber</h4> <pre>public int getLineNumber()</pre>
<div class="block">
<span>出现异常的文本结尾的行号。</span>
<p> <span>第一行是第1行。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             表示行号的整数，如果没有可用，则为-1。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/Locator.html#getLineNumber--"><code>Locator.getLineNumber()</code></a>
</dd>
</dl> </li>
</ul> <a name="getColumnNumber--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getColumnNumber</h4> <pre>public int getColumnNumber()</pre>
<div class="block">
<span>发生异常的文本结尾的列号。</span>
<p> <span>一行中的第一列是位置1。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             表示列号的整数，如果没有可用，则为-1。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../org/xml/sax/Locator.html#getColumnNumber--"><code>Locator.getColumnNumber()</code></a>
</dd>
</dl> </li>
</ul> <a name="toString--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
<div class="block">
            覆盖toString以提供更详细的错误消息。 
          </div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../../org/xml/sax/SAXException.html#toString--">toString</a></code>在类别 
            <code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             此异常的字符串表示形式。 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>