public class RefreshTokenRequest extends TokenRequest
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 refreshAccessToken() throws IOException { try { TokenResponse response = new RefreshTokenRequest(new NetHttpTransport(), new GsonFactory(), new GenericUrl( "https://server.example.com/token"), "tGzv3JOkF0XG5Qx2TlKWIA") .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.
GenericData.Flags
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
responseClass
Constructor and Description |
---|
RefreshTokenRequest(HttpTransport transport,
JsonFactory jsonFactory,
GenericUrl tokenServerUrl,
String refreshToken) |
Modifier and Type | Method and Description |
---|---|
String |
getRefreshToken()
Returns the refresh token issued to the client.
|
RefreshTokenRequest |
set(String fieldName,
Object value) |
RefreshTokenRequest |
setClientAuthentication(HttpExecuteInterceptor clientAuthentication)
Sets the client authentication or
null for none. |
RefreshTokenRequest |
setGrantType(String grantType)
Sets the grant type (
"authorization_code" , "password" , "client_credentials" , "refresh_token" or absolute URI of the extension grant type). |
RefreshTokenRequest |
setRefreshToken(String refreshToken)
Sets the refresh token issued to the client.
|
RefreshTokenRequest |
setRequestInitializer(HttpRequestInitializer requestInitializer)
Sets the HTTP request initializer or
null for none. |
RefreshTokenRequest |
setResponseClass(Class<? extends TokenResponse> responseClass)
Sets the TokenResponse class to allow specifying object parsing.
|
RefreshTokenRequest |
setScopes(Collection<String> scopes)
Sets the list of scopes (as specified in Access Token Scope) or
null
for none. |
RefreshTokenRequest |
setTokenServerUrl(GenericUrl tokenServerUrl)
Sets the token server URL.
|
execute, executeUnparsed, getClientAuthentication, getGrantType, getJsonFactory, getRequestInitializer, getResponseClass, getScopes, getTokenServerUrl, getTransport
clone, entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys, toString
clear, containsKey, containsValue, isEmpty, keySet, size, values
finalize, getClass, notify, notifyAll, wait, wait, wait
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll
public RefreshTokenRequest(HttpTransport transport, JsonFactory jsonFactory, GenericUrl tokenServerUrl, String refreshToken)
transport
- HTTP transportjsonFactory
- JSON factorytokenServerUrl
- token server URLrefreshToken
- refresh token issued to the clientpublic RefreshTokenRequest setRequestInitializer(HttpRequestInitializer requestInitializer)
TokenRequest
null
for none.
Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.
setRequestInitializer
in class TokenRequest
public RefreshTokenRequest setTokenServerUrl(GenericUrl tokenServerUrl)
TokenRequest
Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.
setTokenServerUrl
in class TokenRequest
public RefreshTokenRequest setScopes(Collection<String> scopes)
TokenRequest
null
for none.
Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.
setScopes
in class TokenRequest
scopes
- collection of scopes to be joined by a space separator (or a single value
containing multiple space-separated scopes)public RefreshTokenRequest setGrantType(String grantType)
TokenRequest
"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.
setGrantType
in class TokenRequest
public RefreshTokenRequest setClientAuthentication(HttpExecuteInterceptor clientAuthentication)
TokenRequest
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.
setClientAuthentication
in class TokenRequest
public RefreshTokenRequest setResponseClass(Class<? extends TokenResponse> responseClass)
TokenRequest
setResponseClass
in class TokenRequest
responseClass
- The response class returned by TokenRequest.execute()
.public final String getRefreshToken()
public RefreshTokenRequest setRefreshToken(String refreshToken)
Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.
public RefreshTokenRequest set(String fieldName, Object value)
set
in class TokenRequest
Copyright © 2011–2021 Google. All rights reserved.