play.libs

Class OAuth2

java.lang.Object

play.libs.OAuth2

public class OAuth2
extends Object

Library to access resources protected by OAuth 2.0. For OAuth 1.0a, see play.libs.OAuth. See the facebook-oauth2 example for usage.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OAuth2.Error
static class	OAuth2.Response

Field Summary

Fields

Modifier and Type	Field and Description
String	accessTokenURL
String	authorizationURL
String	clientid
String	secret

Constructor Summary

Constructors

Constructor and Description
OAuth2(String authorizationURL, String accessTokenURL, String clientid, String secret)

Method Summary

Modifier and Type	Method and Description
String	getAccessToken() Deprecated. Use @{link play.libs.OAuth2.retrieveAccessToken()} instead
static boolean	isCodeResponse()
void	requestAccessToken() Deprecated. Use @{link play.libs.OAuth2.retrieveVerificationCode()} instead
OAuth2.Response	retrieveAccessToken()
OAuth2.Response	retrieveAccessToken(String callbackURL)
void	retrieveVerificationCode()
void	retrieveVerificationCode(String callbackURL) First step of the OAuth2 process: redirects the user to the authorisation page
void	retrieveVerificationCode(String callbackURL, Map<String,String> parameters) First step of the oAuth2 process.
void	retrieveVerificationCode(String callbackURL, String parameterName, String parameterValue) First step of the oAuth2 process.

Methods inherited from class java.lang.Object

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

Field Detail

authorizationURL

public String authorizationURL

accessTokenURL

public String accessTokenURL

clientid

public String clientid

secret

public String secret

Constructor Detail

OAuth2

public OAuth2(String authorizationURL,
              String accessTokenURL,
              String clientid,
              String secret)

Method Detail

isCodeResponse

public static boolean isCodeResponse()

retrieveVerificationCode

public void retrieveVerificationCode(String callbackURL)

First step of the OAuth2 process: redirects the user to the authorisation page

Parameters:

callbackURL -

retrieveVerificationCode

public void retrieveVerificationCode(String callbackURL,
                                     String parameterName,
                                     String parameterValue)

First step of the oAuth2 process. This redirects the user to the authorization page on the oAuth2 provider. This is a helper method that only takes one parameter name,value pair and then converts them into a map to be used by retrieveVerificationCode(String, Map)

Parameters:

callbackURL - The URL to redirect the user to after authorization

parameterName - An additional parameter name

parameterValue - An additional parameter value

retrieveVerificationCode

public void retrieveVerificationCode(String callbackURL,
                                     Map<String,String> parameters)

First step of the oAuth2 process. This redirects the user to the authorisation page on the oAuth2 provider.

Parameters:

callbackURL - The URL to redirect the user to after authorisation

parameters - Any additional parameters that weren't included in the constructor. For example you might need to add a response_type.

retrieveVerificationCode

public void retrieveVerificationCode()

retrieveAccessToken

public OAuth2.Response retrieveAccessToken(String callbackURL)

retrieveAccessToken

public OAuth2.Response retrieveAccessToken()

requestAccessToken

@Deprecated
public void requestAccessToken()

Deprecated. Use @{link play.libs.OAuth2.retrieveVerificationCode()} instead

getAccessToken

@Deprecated
public String getAccessToken()

Deprecated. Use @{link play.libs.OAuth2.retrieveAccessToken()} instead