Package com.nimbusds.oauth2.sdk

Class AuthorizationRequest.Builder

java.lang.Object

com.nimbusds.oauth2.sdk.AuthorizationRequest.Builder

Enclosing class:

AuthorizationRequest

public static class AuthorizationRequest.Builder
extends Object

Builder for constructing authorisation requests.

Constructor Summary

Constructors

Constructor	Description
Builder(AuthorizationRequest request)	Creates a new authorisation request builder from the specified request.
Builder(ResponseType rt, ClientID clientID)	Creates a new authorisation request builder.

Method Summary

Modifier and Type	Method	Description
AuthorizationRequest	build()	Builds a new authorisation request.
AuthorizationRequest.Builder	codeChallenge(CodeChallenge codeChallenge, CodeChallengeMethod codeChallengeMethod)	Deprecated.
AuthorizationRequest.Builder	codeChallenge(CodeVerifier codeVerifier, CodeChallengeMethod codeChallengeMethod)	Sets the code challenge for Proof Key for Code Exchange (PKCE) by public OAuth clients.
AuthorizationRequest.Builder	customParameter(String name, String value)	Sets the specified additional custom parameter.
AuthorizationRequest.Builder	endpointURI(URI uri)	Sets the URI of the endpoint (HTTP or HTTPS) for which the request is intended.
AuthorizationRequest.Builder	redirectionURI(URI redirectURI)	Sets the redirection URI.
AuthorizationRequest.Builder	responseMode(ResponseMode rm)	Sets the response mode.
AuthorizationRequest.Builder	scope(Scope scope)	Sets the scope.
AuthorizationRequest.Builder	state(State state)	Sets the state.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder(ResponseType rt,
               ClientID clientID)

Creates a new authorisation request builder.

Parameters:

rt - The response type. Corresponds to the response_type parameter. Must not be null.

clientID - The client identifier. Corresponds to the client_id parameter. Must not be null.

Builder

public Builder(AuthorizationRequest request)

Creates a new authorisation request builder from the specified request.

Parameters:

request - The authorisation request. Must not be null.

Method Detail

redirectionURI

public AuthorizationRequest.Builder redirectionURI(URI redirectURI)

Sets the redirection URI. Corresponds to the optional redirection_uri parameter.

Parameters:

redirectURI - The redirection URI, null if not specified.

Returns:

This builder.

scope

public AuthorizationRequest.Builder scope(Scope scope)

Sets the scope. Corresponds to the optional scope parameter.

Parameters:

scope - The scope, null if not specified.

Returns:

This builder.

state

public AuthorizationRequest.Builder state(State state)

Sets the state. Corresponds to the recommended state parameter.

Parameters:

state - The state, null if not specified.

Returns:

This builder.

responseMode

public AuthorizationRequest.Builder responseMode(ResponseMode rm)

Sets the response mode. Corresponds to the optional response_mode parameter. Use of this parameter is not recommended unless a non-default response mode is requested (e.g. form_post).

Parameters:

rm - The response mode, null if not specified.

Returns:

This builder.

codeChallenge

@Deprecated
public AuthorizationRequest.Builder codeChallenge(CodeChallenge codeChallenge,
                                                  CodeChallengeMethod codeChallengeMethod)

Deprecated.

Sets the code challenge for Proof Key for Code Exchange (PKCE) by public OAuth clients.

Parameters:

codeChallenge - The code challenge, null if not specified.

codeChallengeMethod - The code challenge method, null if not specified.

Returns:

This builder.

codeChallenge

public AuthorizationRequest.Builder codeChallenge(CodeVerifier codeVerifier,
                                                  CodeChallengeMethod codeChallengeMethod)

Sets the code challenge for Proof Key for Code Exchange (PKCE) by public OAuth clients.

Parameters:

codeVerifier - The code verifier to use to compute the code challenge, null if PKCE is not specified.

codeChallengeMethod - The code challenge method, null if not specified. Defaults to CodeChallengeMethod.PLAIN if a code verifier is specified.

Returns:

This builder.

customParameter

public AuthorizationRequest.Builder customParameter(String name,
                                                    String value)

Sets the specified additional custom parameter.

Parameters:

name - The parameter name. Must not be null.

value - The parameter value, null if not specified.

Returns:

This builder.

endpointURI

public AuthorizationRequest.Builder endpointURI(URI uri)

Sets the URI of the endpoint (HTTP or HTTPS) for which the request is intended.

Parameters:

uri - The endpoint URI, null if not specified.

Returns:

This builder.

build

public AuthorizationRequest build()

Builds a new authorisation request.

Returns:

The authorisation request.