This document provides an overview of JAX-RS, a Java API for developing RESTful web services. It notes that JAX-RS uses annotations to define resources, is HTTP-centric and server-side only, and can be deployed to servlet or SE environments. Examples show how to define a resource class with GET and PUT methods and a message body writer. The specification and API are available online and the 1.1 maintenance release is in progress. Five open-source implementations already exist including Jersey, RESTEasy, Restlet, CXF, and Triaxrs.

1. A Brief Introduction to JAX-RS
Marc Hadley
Sun Microsystems

2. HEAD /JAX-RS
Java API for RESTful Web Services
●
Annotation-based server-side API
●
HTTP centric
●
Server-side only
●
Servlet or SE deployment
●

3. GET /JAX-RS/Examples/Resource
@Path(quot;widgets/{id}quot;)
@Produces(quot;application/widgets+xmlquot;)
@Consumes(quot;application/widgets+xmlquot;)
public class WidgetResource {
private Widget w;
public WidgetResource(@PathParam(quot;idquot;) String id) {
this.w = locateRecord(id);
}
@GET
Widget getWidget() {
return w;
}
@PUT
Widget updateWidget(Widget update) {
w = processUpdate(update);
return w;
}
}

4. GET /JAX-RS/Examples/Writer
@Provider
@Produces(quot;application/widgets+xmlquot;)
public class WidgetWriter
implements MessageBodyWriter<Widget> {
public boolean isWriteable(...) {...}
public long getSize(...) {...}
public void writeTo(...) {...}
}

5. GET /JAX-RS/Status
1.0 finalized end of September 2008
●
Online spec and API:
●
https://jsr311.dev.java.net/nonav/releases/1.0/spec/index.html
–
https://jsr311.dev.java.net/nonav/releases/1.0/index.html
–
1.1 maintenance release in progress focussing
●
on integration with new Java EE 6 features
Five open-source implementations already
●
Jersey, JBoss RESTEasy, Restlet, Apache CXF,
●
Triaxrs

6. *(question (answer | stumped))