com.google.api.client.auth.oauth2

Class PasswordTokenRequest

java.lang.Object

java.util.AbstractMap<String,Object>

com.google.api.client.util.GenericData

com.google.api.client.auth.oauth2.TokenRequest

com.google.api.client.auth.oauth2.PasswordTokenRequest

All Implemented Interfaces:

Cloneable, Map<String,Object>

public class PasswordTokenRequest
extends TokenRequest

OAuth 2.0 request for an access token using the user's username and password as specified in Resource Owner Password Credentials Grant.

Use Credential to access protected resources from the resource server using the TokenResponse returned by TokenRequest.execute(). On error, it will instead throw TokenResponseException.

Sample usage:

  static void requestAccessToken() throws IOException {
    try {
      TokenResponse response =
          new PasswordTokenRequest(new NetHttpTransport(), new JacksonFactory(),
              new GenericUrl("https://server.example.com/token"), "johndoe", "A3ddj3w")
              .setRedirectUri("https://client.example.com/rd")
              .setClientAuthentication(
                  new BasicAuthentication("s6BhdRkqt3", "7Fjfp0ZBr1KtDRbnfVdmIw")).execute();
      System.out.println("Access token: " + response.getAccessToken());
    } catch (TokenResponseException e) {
      if (e.getDetails() != null) {
        System.err.println("Error: " + e.getDetails().getError());
        if (e.getDetails().getErrorDescription() != null) {
          System.err.println(e.getDetails().getErrorDescription());
        }
        if (e.getDetails().getErrorUri() != null) {
          System.err.println(e.getDetails().getErrorUri());
        }
      } else {
        System.err.println(e.getMessage());
      }
    }
  }
 

Some OAuth 2.0 providers don't support BasicAuthentication but instead support ClientParametersAuthentication. In the above sample code, simply replace the class name and it will work the same way.

Implementation is not thread-safe.

Since:

1.14

Author:

Yaniv Inbar

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

GenericData.Flags

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields inherited from class com.google.api.client.auth.oauth2.TokenRequest

responseClass

Constructor Summary

Constructors

Constructor and Description
PasswordTokenRequest(HttpTransport transport, JsonFactory jsonFactory, GenericUrl tokenServerUrl, String username, String password)

Method Summary

Modifier and Type	Method and Description
String	getPassword() Returns the resource owner password.
String	getUsername() Returns the resource owner username.
PasswordTokenRequest	set(String fieldName, Object value)
PasswordTokenRequest	setClientAuthentication(HttpExecuteInterceptor clientAuthentication) Sets the client authentication or null for none.
PasswordTokenRequest	setGrantType(String grantType) Sets the grant type ("authorization_code", "password", "client_credentials", "refresh_token" or absolute URI of the extension grant type).
PasswordTokenRequest	setPassword(String password) Sets the resource owner password.
PasswordTokenRequest	setRequestInitializer(HttpRequestInitializer requestInitializer) Sets the HTTP request initializer or null for none.
PasswordTokenRequest	setResponseClass(Class<? extends TokenResponse> responseClass) Sets the TokenResponse class to allow specifying object parsing.
PasswordTokenRequest	setScopes(Collection<String> scopes) Sets the list of scopes (as specified in Access Token Scope) or null for none.
PasswordTokenRequest	setTokenServerUrl(GenericUrl tokenServerUrl) Sets the token server URL.
PasswordTokenRequest	setUsername(String username) Sets the resource owner username.

Methods inherited from class com.google.api.client.auth.oauth2.TokenRequest

execute, executeUnparsed, getClientAuthentication, getGrantType, getJsonFactory, getRequestInitializer, getResponseClass, getScopes, getTokenServerUrl, getTransport

Methods inherited from class com.google.api.client.util.GenericData

clone, entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys, toString

Methods inherited from class java.util.AbstractMap

clear, containsKey, containsValue, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

PasswordTokenRequest

public PasswordTokenRequest(HttpTransport transport,
                            JsonFactory jsonFactory,
                            GenericUrl tokenServerUrl,
                            String username,
                            String password)

Parameters:

transport - HTTP transport

jsonFactory - JSON factory

tokenServerUrl - token server URL

username - resource owner username

password - resource owner password

Method Detail

setRequestInitializer

public PasswordTokenRequest setRequestInitializer(HttpRequestInitializer requestInitializer)

Description copied from class: TokenRequest

Sets the HTTP request initializer or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setRequestInitializer in class TokenRequest

setTokenServerUrl

public PasswordTokenRequest setTokenServerUrl(GenericUrl tokenServerUrl)

Description copied from class: TokenRequest

Sets the token server URL.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setTokenServerUrl in class TokenRequest

setScopes

public PasswordTokenRequest setScopes(Collection<String> scopes)

Description copied from class: TokenRequest

Sets the list of scopes (as specified in Access Token Scope) or null for none.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setScopes in class TokenRequest

Parameters:

scopes - collection of scopes to be joined by a space separator (or a single value containing multiple space-separated scopes)

setGrantType

public PasswordTokenRequest setGrantType(String grantType)

Description copied from class: TokenRequest

Sets the grant type ("authorization_code", "password", "client_credentials", "refresh_token" or absolute URI of the extension grant type).

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setGrantType in class TokenRequest

setClientAuthentication

public PasswordTokenRequest setClientAuthentication(HttpExecuteInterceptor clientAuthentication)

Description copied from class: TokenRequest

Sets the client authentication or null for none.

The recommended initializer by the specification is BasicAuthentication. All authorization servers must support that. A common alternative is ClientParametersAuthentication. An alternative client authentication method may be provided that implements HttpRequestInitializer.

This HTTP request execute interceptor is guaranteed to be the last execute interceptor before the request is executed, and after any execute interceptor set by the TokenRequest.getRequestInitializer().

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Overrides:

setClientAuthentication in class TokenRequest

setResponseClass

public PasswordTokenRequest setResponseClass(Class<? extends TokenResponse> responseClass)

Description copied from class: TokenRequest

Sets the TokenResponse class to allow specifying object parsing.

Overrides:

setResponseClass in class TokenRequest

Parameters:

responseClass - The response class returned by TokenRequest.execute().

getUsername

public final String getUsername()

Returns the resource owner username.

setUsername

public PasswordTokenRequest setUsername(String username)

Sets the resource owner username.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

getPassword

public final String getPassword()

Returns the resource owner password.

setPassword

public PasswordTokenRequest setPassword(String password)

Sets the resource owner password.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

set

public PasswordTokenRequest set(String fieldName,
                                Object value)

Overrides:

set in class TokenRequest