|
||||||||||
| 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
com.sun.xml.messaging.saaj.SOAPExceptionImpl
public class SOAPExceptionImpl
An exception that signals that a SOAP exception has occurred. A
SOAPExceptionImpl 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 SOAPExceptionImpl
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 | |
|---|---|
SOAPExceptionImpl()
Constructs a SOAPExceptionImpl object with no
reason or embedded Throwable object. |
|
SOAPExceptionImpl(String reason)
Constructs a SOAPExceptionImpl object with the given
String as the reason for the exception being thrown. |
|
SOAPExceptionImpl(String reason,
Throwable cause)
Constructs a SOAPExceptionImpl object with the given
String as the reason for the exception being thrown
and the given Throwable object as an embedded
exception. |
|
SOAPExceptionImpl(Throwable cause)
Constructs a SOAPExceptionImpl object initialized
with the given Throwable object. |
|
| Method Summary | |
|---|---|
Throwable |
getCause()
Returns the Throwable object embedded in this
SOAPExceptionImpl if there is one. |
String |
getMessage()
Returns the detail message for this SOAPExceptionImpl
object. |
Throwable |
initCause(Throwable cause)
Initializes the cause field of this SOAPExceptionImpl
object with the given Throwable object. |
void |
printStackTrace()
|
void |
printStackTrace(PrintStream s)
|
void |
printStackTrace(PrintWriter s)
|
| Methods inherited from class java.lang.Throwable |
|---|
fillInStackTrace, getLocalizedMessage, getStackTrace, setStackTrace, toString |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
|---|
public SOAPExceptionImpl()
SOAPExceptionImpl object with no
reason or embedded Throwable object.
public SOAPExceptionImpl(String reason)
SOAPExceptionImpl object with the given
String as the reason for the exception being thrown.
reason - a description of what caused the exception
public SOAPExceptionImpl(String reason,
Throwable cause)
SOAPExceptionImpl 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 SOAPExceptionImpl objectpublic SOAPExceptionImpl(Throwable cause)
SOAPExceptionImpl object initialized
with the given Throwable object.
| Method Detail |
|---|
public String getMessage()
SOAPExceptionImpl
object.
If there is an embedded Throwable object, and if the
SOAPExceptionImpl object has no detail message of its
own, this method will return the detail message from the embedded
Throwable object.
getMessage in class SOAPExceptionSOAPExceptionImpl or, if it has none, the
message of the embedded Throwable object,
if there is onepublic Throwable getCause()
Throwable object embedded in this
SOAPExceptionImpl if there is one. Otherwise, this method
returns null.
getCause in class SOAPExceptionThrowable object or null
if there is nonepublic Throwable initCause(Throwable cause)
cause field of this SOAPExceptionImpl
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 SOAPExceptionImpl object.
If this SOAPExceptionImpl object was created with the
constructor SOAPExceptionImpl(Throwable) or
SOAPExceptionImpl(String,Throwable), meaning that its
cause field already has a value, this method cannot be
called even once.
initCause in class SOAPExceptioncause - the Throwable object that caused this
SOAPExceptionImpl 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.
SOAPExceptionImpl instance
IllegalArgumentException - if cause is this
Throwable object. (A Throwable object
cannot be its own cause.)
IllegalStateException - if this SOAPExceptionImpl object
was created with SOAPExceptionImpl(Throwable) or
SOAPExceptionImpl(String,Throwable), or this
method has already been called on this SOAPExceptionImpl
objectpublic void printStackTrace()
printStackTrace in class Throwablepublic void printStackTrace(PrintStream s)
printStackTrace in class Throwablepublic void printStackTrace(PrintWriter s)
printStackTrace in class Throwable
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||