- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.xml.registry.JAXRException
-
- All Implemented Interfaces:
- Serializable, JAXRResponse
- Direct Known Subclasses:
- InvalidRequestException, RegistryException, UnexpectedObjectException, UnsupportedCapabilityException
public class JAXRException extends Exception implements JAXRResponse
Signals that a JAXR exception has occurred. It contains no members other than the standard reason String.- Author:
- Nicholas Kassem, Mark Hapner, Rajiv Mordani, Farrukh Najmi
- See Also:
JAXRResponse
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field and Description protected Throwable
cause
The Throwable that caused this JAXRException to occur.-
Fields inherited from interface javax.xml.registry.JAXRResponse
STATUS_FAILURE, STATUS_SUCCESS, STATUS_UNAVAILABLE, STATUS_WARNING
-
-
Constructor Summary
Constructors Constructor and Description JAXRException()
Constructs aJAXRException
object with no reason or embedded Throwable.JAXRException(String reason)
Constructs aJAXRException
object with the givenString
as the reason for the exception being thrown.JAXRException(String reason, Throwable cause)
Constructs aJAXRException
object with the givenString
as the reason for the exception being thrown and the givenThrowable
object as an embedded Throwable.JAXRException(Throwable cause)
Constructs aJAXRException
object initialized with the givenThrowable
object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description Throwable
getCause()
Returns the Throwable embedded in thisJAXRException
if there is one.String
getMessage()
Returns the detail message for thisJAXRException
object.String
getRequestId()
Returns the unique id for the request that generated this response.int
getStatus()
Returns the status for this response.Throwable
initCause(Throwable cause)
Initializes the cause of this throwable to the specified value.boolean
isAvailable()
Returns true if a response is available, false otherwise.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Field Detail
-
cause
protected Throwable cause
The Throwable that caused this JAXRException to occur. This is used when a JAXRException has a nested Throwable.
-
-
Constructor Detail
-
JAXRException
public JAXRException()
Constructs aJAXRException
object with no reason or embedded Throwable.
-
JAXRException
public JAXRException(String reason)
Constructs aJAXRException
object with the givenString
as the reason for the exception being thrown.- Parameters:
reason
- a description of what caused the exception
-
JAXRException
public JAXRException(String reason, Throwable cause)
Constructs aJAXRException
object with the givenString
as the reason for the exception being thrown and the givenThrowable
object as an embedded Throwable.- Parameters:
reason
- a description of what caused the exceptioncause
- aThrowable
object that is to be embedded in thisJAXRException
object
-
JAXRException
public JAXRException(Throwable cause)
Constructs aJAXRException
object initialized with the givenThrowable
object.- Parameters:
cause
- the Throwable that caused this Exception
-
-
Method Detail
-
getMessage
public String getMessage()
Returns the detail message for thisJAXRException
object.If there is an embedded Throwable, and if the
JAXRException
object has no detail message of its own, this method will return the detail message from the embedded Throwable.- Overrides:
getMessage
in classThrowable
- Returns:
- the error or warning message for this
JAXRException
or, if it has none, the message of the embedded Throwable, if there is one
-
getCause
public Throwable getCause()
Returns the Throwable embedded in thisJAXRException
if there is one. Otherwise, this method returnsnull
.
-
initCause
public Throwable initCause(Throwable cause)
Initializes the cause of this throwable to the specified value. (The cause is the throwable that caused this throwable to get thrown.)This method can be called at most once. It is generally called from within the constructor, or immediately after creating the throwable. If this throwable was created with
JAXRException(Throwable)
orJAXRException(String,Throwable)
, this method cannot be called even once.- Overrides:
initCause
in classThrowable
- Parameters:
cause
- the cause (which 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
Throwable
instance. - Throws:
IllegalArgumentException
- ifcause
is this throwable. (A throwable cannot be its own cause.)IllegalStateException
- if this throwable was created withJAXRException(Throwable)
orJAXRException(String,Throwable)
, or this method has already been called on this throwable.
-
getRequestId
public String getRequestId()
Description copied from interface:JAXRResponse
Returns the unique id for the request that generated this response.- Capability Level: 0
- Specified by:
getRequestId
in interfaceJAXRResponse
- Returns:
- the request id
-
getStatus
public int getStatus()
Description copied from interface:JAXRResponse
Returns the status for this response.- Capability Level: 0
- Specified by:
getStatus
in interfaceJAXRResponse
- Returns:
- the status which is an integer enumerated value
- See Also:
JAXRResponse.STATUS_SUCCESS
-
isAvailable
public boolean isAvailable() throws JAXRException
Returns true if a response is available, false otherwise. This is a polling method and must not block.- Specified by:
isAvailable
in interfaceJAXRResponse
- Returns:
true
if the response is available;false
otherwise- Throws:
JAXRException
- If the JAXR provider encounters an internal error
-
-
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 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/xml/registry/jaxrexception.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.