| 
 | |||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjava.lang.Throwable
java.lang.Exception
javax.xml.soap.SOAPException
An exception that signals that a SOAP exception has
   occurred. A SOAPException object may contain a
   String that gives the reason for the exception, an
   embedded Throwable object, or both. This class
   provides methods for retrieving reason messages and for
   retrieving the embedded Throwable object.
Typical reasons for throwing a SOAPException
   object are problems such as difficulty setting a header, not
   being able to send a message, and not being able to get a
   connection with the provider. Reasons for embedding a 
   Throwable object include problems such as input/output
   errors or a parsing problem, such as an error in parsing a
   header.
| Constructor Summary | |
| SOAPException()Constructs a SOAPExceptionobject with no
 reason or embeddedThrowableobject. | |
| SOAPException(java.lang.String reason)Constructs a SOAPExceptionobject with the
 givenStringas the reason for the exception
 being thrown. | |
| SOAPException(java.lang.String reason,
              java.lang.Throwable cause)Constructs a SOAPExceptionobject with the
 givenStringas the reason for the exception
 being thrown and the givenThrowableobject as
 an embedded exception. | |
| SOAPException(java.lang.Throwable cause)Constructs a SOAPExceptionobject
 initialized with the givenThrowableobject. | |
| Method Summary | |
|  java.lang.Throwable | getCause()Returns the Throwableobject embedded in
 thisSOAPExceptionif there is one. | 
|  java.lang.String | getMessage()Returns the detail message for this 
   SOAPExceptionobject. | 
|  java.lang.Throwable | initCause(java.lang.Throwable cause)Initializes the causefield of this
   SOAPExceptionobject with the given
   Throwableobject. | 
| Methods inherited from class java.lang.Throwable | 
| fillInStackTrace, getLocalizedMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString | 
| Methods inherited from class java.lang.Object | 
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait | 
| Constructor Detail | 
public SOAPException()
SOAPException object with no
 reason or embedded Throwable object.
public SOAPException(java.lang.String reason)
SOAPException object with the
 given String as the reason for the exception
 being thrown.
reason - a description of what caused
     the exception
public SOAPException(java.lang.String reason,
                     java.lang.Throwable cause)
SOAPException object with the
 given String as the reason for the exception
 being thrown and the given Throwable object as
 an embedded exception.
reason - a description of what caused
     the exceptioncause - a Throwable object
     that is to be embedded in this SOAPException
     objectpublic SOAPException(java.lang.Throwable cause)
SOAPException object
 initialized with the given Throwable
 object.
cause - a Throwable object
     that is to be embedded in this SOAPException
     object| Method Detail | 
public java.lang.String getMessage()
   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.
     SOAPException or, if it has none, the message of
     the embedded Throwable object, if there is
     onepublic java.lang.Throwable getCause()
Throwable object embedded in
 this SOAPException if there is one. Otherwise,
 this method returns null.
Throwable object or 
     null if there is nonepublic java.lang.Throwable initCause(java.lang.Throwable cause)
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(java.lang.Throwable)
   or SOAPException(java.lang.String, java.lang.Throwable), meaning
   that its cause field already has a value, this
   method cannot be called even once.
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.
SOAPException
     instance
java.lang.IllegalArgumentException - if
     cause is this Throwable object.
     (A Throwable object cannot be its own
     cause.)
java.lang.IllegalStateException - if this 
     SOAPException object was created with SOAPException(java.lang.Throwable)
   or SOAPException(java.lang.String, java.lang.Throwable), or this
     method has already been called on this 
     SOAPException object| 
 | |||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||