SeamFramework.orgCommunity Documentation

Seam Social Module

Reference Guide


The Web example app is quite simple and gives a good idea of the possibilities with Seam Social. The main steps you need to take to use Seam Social are:

  • Declare an OAuth configuration
  • Inject an OAuthService bean
  • Request the Authorization URL for the service and get a request token
  • Store the verifier in the OAuthService bean and initialize the access token
  • Use the service

Should you need to fully understand each step, the complete OAuth lifecycle can be found here or here.

To consume an OAuth service you need to declare an application on the service platform (i.e. for Twitter you can do this at https://dev.twitter.com/apps/new. The declaration of an application is done with the @OAuthApplication annotation which must contain at least:

  • An OAuth API public key
  • An OAuth API private/secret key

If you don't know what this is about, please refer to the OAuth concepts in your service documentation.

To use an OAuth Service Bean in Seam Social you need to provide the following configuration information by producing the right OAuthService bean:

  • Via a producer method or subclassing
  • Via an XML configuration (Using Solder's bean configuration feature).