com.nimbusds.oauth2.sdk.token.Token Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of oauth2-oidc-sdk Show documentation
Show all versions of oauth2-oidc-sdk Show documentation
OAuth 2.0 SDK with OpenID Connection extensions for developing
client and server applications.
/*
* oauth2-oidc-sdk
*
* Copyright 2012-2016, Connect2id Ltd and contributors.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use
* this file except in compliance with the License. You may obtain a copy of the
* License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed
* under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the
* specific language governing permissions and limitations under the License.
*/
package com.nimbusds.oauth2.sdk.token;
import java.util.Set;
import net.minidev.json.JSONObject;
import com.nimbusds.oauth2.sdk.id.Identifier;
/**
* The base abstract class for access and refresh tokens. Concrete extending
* classes should be immutable.
*
* Related specifications:
*
*
* - OAuth 2.0 (RFC 6749), sections 1.4 and 1.5.
*
*/
public abstract class Token extends Identifier {
/**
* Creates a new token with the specified value.
*
* @param value The token value. Must not be {@code null} or empty
* string.
*/
protected Token(final String value) {
super(value);
}
/**
* Creates a new token with a randomly generated value of the specified
* byte length, Base64URL-encoded.
*
* @param byteLength The byte length of the value to generate. Must be
* greater than one.
*/
protected Token(final int byteLength) {
super(byteLength);
}
/**
* Creates a new token with a randomly generated 256-bit (32-byte)
* value, Base64URL-encoded.
*/
protected Token() {
super();
}
/**
* Returns the token parameter names included in the JSON object, as
* required for the composition of an access token response. See OAuth
* 2.0 (RFC 6749), section 5.1.
*
* @return The token parameter names.
*/
public abstract Set getParameterNames();
/**
* 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 {@literal Map<String,Object>}.
*
*
Example:
*
*
* {
* "access_token" : "2YotnFZFEjr1zCsicMWpAA",
* "token_type" : "example",
* "expires_in" : 3600,
* "example_parameter" : "example_value"
* }
*
*
* @return The token parameters as a JSON object.
*/
public abstract JSONObject toJSONObject();
}