Package javax.ws.rs

Class NotAuthorizedException

All Implemented Interfaces:
Serializable

public class NotAuthorizedException extends ClientErrorException
A runtime exception indicating request authorization failure caused by one of the following scenarios:
  • a client did not send the required authorization credentials to access the requested resource, i.e. Authorization HTTP header is missing in the request,
  • or - in case the request already contains the HTTP Authorization header - then the exception indicates that authorization has been refused for the credentials contained in the request header.
Since:
2.0
See Also:
  • Constructor Details

    • NotAuthorizedException

      public NotAuthorizedException(Object challenge, Object... moreChallenges)
      Construct a new "not authorized" exception.
      Parameters:
      challenge - authorization challenge applicable to the resource requested by the client.
      moreChallenges - additional authorization challenge applicable to the requested resource.
      Throws:
      NullPointerException - in case the challenge parameter is null.
    • NotAuthorizedException

      public NotAuthorizedException(String message, Object challenge, Object... moreChallenges)
      Construct a new "not authorized" exception.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      challenge - authorization challenge applicable to the resource requested by the client.
      moreChallenges - additional authorization challenge applicable to the requested resource.
      Throws:
      NullPointerException - in case the challenge parameter is null.
    • NotAuthorizedException

      public NotAuthorizedException(Response response)
      Construct a new "not authorized" exception.
      Parameters:
      response - error response.
      Throws:
      IllegalArgumentException - in case the status code set in the response is not HTTP 401.
    • NotAuthorizedException

      public NotAuthorizedException(String message, Response response)
      Construct a new "not authorized" exception.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      response - error response.
      Throws:
      IllegalArgumentException - in case the status code set in the response is not HTTP 401.
    • NotAuthorizedException

      public NotAuthorizedException(Throwable cause, Object challenge, Object... moreChallenges)
      Construct a new "not authorized" exception.
      Parameters:
      cause - the underlying cause of the exception.
      challenge - authorization challenge applicable to the requested resource.
      moreChallenges - additional authorization challenge applicable to the requested resource.
    • NotAuthorizedException

      public NotAuthorizedException(String message, Throwable cause, Object challenge, Object... moreChallenges)
      Construct a new "not authorized" exception.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      cause - the underlying cause of the exception.
      challenge - authorization challenge applicable to the requested resource.
      moreChallenges - additional authorization challenge applicable to the requested resource.
    • NotAuthorizedException

      public NotAuthorizedException(Response response, Throwable cause)
      Construct a new "not authorized" exception.
      Parameters:
      response - error response.
      cause - the underlying cause of the exception.
      Throws:
      IllegalArgumentException - in case the status code set in the response is not HTTP 401.
    • NotAuthorizedException

      public NotAuthorizedException(String message, Response response, Throwable cause)
      Construct a new "not authorized" exception.
      Parameters:
      message - the detail message (which is saved for later retrieval by the Throwable.getMessage() method).
      response - error response.
      cause - the underlying cause of the exception.
      Throws:
      IllegalArgumentException - in case the status code set in the response is not HTTP 401.
  • Method Details

    • getChallenges

      public List<Object> getChallenges()
      Get the list of authorization challenges associated with the exception and applicable to the resource requested by the client.
      Returns:
      list of authorization challenges applicable to the resource requested by the client.