Package javax.ws.rs

Class WebApplicationException

  • All Implemented Interfaces:
    Serializable

    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.

    Author:
    Paul.Sandoz@Sun.Com
    See Also:
    Serialized Form
    • Constructor Detail

      • WebApplicationException

        public WebApplicationException()
        Construct a new instance with a blank message and default HTTP status code of 500
      • WebApplicationException

        public WebApplicationException​(Response response)
        Construct a new instance using the supplied response
        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​(int status)
        Construct a new instance with a blank message and specified HTTP status code
        Parameters:
        status - the HTTP status code that will be returned to the client
      • WebApplicationException

        public WebApplicationException​(Response.Status status)
        Construct a new instance with a blank message and specified HTTP status code
        Parameters:
        status - the HTTP status code that will be returned to the client
        Throws:
        IllegalArgumentException - if status is null
      • WebApplicationException

        public WebApplicationException​(Throwable cause)
        Construct a new instance with a blank message and default HTTP status code of 500
        Parameters:
        cause - the underlying cause of the exception
      • WebApplicationException

        public WebApplicationException​(Throwable cause,
                                       Response response)
        Construct a new instance using the supplied response
        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​(Throwable cause,
                                       int status)
        Construct a new instance with a blank message and specified HTTP status code
        Parameters:
        status - the HTTP status code that will be returned to the client
        cause - the underlying cause of the exception
      • WebApplicationException

        public WebApplicationException​(Throwable cause,
                                       Response.Status status)
        Construct a new instance with a blank message and specified HTTP status code
        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
    • Method Detail

      • getResponse

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