JavaTM Platform
Standard Ed. 6

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 已经初始化

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策