org.pac4j.oauth.client

Class PayPalClient

java.lang.Object

org.pac4j.core.util.InitializableObject

org.pac4j.core.client.BaseClient<OAuthCredentials,U>

org.pac4j.oauth.client.BaseOAuthClient<U>

org.pac4j.oauth.client.BaseOAuth20Client<PayPalProfile>

org.pac4j.oauth.client.PayPalClient

All Implemented Interfaces:

Cloneable, Client<OAuthCredentials,PayPalProfile>

public class PayPalClient
extends BaseOAuth20Client<PayPalProfile>

This class is the OAuth client to authenticate users in PayPal.

By default, the following scope is requested to PayPal : openid profile email address.

The scope can be defined to require permissions from the user and retrieve attributes from PayPal, by using the setScope(String) method.

It returns a PayPalProfile.

More information at https://developer.paypal.com/webapps/developer/docs/integration/direct/log-in-with-paypal/detailed/

Since:

1.4.2

Author:

Jerome Leleu

See Also:

PayPalProfile

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SCOPE
protected String	scope

Fields inherited from class org.pac4j.oauth.client.BaseOAuth20Client

logger, OAUTH_CODE

Fields inherited from class org.pac4j.oauth.client.BaseOAuthClient

connectTimeout, key, proxyHost, proxyPort, readTimeout, secret, service, tokenAsHeader

Fields inherited from class org.pac4j.core.client.BaseClient

ATTEMPTED_AUTHENTICATION_SUFFIX, callbackUrl, NEEDS_CLIENT_REDIRECTION_PARAMETER

Constructor Summary

Constructors

Constructor and Description
PayPalClient()
PayPalClient(String key, String secret)

Method Summary

Modifier and Type	Method and Description
protected PayPalProfile	extractUserProfile(String body) Extract the user profile from the response (JSON, XML...) of the profile url.
protected String	getProfileUrl(org.scribe.model.Token accessToken) Retrieve the url of the profile of the authenticated user for the provider.
String	getScope()
protected boolean	hasBeenCancelled(WebContext context) Return if the authentication has been cancelled.
protected void	internalInit()
protected PayPalClient	newClient()
protected boolean	requiresStateParameter() Return if this client requires a state parameter.
void	setScope(String scope)

Methods inherited from class org.pac4j.oauth.client.BaseOAuth20Client

getAccessToken, getOAuthCredentials, getStateParameter, isDirectRedirection, retrieveAuthorizationUrl

Methods inherited from class org.pac4j.oauth.client.BaseOAuthClient

addAccessTokenToProfile, clone, createProxyRequest, getConnectTimeout, getKey, getMechanism, getProxyHost, getProxyPort, getReadTimeout, getSecret, getUserProfile, isTokenAsHeader, retrieveCredentials, retrieveRedirectAction, retrieveUserProfile, retrieveUserProfileFromToken, sendRequestForData, sendRequestForData, setConnectTimeout, setKey, setProxyHost, setProxyPort, setReadTimeout, setSecret, setTokenAsHeader

Methods inherited from class org.pac4j.core.client.BaseClient

addAuthorizationGenerator, getAuthenticator, getAuthorizationGenerators, getCallbackUrl, getContextualCallbackUrl, getCredentials, getName, getProfileCreator, getRedirectAction, getRedirectionUrl, getUserProfile, isEnableContextualRedirects, isIncludeClientNameInCallbackUrl, prependHostToUrlIfNotPresent, redirect, setAuthenticator, setAuthorizationGenerator, setAuthorizationGenerators, setCallbackUrl, setEnableContextualRedirects, setIncludeClientNameInCallbackUrl, setName, setProfileCreator, toString

Methods inherited from class org.pac4j.core.util.InitializableObject

init, reinit

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SCOPE

public static final String DEFAULT_SCOPE

See Also:

Constant Field Values

scope

protected String scope

Constructor Detail

PayPalClient

public PayPalClient()

PayPalClient

public PayPalClient(String key,
                    String secret)

Method Detail

newClient

protected PayPalClient newClient()

Specified by:

newClient in class BaseClient<OAuthCredentials,PayPalProfile>

internalInit

protected void internalInit()

Overrides:

internalInit in class BaseOAuthClient<PayPalProfile>

getProfileUrl

protected String getProfileUrl(org.scribe.model.Token accessToken)

Description copied from class: BaseOAuthClient

Retrieve the url of the profile of the authenticated user for the provider.

Specified by:

getProfileUrl in class BaseOAuthClient<PayPalProfile>

Parameters:

accessToken - only used when constructing dynamic urls from data in the token

Returns:

the url of the user profile given by the provider

extractUserProfile

protected PayPalProfile extractUserProfile(String body)

Description copied from class: BaseOAuthClient

Extract the user profile from the response (JSON, XML...) of the profile url.

Specified by:

extractUserProfile in class BaseOAuthClient<PayPalProfile>

Parameters:

body - the response body

Returns:

the user profile object

getScope

public String getScope()

setScope

public void setScope(String scope)

requiresStateParameter

protected boolean requiresStateParameter()

Description copied from class: BaseOAuth20Client

Return if this client requires a state parameter.

Specified by:

requiresStateParameter in class BaseOAuth20Client<PayPalProfile>

Returns:

if this client requires a state parameter.

hasBeenCancelled

protected boolean hasBeenCancelled(WebContext context)

Description copied from class: BaseOAuthClient

Return if the authentication has been cancelled.

Specified by:

hasBeenCancelled in class BaseOAuthClient<PayPalProfile>

Parameters:

context - the web context.

Returns:

if the authentication has been cancelled.