javax.xml.soap
類別 SOAPException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.soap.SOAPException

所有已實作的介面：

Serializable

public class SOAPException
extends Exception

當發生 SOAP 異常時，拋出此異常。SOAPException 物件可以包含給出異常原因的 String 或嵌入的 Throwable 物件，也可以同時包含兩者。此類別提供檢索原因訊息的方法和檢索嵌入 Throwable 物件的方法。

拋出 SOAPException 物件的通常原因是難以設置頭、無法發送訊息以及無法獲取與提供者的連接之類別的問題。嵌入 Throwable 物件的原因包括諸如輸入/輸出錯誤之類別的問題或解析問題，如解析頭時出現錯誤。

另請參見：

序列化表格

建構子摘要

SOAPException()
建構不帶原因或內置 Throwable 物件的 SOAPException 物件。

SOAPException(String reason)
建構一個 SOAPException 物件，使用給定 String 作為拋出異常的原因。

SOAPException(String reason, Throwable cause)
建構一個 SOAPException 物件，使用給定 String 作為拋出異常的原因，使用給定 Throwable 物件作為嵌入的異常。

SOAPException(Throwable cause)
建構使用給定 Throwable 物件初始化的 SOAPException 物件。

方法摘要

Throwable	getCause() 返回此 SOAPException 中嵌入的 Throwable 物件（如果有）。
String	getMessage() 返回此 SOAPException 物件的詳細訊息。
Throwable	initCause(Throwable cause) 使用給定的 Throwable 物件初始化此 SOAPException 物件的 cause 欄位。

從類別 java.lang.Throwable 繼承的方法

fillInStackTrace, getLocalizedMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

SOAPException

public SOAPException()

建構不帶原因或內置 Throwable 物件的 SOAPException 物件。

SOAPException

public SOAPException(String reason)

建構一個 SOAPException 物件，使用給定 String 作為拋出異常的原因。

參數：

reason - 對導致異常的原因的描述

SOAPException

public SOAPException(String reason,
                     Throwable cause)

建構一個 SOAPException 物件，使用給定 String 作為拋出異常的原因，使用給定 Throwable 物件作為嵌入的異常。

參數：

reason - 對導致異常的原因的描述

cause - 要嵌入此 SOAPException 物件的 Throwable 物件

SOAPException

public SOAPException(Throwable cause)

建構使用給定 Throwable 物件初始化的 SOAPException 物件。

方法詳細資訊

getMessage

public String getMessage()

返回此 SOAPException 物件的詳細訊息。

如果有嵌入的 Throwable 物件，並且 SOAPException 物件沒有自己的詳細訊息，則此方法將返回嵌入的 Throwable 物件的詳細訊息。

覆寫：

類別 Throwable 中的 getMessage

返回：

此 SOAPException 的錯誤或警告訊息，如果沒有此類別訊息，則返回嵌入的 Throwable 物件（如果有）的訊息

getCause

public Throwable getCause()

返回此 SOAPException 中嵌入的 Throwable 物件（如果有）。否則，此方法返回 null。

覆寫：

類別 Throwable 中的 getCause

返回：

嵌入的 Throwable 物件，如果沒有此類別物件，則返回 null

initCause

public Throwable initCause(Throwable cause)

使用給定的 Throwable 物件初始化此 SOAPException 物件的 cause 欄位。

此方法至多可以調用一次。此方法通常從建構子中調用，或者在建構子返回新的 SOAPException 物件後立即調用。如果此 SOAPException 物件是使用建構子 SOAPException(Throwable) 或 SOAPException(String,Throwable) 創建的，則意味著它的 cause 欄位已經有一個值，此方法一次也不能調用。

覆寫：

類別 Throwable 中的 initCause

參數：

cause - 導致拋出此 SOAPException 物件的 Throwable 物件。保存此參數的值，以便以後通過 getCause() 方法檢索它。此參數值可以為 null，指示 cause 不存在或是未知的。

返回：

對此 SOAPException 實例的參考

拋出：

IllegalArgumentException - 如果 cause 是此 Throwable 物件。（Throwable 物件不能是它自己的 cause。）

IllegalStateException - 如果此 SOAPException 物件的 cause 已經初始化