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
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 Summary
ConstructorDescriptionConstruct 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.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
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
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
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 theThrowable.getMessage()
method).- Since:
- 2.0
-
WebApplicationException
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
Construct a new instance using the supplied message and response.- Parameters:
message
- the detail message (which is saved for later retrieval by theThrowable.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
Construct a new instance with a supplied message and HTTP status code.- Parameters:
message
- the detail message (which is saved for later retrieval by theThrowable.getMessage()
method).status
- the HTTP status code that will be returned to the client.- Since:
- 2.0
-
WebApplicationException
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 isnull
.
-
WebApplicationException
Construct a new instance with the supplied message and HTTP status.- Parameters:
message
- the detail message (which is saved for later retrieval by theThrowable.getMessage()
method).status
- the HTTP status code that will be returned to the client.- Throws:
IllegalArgumentException
- if status isnull
.- Since:
- 2.0
-
WebApplicationException
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
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 theThrowable.getMessage()
method).cause
- the underlying cause of the exception.- Since:
- 2.0
-
WebApplicationException
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
Construct a new instance with the supplied message, root cause and response.- Parameters:
message
- the detail message (which is saved for later retrieval by theThrowable.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
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
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 theThrowable.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 isnull
.
-
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 theThrowable.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 isnull
.- Since:
- 2.0
-
-
Method Details
-
getResponse
Get the HTTP response.- Returns:
- the HTTP response.
-