There are a few Twitter APIs for Java that allow you to integrate Twitter functionality in a Java application. This is yet another API, built using JAX-RS and Jersey stack. I started this effort earlier this year and kept delaying to share because wanted to provide a more comprehensive API. But I've delayed enough and releasing it as a work-in-progress.

I'm happy to take contributions in order to evolve this API and make it complete, useful, and robust. Drop a comment on the blog if you are interested or ping me at @arungupta.

How do you get started ? Just add the following to your "pom.xml":

<dependency>
 <groupId>org.glassfish.samples</groupId>
 <artifactId>twitter-api</artifactId>
 <version>1.0-SNAPSHOT</version>
</dependency>

The implementation of this API uses Jersey OAuth Filters for authentication with Twitter and so the following dependencies are required if any API that requires authentication, which is pretty much all the APIs ;-)

<dependency>
<groupId>com.sun.jersey.contribs.jersey-oauth</groupId>
    <artifactId>oauth-client</artifactId>
    <version>${jersey.version}</version>
</dependency>
<dependency>
    <groupId>com.sun.jersey.contribs.jersey-oauth</groupId>
    <artifactId>oauth-signature</artifactId>
    <version>${jersey.version}</version>
</dependency> 

Once the dependencies are added to your project, inject Twitter  API in your Servlet (or any other Java EE component) as:

@Inject Twitter twitter;

Here is a simple non-secure invocation of the API to get you started:

SearchResults result = twitter.search("glassfish", SearchResults.class);
for (SearchResultsTweet t : result.getResults()) {
 out.println(t.getText() + "<br/>");
}

This code returns the tweets that matches the query "glassfish".

The source code for the complete project can be downloaded here. Download it, unzip, and mvn package will build the .war file. And then deploy it on GlassFish or any other Java EE 6 compliant application server!

The source code for the API also acts as the javadocs and can be checked out from here.

A more detailed sample using security and several other API from this library is coming soon!