Na última semana a SpringSource liberou o primeiro milestone do Spring Social, uma extensão do framework Spring para permitir o acesso a sites de redes sociais em aplicações Java.
O primeiro milestone inclui templates para Twitter, Facebook, LinkedIn e Tripit. Ao invés de expor uma API genérica baseada em URLs, a API SpringSocial é projetada especificamente para cada site de redes sociais e torna a integração com os sites muito simples. Cada template, por sua vez, é construído sobre o RestTemplate que é um template genérico para acesso a qualquer WebService baseado em REST.
Para usar o Spring Social é preciso:
- Registrar manualmente uma conta de desenvolvimento em cada site de rede social a ser utilizado, obtendo uma chave única para a aplicação;
- Através da aplicação requisitar um token OAuth para cada novo usuário;
- Instanciar o template Spring Social desejado (ex: TwitterTemplate), passando como parâmetro a chave única da aplicação e o token OAuth do usuário corrente;
- Chamar qualquer método disponível no template Spring Social, assim como se costuma fazer chamando métodos do template JdbcTemplate.
Uma vez autorizado, o código necessário para manipular dado site de rede social é quase trivial, como mostra o exemplo a seguir para buscar as conexões do usuário no LinkedIn:
LinkedInTemplate template = new LinkedInTemplate(developerApiKey, developerSecret, oauthAccessTokenValue, oauthAccessTokenSecret);
List <linkedinprofile> connections = template.getConnections();
A parte mais complexa é a autorização OAuth. A SpringSource criou uma implementação de referência chamada Greenhouse para demonstrar como usar a API. O site Greenhouse tem alguns códigos de exemplo que demonstram as requisições de tokens OAuth e a conexão para cada provedor, além disso um excelente tutorial de Spring Social foi escrito por Jettro Coenradie e deve ser mais fácil de acompanhar.
Está nos planos para os futuros milestones do Spring Social incluir uma documentação melhor e uma forma integrada de armazenar e gerenciar a autorização com OAuth. No momento, a própria aplicação deve tratar o armazenamento das chaves de autorização para passá-las para o template Spring Social. Mas o próximo milestone terá recursos para tornar esse processo mais simples. A SpringSource planeja basear a solução final de OAuth no código atualmente usado no Greenhouse.
Alternativas ao SpringSocial são bibliotecas específicas por site. O Twitter tem o ecosistema de bibliotecas mais elaborado com Twitter4J e outros. Outras bibliotecas específicas por site são mais difíceis de serem encontradas, como o fork da API Java antes oficial e agora semi abandonada do Facebook ou RestFB.
Os desenvolvedores também podem utilizar bibliotecas de apoio para simplificar o uso do OAuth através de APIs REST de cada serviço através da manipulação direta de URLs. Algumas bibliotecas populares de OAuth são: Signpost, OAuth for Spring Security, Scribe, entre outras.