Class SOAPException

Constructor Detail

• SOAPException

  public SOAPException()

  Constructs a SOAPException object with no reason or embedded Throwable object.

• SOAPException

  public SOAPException(String reason)

  Constructs a SOAPException object with the given String as the reason for the exception being thrown.

  Parameters:

  reason - a description of what caused the exception

• SOAPException

  public SOAPException(String reason,
               Throwable cause)

  Constructs a SOAPException object with the given String as the reason for the exception being thrown and the given Throwable object as an embedded exception.

  Parameters:

  reason - a description of what caused the exception

  cause - a Throwable object that is to be embedded in this SOAPException object

• SOAPException

  public SOAPException(Throwable cause)

  Constructs a SOAPException object initialized with the given Throwable object.

Method Detail

• getMessage

  public String getMessage()

  Returns the detail message for this SOAPException object.

  If there is an embedded Throwable object, and if the SOAPException object has no detail message of its own, this method will return the detail message from the embedded Throwable object.

  Overrides:

  getMessage in class Throwable

  Returns:

  the error or warning message for this SOAPException or, if it has none, the message of the embedded Throwable object, if there is one

• getCause

  public Throwable getCause()

  Returns the Throwable object embedded in this SOAPException if there is one. Otherwise, this method returns null.

  Overrides:

  getCause in class Throwable

  Returns:

  the embedded Throwable object or null if there is none

• initCause

  public Throwable initCause(Throwable cause)

  Initializes the cause field of this SOAPException object with the given Throwable object.

  This method can be called at most once. It is generally called from within the constructor or immediately after the constructor has returned a new SOAPException object. If this SOAPException object was created with the constructor SOAPException(Throwable) or SOAPException(String,Throwable), meaning that its cause field already has a value, this method cannot be called even once.

  Overrides:

  initCause in class Throwable

  Parameters:

  cause - the Throwable object that caused this SOAPException object to be thrown. The value of this parameter is saved for later retrieval by the getCause() method. A null value is permitted and indicates that the cause is nonexistent or unknown.

  Returns:

  a reference to this SOAPException instance

  Throws:

  IllegalArgumentException - if cause is this Throwable object. (A Throwable object cannot be its own cause.)

  IllegalStateException - if the cause for this SOAPException object has already been initialized