com.nimbusds.oauth2.sdk

Class TokenRequest

java.lang.Object

com.nimbusds.oauth2.sdk.AbstractRequest

com.nimbusds.oauth2.sdk.TokenRequest

All Implemented Interfaces:

Message, Request

@Immutable
public class TokenRequest
extends AbstractRequest

Token request. Used to obtain an access token and an optional refresh token at the Token endpoint of the authorisation server.

Example token request with an authorisation code grant:

 POST /token HTTP/1.1
 Host: server.example.com
 Content-Type: application/x-www-form-URIencoded
 Authorization: Basic czZCaGRSa3F0MzpnWDFmQmF0M2JW
 
 grant_type=authorization_code
 &code=SplxlOBeZQQYbYS6WxSbIA
 &redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb
 

Related specifications:

• OAuth 2.0 (RFC 6749), sections 4.1.3, 4.3.2, 4.4.2 and 6.

Constructor Summary

Constructors

Constructor and Description
TokenRequest(URI uri, ClientAuthentication clientAuth, AuthorizationGrant authzGrant) Creates a new token request.

Method Summary

Methods

Modifier and Type	Method and Description
AuthorizationGrant	getAuthorizationGrant() Gets the authorisation grant.
ClientAuthentication	getClientAuthentication() Gets the client authentication.
static TokenRequest	parse(HTTPRequest httpRequest) Parses the specified HTTP request for a token request.
HTTPRequest	toHTTPRequest() Returns the matching HTTP request.

Methods inherited from class com.nimbusds.oauth2.sdk.AbstractRequest

getEndpointURI

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TokenRequest

public TokenRequest(URI uri,
            ClientAuthentication clientAuth,
            AuthorizationGrant authzGrant)

Creates a new token request.

Parameters:

uri - The URI of the token endpoint. May be null if the toHTTPRequest() method will not be used.

clientAuth - The client authentication, null if none.

authzGrant - The authorisation grant. Must not be null.

Method Detail

getClientAuthentication

public ClientAuthentication getClientAuthentication()

Gets the client authentication.

Returns:

The client authentication, null if none.

getAuthorizationGrant

public AuthorizationGrant getAuthorizationGrant()

Gets the authorisation grant.

Returns:

The authorisation grant.

toHTTPRequest

public HTTPRequest toHTTPRequest()
                          throws SerializeException

Description copied from interface: Request

Returns the matching HTTP request.

Returns:

The HTTP request.

Throws:

SerializeException - If the request message couldn't be serialised to an HTTP request.

parse

public static TokenRequest parse(HTTPRequest httpRequest)
                          throws ParseException

Parses the specified HTTP request for a token request.

Parameters:

httpRequest - The HTTP request. Must not be null.

Returns:

The token request.

Throws:

ParseException - If the HTTP request couldn't be parsed to a token request.