javax.xml.soap

Class SOAPException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.xml.soap.SOAPException

All Implemented Interfaces:

Serializable

public class SOAPException
extends 异常

发生SOAP异常发生的异常。 SOAPException对象可能包含一个String ，它给出了String的原因，一个嵌入的Throwable对象，或者两者。 该类提供检索原因消息和检索嵌入式Throwable对象的方法。

抛出SOAPException对象的典型原因是诸如难以设置标题，无法发送消息，无法与提供商建立连接的问题。 嵌入Throwable对象的原因包括诸如输入/输出错误或解析问题之类的问题，例如解析头部的错误。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
SOAPException() 构造一个 SOAPException对象，没有任何理由或嵌入 Throwable对象。
SOAPException(String reason) 构造一个 SOAPException对象与给定的 String作为抛出异常的原因。
SOAPException(String reason, Throwable cause) 构造一个 SOAPException对象，给定的 String作为引发异常的原因，给定的 Throwable对象作为嵌入式异常。
SOAPException(Throwable cause) 构造一个 SOAPException给定初始化的对象 Throwable对象。

方法摘要

Modifier and Type	Method and Description
Throwable	getCause() 返回 Throwable嵌入在这个对象 SOAPException （如果有）。
String	getMessage() 返回此 SOAPException对象的详细消息。
Throwable	initCause(Throwable cause) 使用给定的 Throwable对象 SOAPException对象的 cause字段。

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

SOAPException

public SOAPException()

构造一个 SOAPException对象，没有任何理由或嵌入 Throwable对象。

SOAPException

public SOAPException(String reason)

使用给定的 String构造一个 SOAPException对象，作为抛出异常的原因。

参数

reason - 引发异常的描述

SOAPException

public SOAPException(String reason,
                     Throwable cause)

使用给定的 String构造一个 SOAPException对象，作为引发异常的原因，给定的 Throwable对象作为嵌入式异常。

参数

reason - 引起异常的描述

cause -一个 Throwable对象，它是被嵌入在该 SOAPException对象

SOAPException

public SOAPException(Throwable cause)

构造一个 SOAPException对象，使用给定的 Throwable对象初始化。

方法详细信息

getMessage

public String getMessage()

返回此SOAPException对象的详细消息。

如果有一个嵌入式的Throwable对象，如果SOAPException对象没有自己的详细信息，这个方法将从嵌入的Throwable对象返回详细信息。

重写：

getMessage在 Throwable

结果

该 SOAPException的错误或警告消息，或者如果没有，嵌入的消息 Throwable对象，如果有一个

getCause

public Throwable getCause()

返回Throwable对象嵌入到这个SOAPException如果有的话。 否则，此方法返回null 。

重写：

getCause在 Throwable

结果

嵌入式 Throwable对象或 null如果没有

initCause

public Throwable initCause(Throwable cause)

使用给定的Throwable对象Throwable此SOAPException对象的cause字段。

这个方法最多可以调用一次。 它通常从构造函数中调用，或在构造函数返回一个新的SOAPException对象之后SOAPException调用。 如果这个SOAPException对象是使用构造函数SOAPException(Throwable)或SOAPException(String,Throwable)创建的 ，这意味着它的cause字段已经有一个值，这个方法不能被调用一次。

重写：

initCause在 Throwable

参数

cause -在Throwable导致此对象SOAPException对象被抛出。 此参数的值被保存以供稍后通过getCause()检索 。 允许null值，表示原因不存在或未知。

结果

引用这个 SOAPException实例

异常

IllegalArgumentException - 如果cause是这个Throwable对象。 （A Throwable对象不能是自己的原因。）

IllegalStateException - 如果此 SOAPException对象的原因已被初始化