Previous section   Next section
JAXRException javax.xml.registry

JAXR 1.0; JWSDP 1.0, J2EE 1.4 serializable checked
public class JAXRException extends Exception implements JAXRResponse {
// Public Constructors
    public JAXRException(  ); 
    public JAXRException( Throwable cause); 
    public JAXRException( String reason); 
    public JAXRException( String reason, Throwable cause); 
// Methods Implementing JAXRResponse
    public String getRequestId(  );
               // constant default:null L0
    public int getStatus(  );
               // constant default:0 L0
    public boolean isAvailable(  ) throws JAXRException;
               // constant default:true
// Public Methods Overriding Throwable
    public Throwable getCause(  );
               // default:null
    public String getMessage(  );
               // default:null
    public Throwable initCause( Throwable cause);
               // synchronized
// Protected Instance Fields
    protected Throwable cause; 
}

JAXRException is a checked exception that can be thrown from many of the methods in the JAXR API. JAXRException also implements the methods of the JAXRResponse interface, although there is no clear reason why it should do so. In the reference implementation, these methods return fixed values that indicate a completed request. Registry exceptions that result from errors detected by the JAXR provider (that is, on the client side of the operation) are derived from JAXRException, while those that occur on the registry side are reported as subclasses of RegistryException, which is itself derived from JAXRException.

A JAXRException contains a text message that describes the reason for the exception, and an optional Throwable that can be used to link to another exception as the root cause of this one. Both of these attributes may be set at construction time. The initCause( ) method may be used to associate a Throwable with a JAXRException after it is created, but may be called at most once and may not be called at all if a non-null Throwable is supplied to the constructor. The getMessage( ) method returns the message text set at construction time, or it returns the result of invoking the getMessage( ) of the Throwable if no message text is supplied to the constructor. If, in this case, there is no associated Throwable, then getMessage( ) returns null.

Subclasses

InvalidRequestException, RegistryException, UnexpectedObjectException, UnsupportedCapabilityException

Thrown By

Too many methods to list.


  Previous section   Next section