org.pac4j.oauth.client

Class TwitterClient

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.BaseOAuth10Client<TwitterProfile>

org.pac4j.oauth.client.TwitterClient

All Implemented Interfaces:

Cloneable, Client<OAuthCredentials,TwitterProfile>

public class TwitterClient
extends BaseOAuth10Client<TwitterProfile>

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

You can define if a screen should always been displayed for authorization confirmation by using the setAlwaysConfirmAuthorization(boolean) method (false by default).

It returns a TwitterProfile.

More information at https://dev.twitter.com/docs/api/1/get/account/verify_credentials

Since:

1.0.0

Author:

Jerome Leleu

See Also:

TwitterProfile

Field Summary

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

logger, OAUTH_TOKEN, OAUTH_VERIFIER, REQUEST_TOKEN

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
TwitterClient()
TwitterClient(String key, String secret)

Method Summary

Methods

Modifier and Type	Method and Description
protected TwitterProfile	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.
protected boolean	hasBeenCancelled(WebContext context) Return if the authentication has been cancelled.
protected void	internalInit()
boolean	isAlwaysConfirmAuthorization()
protected TwitterClient	newClient()
void	setAlwaysConfirmAuthorization(boolean alwaysConfirmAuthorization)

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

addAccessTokenToProfile, getAccessToken, getOAuthCredentials, getRequestTokenSessionAttributeName, isDirectRedirection, retrieveAuthorizationUrl

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

clone, createProxyRequest, getConnectTimeout, getKey, getProtocol, 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, getAuthorizationGenerators, getCallbackUrl, getContextualCallbackUrl, getCredentials, getName, getRedirectAction, getRedirectionUrl, getUserProfile, isEnableContextualRedirects, prependHostToUrlIfNotPresent, redirect, setAuthorizationGenerator, setAuthorizationGenerators, setCallbackUrl, setEnableContextualRedirects, setName, 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

Constructor Detail

TwitterClient

public TwitterClient()

TwitterClient

public TwitterClient(String key,
             String secret)

Method Detail

newClient

protected TwitterClient newClient()

Specified by:

newClient in class BaseClient<OAuthCredentials,TwitterProfile>

internalInit

protected void internalInit()

Overrides:

internalInit in class BaseOAuthClient<TwitterProfile>

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<TwitterProfile>

Parameters:

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

Returns:

the url of the user profile given by the provider

hasBeenCancelled

protected boolean hasBeenCancelled(WebContext context)

Description copied from class: BaseOAuthClient

Return if the authentication has been cancelled.

Specified by:

hasBeenCancelled in class BaseOAuthClient<TwitterProfile>

Parameters:

context - the web context.

Returns:

if the authentication has been cancelled.

extractUserProfile

protected TwitterProfile 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<TwitterProfile>

Returns:

the user profile object

isAlwaysConfirmAuthorization

public boolean isAlwaysConfirmAuthorization()

setAlwaysConfirmAuthorization

public void setAlwaysConfirmAuthorization(boolean alwaysConfirmAuthorization)