Spring Social Reference Manual

Craig Walls

Keith Donald

1.0.1.RELEASE

© SpringSource Inc., 2011


Table of Contents

1. Spring Social Overview
1.1. Introduction
1.2. Socializing applications
1.3. How to get
1.3.1. Client modules
1.4. Dependencies
1.4.1. Java
1.4.2. Java Servlet API
1.4.3. Spring Framework
1.4.4. Spring Security Crypto
1.4.5. Apache HttpComponents
1.4.6. Jackson JSON Processor
1.5. Sample Code
2. Service Provider 'Connect' Framework
2.1. Core API
2.2. Establishing connections
2.2.1. OAuth2 service providers
2.2.2. OAuth1 service providers
2.2.3. Registering ConnectionFactory instances
2.3. Persisting connections
2.3.1. JDBC-based persistence
3. Adding Support for a New Service Provider
3.1. Process overview
3.2. Creating a source project for the provider client code
3.2.1. Code structure guidelines
3.3. Developing a Java binding to the provider's API
3.3.1. Designing a new Java API binding
3.3.2. Implementing a new Java API binding
3.3.3. Testing a new Java API binding
3.3.4. Integrating an existing Java API binding
3.4. Creating a ServiceProvider model
3.4.1. OAuth2
3.4.2. OAuth1
3.5. Creating an ApiAdapter
3.6. Creating a ConnectionFactory
3.6.1. OAuth2
3.6.2. OAuth1
4. Connecting to Service Providers
4.1. Introduction
4.2. Configuring ConnectController
4.2.1. Configuring connection support in XML
4.3. Creating connections with ConnectController
4.3.1. Displaying a connection page
4.3.2. Initiating the connection flow
Authorization scope
4.3.3. Responding to the authorization callback
4.3.4. Disconnecting
4.4. Connection interceptors
5. Signing in with Service Provider Accounts
5.1. Introduction
5.2. Enabling provider sign in
5.2.1. ProviderSignInController's dependencies
5.2.2. Adding a provider sign in button
5.3. Signing up after a failed sign in
5.3.1. Signing up with a sign up form
5.3.2. Implicit sign up