com.nimbusds.oauth2.sdk.token

Class RefreshToken

java.lang.Object

com.nimbusds.oauth2.sdk.id.Identifier

com.nimbusds.oauth2.sdk.token.Token

com.nimbusds.oauth2.sdk.token.RefreshToken

All Implemented Interfaces:

Comparable<RefreshToken>, net.minidev.json.JSONAware

@Immutable
public final class RefreshToken
extends Token
implements Comparable<RefreshToken>

Refresh token. This class is immutable.

Related specifications:

• OAuth 2.0 (RFC 6749), section 1.5.

Author:

Vladimir Dzhuvinov

Field Summary

Fields inherited from class com.nimbusds.oauth2.sdk.id.Identifier

DEFAULT_BYTE_LENGTH

Constructor Summary

Constructors

Constructor and Description
RefreshToken() Creates a new refresh token with a randomly generated 256-bit (32-byte) value, Base64URL-encoded.
RefreshToken(int byteLength) Creates a new refresh token with a randomly generated value of the specified length, Base64URL-encoded.
RefreshToken(String value) Creates a new refresh token with the specified value.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(RefreshToken other)
boolean	equals(Object object) Overrides Object.equals().
static RefreshToken	parse(net.minidev.json.JSONObject jsonObject) Parses a refresh token from a JSON object access token response.
net.minidev.json.JSONObject	toJSONObject() Returns the token parameters as a JSON object, as required for the composition of an access token response.

Methods inherited from class com.nimbusds.oauth2.sdk.id.Identifier

getValue, hashCode, toJSONString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

RefreshToken

public RefreshToken()

Creates a new refresh token with a randomly generated 256-bit (32-byte) value, Base64URL-encoded.

RefreshToken

public RefreshToken(int byteLength)

Creates a new refresh token with a randomly generated value of the specified length, Base64URL-encoded.

Parameters:

byteLength - The byte length of the value to generate. Must be greater than one.

RefreshToken

public RefreshToken(String value)

Creates a new refresh token with the specified value.

Parameters:

value - The refresh token value. Must not be null or empty string.

Method Detail

toJSONObject

public net.minidev.json.JSONObject toJSONObject()

Description copied from class: Token

Returns the token parameters as a JSON object, as required for the composition of an access token response. See OAuth 2.0 (RFC 6749), section 5.1.

Note that JSONObject implements Map<String,Object>.

Example:

 {
   "access_token"      : "2YotnFZFEjr1zCsicMWpAA",
   "token_type"        : "example",
   "expires_in"        : 3600,
   "example_parameter" : "example_value"
 }
 

Specified by:

toJSONObject in class Token

Returns:

The token parameters as a JSON object.

parse

public static RefreshToken parse(net.minidev.json.JSONObject jsonObject)
                          throws ParseException

Parses a refresh token from a JSON object access token response.

Parameters:

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

Returns:

The refresh token, null if not found.

Throws:

ParseException - If the JSON object couldn't be parsed to a refresh token.

equals

public boolean equals(Object object)

Description copied from class: Identifier

Overrides Object.equals().

Specified by:

equals in class Identifier

Parameters:

object - The object to compare to.

Returns:

true if the objects have the same value, otherwise false.

compareTo

public int compareTo(RefreshToken other)

Specified by:

compareTo in interface Comparable<RefreshToken>