- 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. ASOAPExceptionobject may contain aStringthat gives the reason for the exception, an embeddedThrowableobject, or both. This class provides methods for retrieving reason messages and for retrieving the embeddedThrowableobject.Typical reasons for throwing a
SOAPExceptionobject 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 aThrowableobject 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 aSOAPExceptionobject with no reason or embeddedThrowableobject.SOAPException(String reason)Constructs aSOAPExceptionobject with the givenStringas the reason for the exception being thrown.SOAPException(String reason, Throwable cause)Constructs aSOAPExceptionobject with the givenStringas the reason for the exception being thrown and the givenThrowableobject as an embedded exception.SOAPException(Throwable cause)Constructs aSOAPExceptionobject initialized with the givenThrowableobject.
-
Method Summary
Methods Modifier and Type Method and Description ThrowablegetCause()Returns theThrowableobject embedded in thisSOAPExceptionif there is one.StringgetMessage()Returns the detail message for thisSOAPExceptionobject.ThrowableinitCause(Throwable cause)Initializes thecausefield of thisSOAPExceptionobject with the givenThrowableobject.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
SOAPException
public SOAPException()
Constructs aSOAPExceptionobject with no reason or embeddedThrowableobject.
-
SOAPException
public SOAPException(String reason)
Constructs aSOAPExceptionobject with the givenStringas the reason for the exception being thrown.- Parameters:
reason- a description of what caused the exception
-
SOAPException
public SOAPException(String reason, Throwable cause)
Constructs aSOAPExceptionobject with the givenStringas the reason for the exception being thrown and the givenThrowableobject as an embedded exception.- Parameters:
reason- a description of what caused the exceptioncause- aThrowableobject that is to be embedded in thisSOAPExceptionobject
-
SOAPException
public SOAPException(Throwable cause)
Constructs aSOAPExceptionobject initialized with the givenThrowableobject.
-
-
Method Detail
-
getMessage
public String getMessage()
Returns the detail message for thisSOAPExceptionobject.If there is an embedded
Throwableobject, and if theSOAPExceptionobject has no detail message of its own, this method will return the detail message from the embeddedThrowableobject.- Overrides:
getMessagein classThrowable- Returns:
- the error or warning message for this
SOAPExceptionor, if it has none, the message of the embeddedThrowableobject, if there is one
-
getCause
public Throwable getCause()
Returns theThrowableobject embedded in thisSOAPExceptionif there is one. Otherwise, this method returnsnull.
-
initCause
public Throwable initCause(Throwable cause)
Initializes thecausefield of thisSOAPExceptionobject with the givenThrowableobject.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
SOAPExceptionobject. If thisSOAPExceptionobject was created with the constructorSOAPException(Throwable)orSOAPException(String,Throwable), meaning that itscausefield already has a value, this method cannot be called even once.- Overrides:
initCausein classThrowable- Parameters:
cause- theThrowableobject that caused thisSOAPExceptionobject 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
SOAPExceptioninstance - Throws:
IllegalArgumentException- ifcauseis thisThrowableobject. (AThrowableobject cannot be its own cause.)IllegalStateException- if the cause for thisSOAPExceptionobject has already been initialized
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/xml/soap/SOAPException.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.