- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.xml.soap.SOAPException
-
- All Implemented Interfaces:
- Serializable
public class SOAPException extends Exception
An exception that signals that a SOAP exception has occurred. ASOAPException
object may contain aString
that gives the reason for the exception, an embeddedThrowable
object, or both. This class provides methods for retrieving reason messages and for retrieving the embeddedThrowable
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 aThrowable
object include problems such as input/output errors or a parsing problem, such as an error in parsing a header.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description SOAPException()
Constructs aSOAPException
object with no reason or embeddedThrowable
object.SOAPException(String reason)
Constructs aSOAPException
object with the givenString
as the reason for the exception being thrown.SOAPException(String reason, Throwable cause)
Constructs aSOAPException
object with the givenString
as the reason for the exception being thrown and the givenThrowable
object as an embedded exception.SOAPException(Throwable cause)
Constructs aSOAPException
object initialized with the givenThrowable
object.
-
Method Summary
Methods Modifier and Type Method and Description Throwable
getCause()
Returns theThrowable
object embedded in thisSOAPException
if there is one.String
getMessage()
Returns the detail message for thisSOAPException
object.Throwable
initCause(Throwable cause)
Initializes thecause
field of thisSOAPException
object with the givenThrowable
object.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
SOAPException
public SOAPException()
Constructs aSOAPException
object with no reason or embeddedThrowable
object.
-
SOAPException
public SOAPException(String reason)
Constructs aSOAPException
object with the givenString
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 aSOAPException
object with the givenString
as the reason for the exception being thrown and the givenThrowable
object as an embedded exception.- Parameters:
reason
- a description of what caused the exceptioncause
- aThrowable
object that is to be embedded in thisSOAPException
object
-
SOAPException
public SOAPException(Throwable cause)
Constructs aSOAPException
object initialized with the givenThrowable
object.
-
-
Method Detail
-
getMessage
public String getMessage()
Returns the detail message for thisSOAPException
object.If there is an embedded
Throwable
object, and if theSOAPException
object has no detail message of its own, this method will return the detail message from the embeddedThrowable
object.- Overrides:
getMessage
in classThrowable
- Returns:
- the error or warning message for this
SOAPException
or, if it has none, the message of the embeddedThrowable
object, if there is one
-
getCause
public Throwable getCause()
Returns theThrowable
object embedded in thisSOAPException
if there is one. Otherwise, this method returnsnull
.
-
initCause
public Throwable initCause(Throwable cause)
Initializes thecause
field of thisSOAPException
object with the givenThrowable
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 thisSOAPException
object was created with the constructorSOAPException(Throwable)
orSOAPException(String,Throwable)
, meaning that itscause
field already has a value, this method cannot be called even once.- Overrides:
initCause
in classThrowable
- Parameters:
cause
- theThrowable
object that caused thisSOAPException
object to be thrown. The value of this parameter is saved for later retrieval by thegetCause()
method. A null value is permitted and indicates that the cause is nonexistent or unknown.- Returns:
- a reference to this
SOAPException
instance - Throws:
IllegalArgumentException
- ifcause
is thisThrowable
object. (AThrowable
object cannot be its own cause.)IllegalStateException
- if the cause for thisSOAPException
object has already been initialized
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 11:43:48 Cette version de la page est en cache (à la date du 22/12/2024 11:43:48) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/xml/soap/SOAPException.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.