java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - java.lang.RuntimeException
    - - jakarta.ws.rs.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:

Serialized Form

Constructor Summary

Constructors
Constructor	Description
`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(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.
`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.
`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.
`WebApplicationException(String message)`	Construct a new instance with the supplied message and a default HTTP status code of 500.
`WebApplicationException(String message, int status)`	Construct a new instance with a supplied message and HTTP status code.
`WebApplicationException(String message, Response response)`	Construct a new instance using the supplied message and response.
`WebApplicationException(String message, Response.Status status)`	Construct a new instance with the supplied message and HTTP status.
`WebApplicationException(String message, Throwable cause)`	Construct a new instance with the supplied message, root cause and default HTTP status code of 500.
`WebApplicationException(String message, Throwable cause, int status)`	Construct a new instance with the supplied message, root cause and HTTP status code.
`WebApplicationException(String message, Throwable cause, Response response)`	Construct a new instance with the supplied message, root cause and response.
`WebApplicationException(String message, Throwable cause, Response.Status status)`	Construct a new instance with a the supplied message, root cause and HTTP status code.
`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.
`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.
`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.
`WebApplicationException(Throwable cause, Response.Status 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.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type Method Description

Response getResponse()
Get the HTTP response.
- Methods inherited from class java.lang.Throwable
  addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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
  - 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:
    
    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).
    
    cause - the underlying cause of the exception.
  - 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).
    
    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).
    
    cause - the underlying cause of the exception.
    
    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:
    
    status - the HTTP status code that will be returned to the client.
    
    cause - the underlying cause of the exception.
  - 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).
    
    status - the HTTP status code that will be returned to the client.
    
    cause - the underlying cause of the exception.
    
    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:
    
    status - the HTTP status code that will be returned to the client.
    
    cause - the underlying cause of the exception.
    
    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).
    
    status - the HTTP status code that will be returned to the client.
    
    cause - the underlying cause of the exception.
    
    Throws:
    
    IllegalArgumentException - if status is null.
    
    Since:
    
    2.0
- Method Detail
  - getResponse
```
public Response getResponse()
```
    Get the HTTP response.
    
    Returns:
    
    the HTTP response.

Class WebApplicationException

Constructor Summary

Method Summary

Methods inherited from class java.lang.Throwable

Methods inherited from class java.lang.Object

Constructor Detail

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

WebApplicationException

Method Detail

getResponse