Module  java.xml.ws
软件包  javax.xml.soap

Class SOAPException

  • All Implemented Interfaces:
    Serializable 

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

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

    从以下版本开始：
    1.6
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • SOAPException

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

      • SOAPException

        public SOAPException​(String reason)
        构造一个 SOAPException对象与给定的 String作为抛出异常的原因。
        参数
        reason - 引起异常的描述

      • SOAPException

        public SOAPException​(String reason,
                     Throwable cause)
        构造一个 SOAPException对象，给定的 String作为引发异常的原因，给定的 Throwable对象作为嵌入式异常。
        参数
        reason - 引起异常的描述
        cause -一个 Throwable对象，它是被嵌入在该 SOAPException对象

      • SOAPException

        public SOAPException​(Throwable cause)
        构造一个使用给定的 SOAPException对象初始化的 Throwable对象。
        参数
        cause -一个 Throwable对象，它是被嵌入在该 SOAPException对象

    • 方法详细信息

      • 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对象初始化此SOAPException对象的cause字段。

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

        重写：
        initCause在 Throwable
        参数
        cause -在Throwable导致此对象SOAPException对象被抛出。 保存此参数的值，以便以后通过getCause()方法进行检索。 允许一个null值，并表示原因不存在或未知。
        结果
        引用这个 SOAPException例子
        异常
        IllegalArgumentException - 如果cause是这个Throwable对象。 （A Throwable对象不能是自己的原因。）
        IllegalStateException - if the cause for this SOAPException object has already been initialized