uTools-Manuals/docs/java/javax/xml/soap/SOAPException.html

325 lines
16 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.xml.soap
</div>
<h2 class="title" title="Class SOAPException">Class SOAPException</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>javax.xml.soap.SOAPException</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">SOAPException</span>
extends <a href="../../../java/lang/Exception.html" title="class in java.lang">异常</a></pre>
<div class="block">
<span>发生SOAP异常发生的异常。</span>
<span><code>SOAPException</code>对象可能包含一个<code>String</code> ,它给出了<code>String</code>的原因,一个嵌入的<code>Throwable</code>对象,或者两者。</span>
<span>该类提供检索原因消息和检索嵌入式<code>Throwable</code>对象的方法。</span>
<p> <span>抛出<code>SOAPException</code>对象的典型原因是诸如难以设置标题,无法发送消息,无法与提供商建立连接的问题。</span> <span>嵌入<code>Throwable</code>对象的原因包括诸如输入/输出错误或解析问题之类的问题,例如解析头部的错误。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../serialized-form.html#javax.xml.soap.SOAPException">Serialized Form</a>
</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/soap/SOAPException.html#SOAPException--">SOAPException</a></span>()</code>
<div class="block">
构造一个
<code>SOAPException</code>对象,没有任何理由或嵌入
<code>Throwable</code>对象。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPException.html#SOAPException-java.lang.String-">SOAPException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> reason)</code>
<div class="block">
构造一个
<code>SOAPException</code>对象与给定的
<code>String</code>作为抛出异常的原因。
</div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPException.html#SOAPException-java.lang.String-java.lang.Throwable-">SOAPException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> reason, <a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</code>
<div class="block">
构造一个
<code>SOAPException</code>对象,给定的
<code>String</code>作为引发异常的原因,给定的
<code>Throwable</code>对象作为嵌入式异常。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPException.html#SOAPException-java.lang.Throwable-">SOAPException</a></span>(<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</code>
<div class="block">
构造一个
<code>SOAPException</code>给定初始化的对象
<code>Throwable</code>对象。
</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="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPException.html#getCause--">getCause</a></span>()</code>
<div class="block">
返回
<code>Throwable</code>嵌入在这个对象
<code>SOAPException</code> (如果有)。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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="../../../javax/xml/soap/SOAPException.html#getMessage--">getMessage</a></span>()</code>
<div class="block">
返回此
<code>SOAPException</code>对象的详细消息。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPException.html#initCause-java.lang.Throwable-">initCause</a></span>(<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</code>
<div class="block">
使用给定的
<code>Throwable</code>对象
<code>SOAPException</code>对象的
<code>cause</code>字段。
</div> </td>
</tr>
</tbody>
</table>
<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#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>, <a href="../../../java/lang/Throwable.html#toString--">toString</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="SOAPException--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SOAPException</h4> <pre>public SOAPException()</pre>
<div class="block">
构造一个
<code>SOAPException</code>对象,没有任何理由或嵌入
<code>Throwable</code>对象。
</div> </li>
</ul> <a name="SOAPException-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SOAPException</h4> <pre>public SOAPException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> reason)</pre>
<div class="block">
使用给定的
<code>String</code>构造一个
<code>SOAPException</code>对象,作为抛出异常的原因。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reason</code> - 引发异常的描述
</dd>
</dl> </li>
</ul> <a name="SOAPException-java.lang.String-java.lang.Throwable-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SOAPException</h4> <pre>public SOAPException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> reason,
<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</pre>
<div class="block">
使用给定的
<code>String</code>构造一个
<code>SOAPException</code>对象,作为引发异常的原因,给定的
<code>Throwable</code>对象作为嵌入式异常。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reason</code> - 引起异常的描述
</dd>
<dd>
<code>cause</code> -一个
<code>Throwable</code>对象,它是被嵌入在该
<code>SOAPException</code>对象
</dd>
</dl> </li>
</ul> <a name="SOAPException-java.lang.Throwable-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>SOAPException</h4> <pre>public SOAPException(<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</pre>
<div class="block">
构造一个
<code>SOAPException</code>对象,使用给定的
<code>Throwable</code>对象初始化。
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getMessage--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMessage</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getMessage()</pre>
<div class="block">
<span>返回此<code>SOAPException</code>对象的详细消息。</span>
<p> <span>如果有一个嵌入式的<code>Throwable</code>对象,如果<code>SOAPException</code>对象没有自己的详细信息,这个方法将从嵌入的<code>Throwable</code>对象返回详细信息。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../java/lang/Throwable.html#getMessage--">getMessage</a></code>
<code><a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>SOAPException</code>的错误或警告消息,或者如果没有,嵌入的消息
<code>Throwable</code>对象,如果有一个
</dd>
</dl> </li>
</ul> <a name="getCause--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCause</h4> <pre>public <a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> getCause()</pre>
<div class="block">
<span>返回<code>Throwable</code>对象嵌入到这个<code>SOAPException</code>如果有的话。</span>
<span>否则,此方法返回<code>null</code></span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../java/lang/Throwable.html#getCause--">getCause</a></code>
<code><a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
嵌入式
<code>Throwable</code>对象或
<code>null</code>如果没有
</dd>
</dl> </li>
</ul> <a name="initCause-java.lang.Throwable-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>initCause</h4> <pre>public <a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> initCause(<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a> cause)</pre>
<div class="block">
<span>使用给定的<code>Throwable</code>对象<code>Throwable</code><code>SOAPException</code>对象的<code>cause</code>字段。</span>
<p> <span>这个方法最多可以调用一次。</span> <span>它通常从构造函数中调用,或在构造函数返回一个新的<code>SOAPException</code>对象之后<code>SOAPException</code>调用。</span> <span>如果这个<code>SOAPException</code>对象是使用构造函数<a href="../../../javax/xml/soap/SOAPException.html#SOAPException-java.lang.Throwable-"><code>SOAPException(Throwable)</code></a><a href="../../../javax/xml/soap/SOAPException.html#SOAPException-java.lang.String-java.lang.Throwable-"><code>SOAPException(String,Throwable)</code>创建的</a> ,这意味着它的<code>cause</code>字段已经有一个值,这个方法不能被调用一次。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../java/lang/Throwable.html#initCause-java.lang.Throwable-">initCause</a></code>
<code><a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>cause</code> -在<code>Throwable</code>导致此对象<code>SOAPException</code>对象被抛出。</span>
<span>此参数的值被保存以供稍后通过<a href="../../../javax/xml/soap/SOAPException.html#getCause--"><code>getCause()</code>检索</a></span>
<span><tt>允许null</tt>值,表示原因不存在或未知。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
引用这个
<code>SOAPException</code>实例
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果<code>cause</code>是这个<code>Throwable</code>对象。</span>
<span>A <code>Throwable</code>对象不能是自己的原因。)</span>
</dd>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果此
<code>SOAPException</code>对象的原因已被初始化
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>