|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.lang.Throwable java.lang.Exception javax.xml.soap.SOAPException
public class 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(String reason)
Constructs a SOAPException object with the given
String as the reason for the exception being thrown. |
|
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. |
|
SOAPException(Throwable cause)
Constructs a SOAPException object initialized
with the given Throwable object. |
Method Summary | |
---|---|
Throwable |
getCause()
Returns the Throwable object embedded in this
SOAPException if there is one. |
String |
getMessage()
Returns the detail message for this SOAPException
object. |
Throwable |
initCause(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(String reason)
SOAPException
object with the given
String
as the reason for the exception being thrown.
reason
- a description of what caused the exceptionpublic SOAPException(String reason, 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(Throwable cause)
SOAPException
object initialized
with the given Throwable
object.
Method Detail |
---|
public 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.
getMessage
in class Throwable
SOAPException
or, if it has none, the
message of the embedded Throwable
object,
if there is onepublic Throwable getCause()
Throwable
object embedded in this
SOAPException
if there is one. Otherwise, this method
returns null
.
getCause
in class Throwable
Throwable
object or null
if there is nonepublic Throwable initCause(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(Throwable)
or
SOAPException(String,Throwable)
, meaning that its
cause
field already has a value, this method cannot be
called even once.
initCause
in class Throwable
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
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
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.