Package jakarta.ws.rs

Class WebApplicationException

All Implemented Interfaces:
Serializable
Direct Known Subclasses:
ClientErrorException, RedirectionException, ServerErrorException

public class WebApplicationException extends RuntimeException
Runtime exception for applications.

This exception may be thrown by a resource method, provider or StreamingOutput implementation if a specific HTTP error response needs to be produced. Only effective if thrown prior to the response being committed.

Since:
1.0
Author:
Paul Sandoz, Marek Potociar
See Also:
  • Constructor Details

    • WebApplicationException

      public WebApplicationException()
      Construct a new instance with a default HTTP status code of 500 and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
    • WebApplicationException

      public WebApplicationException(String message)
      Construct a new instance with the supplied message and a default HTTP status code of 500.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Response response)
      Construct a new instance using the supplied response and a default message generated from the response's HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      response - the response that will be returned to the client, a value of null will be replaced with an internal server error response (status code 500).
    • WebApplicationException

      public WebApplicationException(String message, Response response)
      Construct a new instance using the supplied message and response.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      response - the response that will be returned to the client, a value of null will be replaced with an internal server error response (status code 500).
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(int status)
      Construct a new instance with the supplied HTTP status code and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      status - the HTTP status code that will be returned to the client.
    • WebApplicationException

      public WebApplicationException(String message, int status)
      Construct a new instance with a supplied message and HTTP status code.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      status - the HTTP status code that will be returned to the client.
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Response.Status status)
      Construct a new instance with the supplied HTTP status and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      status - the HTTP status code that will be returned to the client.
      Throws:
      IllegalArgumentException - if status is null.
    • WebApplicationException

      public WebApplicationException(String message, Response.Status status)
      Construct a new instance with the supplied message and HTTP status.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      status - the HTTP status code that will be returned to the client.
      Throws:
      IllegalArgumentException - if status is null.
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Throwable cause)
      Construct a new instance with the supplied root cause, default HTTP status code of 500 and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      cause - the underlying cause of the exception.
    • WebApplicationException

      public WebApplicationException(String message, Throwable cause)
      Construct a new instance with the supplied message, root cause and default HTTP status code of 500.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      cause - the underlying cause of the exception.
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Throwable cause, Response response)
      Construct a new instance with the supplied root cause, response and a default message generated from the response's HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      cause - the underlying cause of the exception.
      response - the response that will be returned to the client, a value of null will be replaced with an internal server error response (status code 500).
    • WebApplicationException

      public WebApplicationException(String message, Throwable cause, Response response)
      Construct a new instance with the supplied message, root cause and response.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      cause - the underlying cause of the exception.
      response - the response that will be returned to the client, a value of null will be replaced with an internal server error response (status code 500).
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Throwable cause, int status)
      Construct a new instance with the supplied root cause, HTTP status code and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      cause - the underlying cause of the exception.
      status - the HTTP status code that will be returned to the client.
    • WebApplicationException

      public WebApplicationException(String message, Throwable cause, int status)
      Construct a new instance with the supplied message, root cause and HTTP status code.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      cause - the underlying cause of the exception.
      status - the HTTP status code that will be returned to the client.
      Since:
      2.0
    • WebApplicationException

      public WebApplicationException(Throwable cause, Response.Status status) throws IllegalArgumentException
      Construct a new instance with the supplied root cause, HTTP status code and a default message generated from the HTTP status code and the associated HTTP status reason phrase.
      Parameters:
      cause - the underlying cause of the exception.
      status - the HTTP status code that will be returned to the client.
      Throws:
      IllegalArgumentException - if status is null.
    • WebApplicationException

      public WebApplicationException(String message, Throwable cause, Response.Status status) throws IllegalArgumentException
      Construct a new instance with a the supplied message, root cause and HTTP status code.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      cause - the underlying cause of the exception.
      status - the HTTP status code that will be returned to the client.
      Throws:
      IllegalArgumentException - if status is null.
      Since:
      2.0
  • Method Details

    • getResponse

      public Response getResponse()
      Get the HTTP response.
      Returns:
      the HTTP response.