SeamFramework.orgCommunity Documentation
Provides CDI Beans and extensions to interact with major social network.
Provides:
OAuth connectors to authentify with an OAuth providers
Support for Authentication for Twitter, LinkedIn and Facebook only right now
Status update for Facebook Twitter and LinkedIn
Support for multi-account (multi-service and multi session for the same service)
Seam Social is independent of CDI implementation and fully portable between Java EE 6 and Servlet environments enhanced with CDI. It can be also used with CDI in JSE (desktop application). It is build on top of scribe-java from fernandezpablo85
For more information, see the Seam Social project page.
mvn -Pweld-ee-embedded-1.1 clean install
you need to be connected to internet to launch the tests. You can build without the tests like that :
mvn clean install -DskipTests=true
The Web example app is quite simple and give a good idea of possibilities of Seam Social Framework.
Main steps 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 OAuthService bean and init 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 on https://dev.twitter.com/apps/new). The declaration of an application contains at least :
an API public key
an API private/secret key
To use an OAuth service bean in Seam social you need to provide these configuration information in two ways :
thru an OAuthConfigSettings bean
by adding the @ConfigureOAuth annotation when injecting the OAuth service bean
Right now, Seam Social provides only one convenient way to declare an OAuthConfigSettings bean. It can be done thru Seam configuration file (beans.xml). Here is an example of such a configuration :
<beans xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:s="urn:java:ee"
xmlns:o="urn:java:org.jboss.seam.social.core">
<o:OAuthServiceSettingsImpl>
<s:modifies />
<o:RelatedTo>Twitter</o:RelatedTo>
<o:apiKey>FQzlQC49UhvbMZoxUIvHTQ</o:apiKey>
<o:apiSecret>VQ5CZHG4qUoAkUUmckPn4iN4yyjBKcORTW0wnok4r1k
</o:apiSecret>
<o:callback>http://localhost:8080/social-web-client/callback.jsf
</o:callback>
</o:OAuthServiceSettingsImpl>
</beans>
Api Key and Api secret is provided by the service you want to consume (here Twitter). You can use the values above since they're coming from "Seam Social" Twitter application. Callback depends on your application : it's the URL that will collect OAuth verifier
You can simply add the @ConfigureOAuth annotation to the injection point. It can be done like that :
@Inject @ConfigureOAuth(apiKey = "FQzlQC49UhvbMZoxUIvHTQ", apiSecret = "VQ5CZHG4qUoAkUUmckPn4iN4yyjBKcORTW0wnok4r1k", callback="http://localhost:8080/social-web-client/callback.jsf") Twitter twitter;
With this notation the injected bean is configured with the given OAuth values.
Using the Interface of the service
@Named
@SessionScoped
public class mySessionBean implements Serializable {
...
@Inject
public Twitter twitter;
...
}
or using the generic OAuthService with a Qualifier
@Named
@SessionScoped
public class mySessionBean implements Serializable {
...
@Inject
@RelatedTo("Twitter")
OAuthService service;
...
}
The two are equivalent but the second one give you a way to do polymorphic calls to the service. The OAuthService provides methods in relation to authentication.
If we go on with the same example, we can get this authorization URL with this call :
twitter.getAuthorizationUrl();
It will return the URL needed to initiate connection to the service.
When we return from the service connection to the callback URL, we get a verifier that we need to store in the OAuthService and init the access token In JSF we do this like that
<f:metadata>
<f:viewParam name="#{mySessionBean.twitter.verifierParamName}"
value="#{mySessionBean.twitter.verifier}"
required="true"
requiredMessage="Error with Twitter. Retry later"/>
<f:event type="preRenderView"
listener="#{mySessionBean.twitter.initAccessToken()}"/>
</f:metadata>
Getting the Twitter user profile
TwitterProfile user = twitter.getMyProfile(); String fullName = user.getFullName();