javax.ws.rs.client
Class ClientException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              javax.ws.rs.client.ClientException

All Implemented Interfaces:

Serializable

public class ClientException
extends RuntimeException

A client-side processing runtime exception. The exception is thrown during HTTP request invocation processing, to signal a failure to process the HTTP request or response. The exception message or nested Throwable cause SHOULD contain additional information about the reason of the processing failure.

Note that the exception is used to indicate client-side processing errors. It is not used to indicate errors received in a response from a server. For the cases when a response returned by a server does not contain a successful response status code a WebApplicationException or one of it's sub-classes is used, depending on the actual value of the returned response status code.

Since:

2.0

Author:

Marek Potociar

See Also:

Serialized Form

Constructor Summary

ClientException(String message)
Constructs a new client-side runtime exception with the specified detail message.

ClientException(String message, Throwable cause)
Constructs a new client-side runtime exception with the specified detail message and cause.

ClientException(Throwable cause)
Constructs a new client-side runtime exception with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

Method Summary

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ClientException

public ClientException(Throwable cause)

Constructs a new client-side runtime exception with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for runtime exceptions that are little more than wrappers for other throwables.

Parameters:

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

ClientException

public ClientException(String message,
                       Throwable cause)

Constructs a new client-side runtime exception with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this runtime exception's detail message.

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).

cause - the cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

ClientException

public ClientException(String message)

Constructs a new client-side runtime exception with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to Throwable.initCause(java.lang.Throwable).

Parameters:

message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).