Chapter 83. Seam Social Qualifiers and Beans

Each OAuth Application needs a specific qualifier bearing the @ServiceRelated Meta annotation. Out of the box Seam Social provides one default OAuth application qualifier for each social services provides (@Twitter, @LinkedIn, @Facebook). Should you need to support more than one application for a given service, you’d have to create a new service related qualifier (@TwitterMyApp for instance). Please refer to the "Extending Seam Social" section to learn more about this. Those qualifiers will be used on all the bean attached to a given OAuth application. They are useful to avoid ambiguous injection in the generic part of the API :

@Inject
@Twitter
OAuthService twiterService;

and

@Inject
@Facebook
OAuthService fbService;

Inject two different beans implementing the same interface (OAuthService).

83.2. Basic JSON Beans

JSON exchanges are managed by two beans:

JsonMapper which deals with the implementation of JSON parser (Right now Jackson)
JsonService which has a higher function and uses JsonMapper to provide decoupling from the Json parser.

83.3. Beans created by @OAuthApplication

Seam social uses the Generic bean functionality provided by Solder. Thus when you write :

    @OAuthApplication(apiKey = "FQzlQC49UhvbMZoxUIvHTQ", 
            apiSecret = "VQ5CZHG4qUoAkUUmckPn4iN4yyjBKcORTW0wnok4r1k")
    @Twitter
    @Produces
    TwitterService twitterServiceProducer(TwitterService ts) {
        return ts;
    }

The Generic extension creates the followings CDI beans with the same qualifier as the produced services (@Twitter in the example above) for you :

OAuthService : the producer creates this first bean. It’s the center of all OAuth exchange. Calling basic function in OAuthProvider it uses Settings to initiate connection and then uses Session information and JSon Mapper bean to transform exchange to and from object.
OAuthServiceSettings : this bean has the same scope than the service and contains all the configuration of the OAuth Application plus the Service Related Qualifier of the service.
OAuthProvider : this bean has the same scope than the service. It contains all the basic function to deal with OAuth exchange like the creation of tokens and request signatures. Its main purpose is to deal with implementation of OAuth management library (right now Scribe).
OAuthSession : this session scoped bean contains all the OAuth Information needed to interact with remote service. Mainly the AccessToken.

Chapter 83. Seam Social Qualifiers and Beans

83.1. Service Qualifiers

83.2. Basic JSON Beans

83.3. Beans created by @OAuthApplication