Package javax.xml.registry
Class JAXRException
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
Signals that a Jakarta XML Registries exception has occurred. It contains no members other than the standard reason String.
- Author:
- Nicholas Kassem, Mark Hapner, Rajiv Mordani, Farrukh Najmi
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected Throwable
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
ConstructorsConstructorDescriptionConstructs 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
Modifier and TypeMethodDescriptiongetCause()
Returns the Throwable embedded in thisJAXRException
if there is one.Returns the detail message for thisJAXRException
object.Returns the unique id for the request that generated this response.int
Returns the status for this response.Initializes the cause of this throwable to the specified value.boolean
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 Details
-
cause
The Throwable that caused this JAXRException to occur. This is used when a JAXRException has a nested Throwable.
-
-
Constructor Details
-
JAXRException
public JAXRException()Constructs aJAXRException
object with no reason or embedded Throwable. -
JAXRException
Constructs aJAXRException
object with the givenString
as the reason for the exception being thrown.- Parameters:
reason
- a description of what caused the exception
-
JAXRException
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
Constructs aJAXRException
object initialized with the givenThrowable
object.- Parameters:
cause
- the Throwable that caused this Exception
-
-
Method Details
-
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
Returns the Throwable embedded in thisJAXRException
if there is one. Otherwise, this method returnsnull
. -
initCause
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
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:
-
isAvailable
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 Jakarta XML Registries provider encounters an internal error
-