com.nimbusds.oauth2.sdk

Class ErrorObject

java.lang.Object

com.nimbusds.oauth2.sdk.ErrorObject

Direct Known Subclasses:

BearerTokenError

@Immutable
public class ErrorObject
extends java.lang.Object

Error object, used to encapsulate OAuth 2.0 and other errors.

Example error object as HTTP response:

 HTTP/1.1 400 Bad Request
 Content-Type: application/json;charset=UTF-8
 Cache-Control: no-store
 Pragma: no-cache

 {
   "error" : "invalid_request"
 }
 

Constructor Summary

Constructors

Constructor and Description
ErrorObject(java.lang.String code) Creates a new error with the specified code.
ErrorObject(java.lang.String code, java.lang.String description) Creates a new error with the specified code and description.
ErrorObject(java.lang.String code, java.lang.String description, int httpStatusCode) Creates a new error with the specified code, description and HTTP status code.
ErrorObject(java.lang.String code, java.lang.String description, int httpStatusCode, java.net.URI uri) Creates a new error with the specified code, description, HTTP status code and page URI.

Method Summary

Methods

Modifier and Type	Method and Description
ErrorObject	appendDescription(java.lang.String text) Appends the specified text to the error description.
boolean	equals(java.lang.Object object)
java.lang.String	getCode() Gets the error code.
java.lang.String	getDescription() Gets the error description.
int	getHTTPStatusCode() Gets the HTTP status code.
java.net.URI	getURI() Gets the error page URI.
int	hashCode()
static ErrorObject	parse(HTTPResponse httpResponse) Parses an error object from the specified HTTP response.
static ErrorObject	parse(net.minidev.json.JSONObject jsonObject) Parses an error object from the specified JSON object.
ErrorObject	setDescription(java.lang.String description) Sets the error description.
ErrorObject	setHTTPStatusCode(int httpStatusCode) Sets the HTTP status code.
ErrorObject	setURI(java.net.URI uri) Sets the error page URI.
net.minidev.json.JSONObject	toJSONObject() Returns a JSON object representation of this error object.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ErrorObject

public ErrorObject(java.lang.String code)

Creates a new error with the specified code.

Parameters:

code - The error code, null if not specified.

ErrorObject

public ErrorObject(java.lang.String code,
           java.lang.String description)

Creates a new error with the specified code and description.

Parameters:

code - The error code, null if not specified.

description - The error description, null if not specified.

ErrorObject

public ErrorObject(java.lang.String code,
           java.lang.String description,
           int httpStatusCode)

Creates a new error with the specified code, description and HTTP status code.

Parameters:

code - The error code, null if not specified.

description - The error description, null if not specified.

httpStatusCode - The HTTP status code, zero if not specified.

ErrorObject

public ErrorObject(java.lang.String code,
           java.lang.String description,
           int httpStatusCode,
           java.net.URI uri)

Creates a new error with the specified code, description, HTTP status code and page URI.

Parameters:

code - The error code, null if not specified.

description - The error description, null if not specified.

httpStatusCode - The HTTP status code, zero if not specified.

uri - The error page URI, null if not specified.

Method Detail

getCode

public java.lang.String getCode()

Gets the error code.

Returns:

The error code, null if not specified.

getDescription

public java.lang.String getDescription()

Gets the error description.

Returns:

The error description, null if not specified.

setDescription

public ErrorObject setDescription(java.lang.String description)

Sets the error description.

Parameters:

description - The error description, null if not specified.

Returns:

A copy of this error with the specified description.

appendDescription

public ErrorObject appendDescription(java.lang.String text)

Appends the specified text to the error description.

Parameters:

text - The text to append to the error description, null if not specified.

Returns:

A copy of this error with the specified appended description.

getHTTPStatusCode

public int getHTTPStatusCode()

Gets the HTTP status code.

Returns:

The HTTP status code, zero if not specified.

setHTTPStatusCode

public ErrorObject setHTTPStatusCode(int httpStatusCode)

Sets the HTTP status code.

Parameters:

httpStatusCode - The HTTP status code, zero if not specified.

Returns:

A copy of this error with the specified HTTP status code.

getURI

public java.net.URI getURI()

Gets the error page URI.

Returns:

The error page URI, null if not specified.

setURI

public ErrorObject setURI(java.net.URI uri)

Sets the error page URI.

Parameters:

uri - The error page URI, null if not specified.

Returns:

A copy of this error with the specified page URI.

toJSONObject

public net.minidev.json.JSONObject toJSONObject()

Returns a JSON object representation of this error object.

Example:

 {
   "error"             : "invalid_grant",
   "error_description" : "Invalid resource owner credentials"
           }
 

Returns:

The JSON object.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

See Also:

getCode()

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object object)

Overrides:

equals in class java.lang.Object

parse

public static ErrorObject parse(net.minidev.json.JSONObject jsonObject)

Parses an error object from the specified JSON object.

Parameters:

jsonObject - The JSON object to parse. Must not be null.

Returns:

The error object.

parse

public static ErrorObject parse(HTTPResponse httpResponse)

Parses an error object from the specified HTTP response.

Parameters:

httpResponse - The HTTP response to parse. Must not be null.

Returns:

The error object.