Arun Gupta, Miles to go ...

Arun Gupta is a technology enthusiast, a passionate runner, and a community guy who works for Sun Microsystems.

« jMaki + JavaFX @ The... | Main | JRuby on Rails,... »

Thursday September 06, 2007

Jersey is the open source JAX-RS (JSR 311) Reference Implementation for building RESTful Web services. Paul announced the availability of 0.2.1. This blog entry describe the steps to get started with Jersey and provide useful pointers for further exploration.

Download a stable build from here or the latest binary from here. jersey-xxx-ea.zip is the binary distribution and jersey-snapshot-xxx-ea.zip is a snapshot of the SVN repository.

The bundle comes with all the required binaries (JAR dependencies) and a good set of samples for 0.2.1. Here is a consolidated list:

HelloWorld	This is how everybody starts!
GlassFishDB	Demonstrates how to use JPA to expose the contents of a database table as a RESTful resource.
JsonFromJaxb	Demonstrates how to use JSON representation of JAXB-based resources.
EntityProvider	Demonstrates pluggable entity providers.
Bookmark	Demonstrates how to use JPA in the backend.
Bookstore	Demonstrates how to use ploymorphism with resources and views that are JSP pages.
OptimisticConcurrency	Demonstrates the application of optimistic concurrency to a web resource.
SimpleAtomServer	Simple Atom server that partially conforms to the Atom Publishing Format and Protocol
SimpleConsole	Demonstrates how to use the Lightweight HTTP Server included in Sun's Java SE 6.0 release.
SimpleJAXWSEndpoint	Demonstrates how to use a JAX-WS Endpoint.
SimpleServlet	Demonstrates how to use a Servlet container.
StorageService	Demonstrates a basic in-memory web storage service

Pick a sample, most likely "Hello World", and then follow the instructions in the main "examples" directory to run the sample.

Here are some other useful pointers:
- Getting Started - "Hello World" sample explained
- Latest JSR 311 javadocs
- JSON javadocs
- Mailing Lists
As Alexis pointed, GlassFish is the preferred platform for deploying Jersey endpoints and NetBeans 6 will soon support Jersey.

Paul explained Why the name Jersey ? - Jersey is a restful place to spend a couple of days vacation. The Yellow jersey or Maillot jaune (the project logo) is worn by the overall leader in Le Tour. With modesty I would like this to be the leading open source project for developing RESTful Web services using plain old Java objects.

And then it could also be Java basEd RESTful Services for You as coined by Sridatta :)

Technorati: jersey jsr311 REST restful glassfish netbeans

Posted by Arun Gupta in web2.0 | Comments[10]

|
|

Comments:

FYI, here's the link for browsing the source code and SVN checkout information:
https://jersey.dev.java.net/source/browse/jersey/

Posted by Glen on September 06, 2007 at 11:35 AM PDT #

FYI, here's the link for browsing the source code and SVN checkout information:
https://jersey.dev.java.net/source/browse/jersey/

Posted by Glen on September 06, 2007 at 11:44 AM PDT #

Arun, the Hello World sample above is using the Lightweight HTTP Server. I'm not sure how much this server is intended though for serious production use. How can we wrap this sample up into a WAR file for Tomcat or GlassFish? If you know of a link that explains this, great, else this might make a good future TOTD note.

Posted by Glen on September 10, 2007 at 04:15 PM PDT #

Glen, one of the samples listed at http://blogs.sun.com/arungupta/entry/learn_to_rest_using_jersey shows how to deploy a Servlet-based endpoint. Let me know if that does not work and I'll create a TOTD.

Posted by Arun Gupta on September 10, 2007 at 05:15 PM PDT #

Any suggestions for running Bookmark sample using Netbeans&glassfish V3 ?
Many errors can't fix.

Posted by Mark Gu on January 07, 2009 at 01:44 PM PST #

Mark,

Have you tried posting question to users@jersey.dev.java.net ?

Posted by Arun Gupta on January 07, 2009 at 02:00 PM PST #

@Mark Gu: the bookmark exampleworks fine with GFv2. The example uses JPA, and i have not had a chance yet to look at how this works in GFv3. Is this (JPA/GFv3) what you are interested in? If not, there are some more examples, which you might want to look at to see how to develop RESTful web services in Java using Jersey. These examples run fine on GFv3.

Posted by Jakub Podlesak on January 08, 2009 at 01:04 AM PST #

Hi,

Am facing problem while consuming a REST service. Am not getting proper response. Could you help me with the sample code.

Thanks in advance.

Regards
Srinadh

Posted by srinadh on June 20, 2009 at 06:55 AM PDT #

Srinadh, have you tried posting request to users@jersey.dev.java.net ?

-Arun

Posted by Arun Gupta on July 02, 2009 at 10:20 AM PDT #

Arun,

At service level i kept annotation as GET but am trying to place POST request from client application. Now its working fine. REST is really wonderfull. It is reducing lot of overhead. Once concern is how to implement security feature.

Srinadh

Posted by Srinadh on July 04, 2009 at 12:05 AM PDT #