org.springframework.social.connect.support
Class OAuth1Connection<A>

java.lang.Object
  org.springframework.social.connect.support.AbstractConnection<A>
      org.springframework.social.connect.support.OAuth1Connection<A>

Type Parameters:

A - the service API type

All Implemented Interfaces:

Connection<A>

public class OAuth1Connection<A>
extends AbstractConnection<A>

An OAuth1-based Connection implementation. In general, this implementation is expected to be suitable for all OAuth1-based providers and should not require subclassing. Subclasses of OAuth1ConnectionFactory should be favored to encapsulate details specific to an OAuth1-based provider.

Author:

Keith Donald

See Also:

OAuth1ConnectionFactory

Constructor Summary

OAuth1Connection(ConnectionData data, OAuth1ServiceProvider<A> serviceProvider, ApiAdapter<A> apiAdapter)
Creates a new OAuth1Connection from the data provided.

OAuth1Connection(java.lang.String providerId, java.lang.String providerUserId, java.lang.String accessToken, java.lang.String secret, OAuth1ServiceProvider<A> serviceProvider, ApiAdapter<A> apiAdapter)
Creates a new OAuth1Connection from a OAuth1 access token response.

Method Summary

ConnectionData	createData() Creates a data transfer object that can be used to persist the state of this connection.
A	getApi() A Java binding to the service provider's native API.

Methods inherited from class org.springframework.social.connect.support.AbstractConnection

equals, fetchUserProfile, getDisplayName, getImageUrl, getKey, getMonitor, getProfileUrl, hasExpired, hashCode, initKey, refresh, sync, test, updateStatus

Methods inherited from class java.lang.Object

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

Constructor Detail

OAuth1Connection

public OAuth1Connection(java.lang.String providerId,
                        java.lang.String providerUserId,
                        java.lang.String accessToken,
                        java.lang.String secret,
                        OAuth1ServiceProvider<A> serviceProvider,
                        ApiAdapter<A> apiAdapter)

Creates a new OAuth1Connection from a OAuth1 access token response. Designed to be called to establish a new OAuth1Connection after receiving an access token response successfully. The providerUserId may be null in this case: if so, this constructor will try to resolve it using the service API obtained from the OAuth1ServiceProvider.

Parameters:

providerId - the provider id e.g. "twitter"

providerUserId - the provider user ID (may be null if not returned as part of the access token response)

accessToken - the granted access token

secret - the access token secret (OAuth1-specific)

serviceProvider - the OAuth1-based ServiceProvider

apiAdapter - the ApiAdapter for the ServiceProvider

OAuth1Connection

public OAuth1Connection(ConnectionData data,
                        OAuth1ServiceProvider<A> serviceProvider,
                        ApiAdapter<A> apiAdapter)

Creates a new OAuth1Connection from the data provided. Designed to be called when re-constituting an existing Connection using ConnectionData.

Parameters:

data - the data holding the state of this connection

serviceProvider - the OAuth1-based ServiceProvider

apiAdapter - the ApiAdapter for the ServiceProvider

Method Detail

getApi

public A getApi()

Description copied from interface: Connection

A Java binding to the service provider's native API.

Specified by:

getApi in interface Connection<A>

Specified by:

getApi in class AbstractConnection<A>

createData

public ConnectionData createData()

Description copied from interface: Connection

Creates a data transfer object that can be used to persist the state of this connection. Used to support the transfer of connection state between layers of the application, such as to the database layer.

Specified by:

createData in interface Connection<A>

Specified by:

createData in class AbstractConnection<A>