|
|||||||||||
| 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 SOAPException object with no
reason or embedded Throwable object. |
|
SOAPException(java.lang.String reason)
Constructs a SOAPException object with the
given String as the reason for the exception
being thrown. |
|
SOAPException(java.lang.String reason,
java.lang.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. |
|
SOAPException(java.lang.Throwable cause)
Constructs a SOAPException object
initialized with the given Throwable
object. |
|
| Method Summary | |
java.lang.Throwable |
getCause()
Returns the Throwable object embedded in
this SOAPException if there is one. |
java.lang.String |
getMessage()
Returns the detail message for this
SOAPException object. |
java.lang.Throwable |
initCause(java.lang.Throwable cause)
Initializes the cause field of this
SOAPException object with the given
Throwable object. |
| 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 | ||||||||||