Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
SlideShare a Scribd company logo
<Insert Picture Here>




Developing RESTful Web services with JAX-RS
Arun Gupta, Java EE & GlassFish Guy
blogs.sun.com/arungupta, @arungupta
The following/preceding is intended to outline our
general product direction. It is intended for
information purposes only, and may not be
incorporated into any contract. It is not a
commitment to deliver any material, code, or
functionality, and should not be relied upon in
making purchasing decisions.
The development, release, and timing of any
features or functionality described for Oracle’s
products remains at the sole discretion of Oracle.



                                                     2
REST is an Architectural Style




   Style of software architecture for
distributed hypermedia systems such
          as World Wide Web



                                        3
RESTful Web Services



Application of REST architectural style
 to services that utilize Web standards
(URIs, HTTP, HTML, XML, Atom, RDF
                   etc.)


                                          4
Java API for RESTful Web Services
(JAX-RS)


 Standard annotation-driven API that
aims to help developers build RESTful
        Web services in Java



                                        5
RESTful Application Cycle

            Resources are identified by URIs
                             ↓
 Clients communicate with resources via requests using a
                 standard set of methods
                             ↓
Requests and responses contain resource representations in
            formats identified by media types
                             ↓
   Responses contain URIs that link to further resources




                                                             6
Principles of REST

• Give everything an ID
• Standard set of methods
• Link things together
• Multiple representations
• Stateless communications




                             7
Give Everything an ID

• ID is a URI

 http://example.com/widgets/foo

 http://example.com/customers/bar

 http://example.com/customers/bar/orders/2

 http://example.com/orders/101230/customer




                                             8
Resources are identified by URIs

http://example.com/widgets/foo

http://example.com/customers/bar

http://example.com/customers/bar/orders/2

http://example.com/orders/101230/customer




                                            9
Resources are identified by URIs

• Resource == Java class
 • POJO
 • No required interfaces
• ID provided by @Path annotation
 • Value is relative URI, base URI is provided by deployment
   context or parent resource
 • Embedded parameters for non-fixed parts of the URI
 • Annotate class or “sub-resource locator” method




                                                               10
Resources are identified by URIs

@Path("orders/{order_id}")
public class OrderResource {

    @GET
    @Path("customer")
    CustomerResource getCustomer(...) {...}
}




                                              11
Standard Set of Methods


    Method                    Purpose

   GET       Read, possibly cached

   POST      Update or create without a known ID

   PUT       Update or create with a known ID

   DELETE    Remove




                                                   12
Standard Set of Methods

• Annotate resource class methods with standard method
   • @GET, @PUT, @POST, @DELETE, @HEAD
   • @HttpMethod meta-annotation allows extensions, e.g. WebDAV
• JAX-RS routes request to appropriate resource class and
  method
• Flexible method signatures, annotations on parameters
  specify mapping from request
• Return value mapped to response




                                                                  13
Standard Set of Methods

@Path("properties/{name}")
public class SystemProperty {

    @GET
    Property get(@PathParam("name") String name)
      {...}

    @PUT
    Property set(@PathParam("name") String name,
      String value) {...}

}


                                                   14
Multiple Representations
• Offer data in a variety of formats
  • XML
  • JSON
  • (X)HTML
• Maximize reach
• Support content negotiation
  • Accept header
    GET /foo
    Accept: application/json
  • URI-based
    GET /foo.json



                                       15
Resource Representations

• Representation format identified by media
 type. E.g.:
 • XML - application/properties+xml
 • JSON - application/properties+json
 • (X)HTML+microformats - application/xhtml+xml
• JAX-RS automates content negotiation
 • GET /foo
   Accept: application/properties+json




                                                  16
Multiple Representations

• Static - Annotate methods or classes with static capabilities
   • @Produces, @Consumes
• Dynamic - Use Variant, VariantListBuilder and
 Request.selectVariant for dynamic capabilities




                                                                  17
Content Negotiation: Accept Header

Accept: application/xml
Accept: application/json;q=1.0, text/xml;q=0.5, application/xml;q=0.5,

@GET
@Produces({"application/xml","application/json"})
Order getOrder(@PathParam("order_id") String id) {
  ...
}

@GET
@Produces("text/plain")
String getOrder2(@PathParam("order_id") String id) {
  ...
}



                                                                         18
Content Negotiation: URL-based
@Path("/orders")
public class OrderResource {
    @Path("{orderId}.xml")
    @GET
    public Order getOrderInXML(@PathParam("orderId") String
orderId) {
      . . .
    }

    @Path("{orderId}.json")
    @GET
    public Order getOrderInJSON(@PathParam("orderId") String
orderId) {
       . . .
    }
}




                                                               19
Content Negotiation: Dynamic




                               20
JAX-RS 1.1
Code Sample

import javax.inject.Inject;
import
javax.enterprise.context.RequestScoped;

@RequestScoped
public class ActorResource {
    @Inject DatbaseBean db;

    public Actor getActor(int id) {
        return db.findActorById(id);
    }
}




                                          21
Content Negotiation
import   javax.ws.rs.GET;
import   javax.ws.rs.Path;
import   javax.ws.rs.Produces;
import   javax.ws.rs.PathParam;
import   javax.inject.Inject;
import   javax.enterprise.context.RequestScoped;

@Path("/actor/{id}")
@RequestScoped
public class ActorResource {
    @Inject DatbaseBean db;

    @GET
    @Produces("application/json")
    public Actor getActor(@PathParam("id") int id) {
         return db.findActorById(id);
    }
}                 http://blogs.sun.com/arungupta/entry/totd_124_using_cdi_jpa


                                                                                22
Link Things Together


<order self="http://example.com/orders/101230">
  <customer ref="http://example.com/customers/bar">
  <product ref="http://example.com/products/21034"/>
  <amount value="1"/>
</order>




                                                   23
Responses Contain Links

HTTP/1.1 201 Created
Date: Wed, 03 Jun 2009 16:41:58 GMT
Server: Apache/1.3.6
Location: http://example.com/properties/foo
Content-Type: application/order+xml
Content-Length: 184

<property self="http://example.com/properties/foo">
  <parent ref="http://example.com/properties/bar"/>
  <name>Foo</name>
  <value>1</value>
</order>




                                                      24
Responses Contain Links

• UriInfo provides information about deployment context,
  the request URI and the route to the resource
• UriBuilder provides facilities to easily construct URIs for
  resources




                                                                25
Responses Contain Links

@Context UriInfo i;

SystemProperty p = ...
UriBuilder b = i.getBaseUriBuilder();
URI u = b.path(SystemProperties.class)
   .path(p.getName()).build();

List<URI> ancestors = i.getMatchedURIs();
URI parent = ancestors.get(1);




                                            26
Stateless Communications


• Long lived identifiers
• Avoid sessions
• Everything required to process a request
 contained in the request




                                             27
JAX-RS Summary


• Java API for building RESTful Web Services
• POJO based
• Annotation-driven
• Server-side API
• HTTP-centric




                                           28
JAX-RS 1.1
    More Code Samples

• Processing POSTed HTML
Form
@POST
@Consumes("application/x-www-form-urlencoded")
public void post(@FormParam("name") String name) {
     // Store the message
• Sub-Resources
}
@Singleton
@Path("/printers")
public class PrintersResource {

    @GET @Path("/list")
    @Produces({"application/json", "application/xml"})
    public WebResourceList getListOfPrinters() { ... }

    @GET @Path("/ids/{printerid}")
    @Produces({"application/json", "application/xml"})
    public Printer getPrinter(@PathParam("printerid") String printerId) { ...
}


                                                                            29
JAX-RS 1.1
        Integration with Java EE 6 – Servlets 3.0

    • No or Portable “web.xml”
<web-app>                                                 @ApplicationPath(“resources”)
  <servlet>
    <servlet-name>Jersey Web Application</servlet-name>   public class MyApplication
    <servlet-class>                                          extends
                                                             javax.ws.rs.core.Application
com.sun.jersey.spi.container.servlet.ServletContainer
    </servlet-class>                                      {
    <init-param>                                          }
      <param-name>javax.ws.rs.Application</param-name>
      <param-value>com.foo.MyApplication</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>Jersey Web Application</servlet-name>
    <url-pattern>/resources/*</url-pattern>
  </servlet-mapping>
</web-app>




                                                                                            30
JAX-RS 1.1
    Integration with Java EE 6 – EJB 3.1

• Use stateless or singleton EJBs in the
    WAR as resource and provider classes
@Path(“stateless”)
@Stateless                                  @Singleton
public class MyStatelessRootResource {      public class MyStatelessResource {
    @Context UriInfo ui;                            @Context UriInfo ui;


    @GET                                        …
    public String get() { return “GET”; }   }

    @EJB MyStatelessResource subResource;


    @Path(“sub-resource”)
    public MyStatelessResource sub() {
      return subResource;
    }
}


                                                                            31
JAX-RS 1.1
 Jersey Client-side API

• Consume HTTP-based RESTful Services
• Easy-to-use
 • Better than HttpURLConnection!
• Reuses JAX-RS API
 • Resources and URI are first-class citizens
• Not part of JAX-RS yet
 • com.sun.jersey.api.client




                                                32
JAX-RS 1.1
   Jersey Client API – Code Sample

Client client = Client.create();

WebResource resource = client.resource(“...”);

//curl http://example.com/base
String s = resource.get(String.class);

//curl -HAccept:text/plain http://example.com/base
String s = resource.
        accept(“text/plain”).
        get(String.class);

http://blogs.sun.com/enterprisetechtips/entry/consuming_restful_web_services_w
ith

                                                                                 33
JAX-RS 1.1
Jersey Client API – NetBeans Code Generation




                                               34
JAX-RS 1.1
  WADL Representation of Resources

• Machine processable description of
  HTTP-based Applications
• Generated OOTB for the application
<application xmlns="http://research.sun.com/wadl/2006/10">
  <doc xmlns:jersey="http://jersey.dev.java.net/"
       jersey:generatedBy="Jersey: 1.1.4.1 11/24/2009 01:37
AM"/>
  <resources base="http://localhost:8080/HelloWADL/resources/">

    <resource path="generic">
      <method id="getText" name="GET">
        <response>
          <representation mediaType="text/plain"/>
        </response>
      </method>
      <method id="putText" name="PUT">
        <request>
          <representation mediaType="text/plain"/>
        </request>
      </method>
    </resource>
  </resources>
</application>



                                                                  35
Java SE Deployment

• RuntimeDelegate is used to create instances of a
 desired endpoint class
• Application supplies configuration information

  • List of resource classes and providers as subclass of
    Application
• Implementations can support any Java type
   • Jersey supports Grizzly (see below), LW HTTP server and JAX-WS
     Provider




                                                                      36
Example Java SE Deployment

Application app = ...
RuntimeDelegate rd = RuntimeDelegate.getInstance();
Adapter a = rd.createEndpoint(app, Adapter.class);

SelectorThread st = GrizzlyServerFactory.create(
    “http://127.0.0.1:8084/”, a);




                                                      37
Servlet
• JAX-RS application packaged in WAR like a servlet
• For JAX-RS aware containers
   • web.xml can point to Application subclass
• For non-JAX-RS aware containers
   • web.xml points to implementation-specific Servlet; and
   • an init-param identifies the Application subclass
• Resource classes and providers can access Servlet
 request, context, config and response via injection




                                                              38
Java EE
• Resource class can be an EJB session or singleton bean
• Providers can be an EJB stateless session or singleton
  bean
• JAX-RS annotations on local interface or no-interface bean
• If JCDI (JSR 299) also supported then
  • Resource classes can be JCDI beans
  • Providers can be JCDI beans with application scope
• Full access to facilities of native component model, e.g.
 resource injection




                                                               39
JAX-RS status
• JAX-RS 1.0: 18th October 2008
• JAX-RS 1.1: 23rd November 2009
   • Aligned with Java EE 6, but not in the Web
     profile!
• JAX-RS 2.0: Future<?>
• Implementations
   • Apache CXF, Apache Wink, eXo, Jersey,
     RESTEasy, Restlet, Triaxrs


                                          40      40
The Future<?>

• JAX-RS 1.0 is 2 years old
• Implementations have innovated in that 2 year
 period... and other frameworks
 • Play, SiteBricks, Scalate, Spring, VRaptor
• JAX-RS 2.0 should take innovations that work
 well and standardize
 • Premature standardization is a root of evil




                                                 41
Jersey




 Open source, production quality,
   reference implementation
         … and more ...

                                    42
GET /Samples

• Many samples are provided with the release
  • Atom, JAXB, JSON, Scala, Spring, WADL
  • Using GlassFish (+embedded) and Grizzly
• Download the 1.1.0 samples
  • Samples are maven-based
  • Works with NetBeans 6.x + maven plugin
  • Individual sample zip files are also available
     • e.g. Sparklines, Mandel




                                                     43
GET /Involved
• Ask/answer questions, propose fixes/features
  • mailto:users@jersey.dev.java.net




                                                 44
GET /Features

• Client API
• JSON with JAXB
• Spring and Guice integration
• MIME multipart API
• Atom with Abdera API
• WADL
• Grizzly and Simple servers




                                 45
JAX-RS 2.0
    http://markmail.org/thread/wgm3hj3rrva3j6jo


●
    Client API
    ●
        Low level using Builder pattern, Higher-level
●
    Hypermedia
●
    MVC Pattern
    ●
        Resource controllers, Pluggable viewing technology
●
    Bean Validation
    ●
        Form or Query parameter validation
●
    Closer integration with @Inject, etc.
●
    Server-side asynchronous request processing
●
    Server-side content negotiation

                                                             46
References


• oracle.com/goto/glassfish
• glassfish.org
• blogs.sun.com/theaquarium
• youtube.com/user/GlassFishVideos
• Follow @glassfish




                                     47
<Insert Picture Here>




Developing RESTful Web services with JAX-RS
Arun Gupta, Java EE & GlassFish Guy
blogs.sun.com/arungupta, @arungupta

More Related Content

Spark IT 2011 - Developing RESTful Web services with JAX-RS

  • 1. <Insert Picture Here> Developing RESTful Web services with JAX-RS Arun Gupta, Java EE & GlassFish Guy blogs.sun.com/arungupta, @arungupta
  • 2. The following/preceding is intended to outline our general product direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle’s products remains at the sole discretion of Oracle. 2
  • 3. REST is an Architectural Style Style of software architecture for distributed hypermedia systems such as World Wide Web 3
  • 4. RESTful Web Services Application of REST architectural style to services that utilize Web standards (URIs, HTTP, HTML, XML, Atom, RDF etc.) 4
  • 5. Java API for RESTful Web Services (JAX-RS) Standard annotation-driven API that aims to help developers build RESTful Web services in Java 5
  • 6. RESTful Application Cycle Resources are identified by URIs ↓ Clients communicate with resources via requests using a standard set of methods ↓ Requests and responses contain resource representations in formats identified by media types ↓ Responses contain URIs that link to further resources 6
  • 7. Principles of REST • Give everything an ID • Standard set of methods • Link things together • Multiple representations • Stateless communications 7
  • 8. Give Everything an ID • ID is a URI http://example.com/widgets/foo http://example.com/customers/bar http://example.com/customers/bar/orders/2 http://example.com/orders/101230/customer 8
  • 9. Resources are identified by URIs http://example.com/widgets/foo http://example.com/customers/bar http://example.com/customers/bar/orders/2 http://example.com/orders/101230/customer 9
  • 10. Resources are identified by URIs • Resource == Java class • POJO • No required interfaces • ID provided by @Path annotation • Value is relative URI, base URI is provided by deployment context or parent resource • Embedded parameters for non-fixed parts of the URI • Annotate class or “sub-resource locator” method 10
  • 11. Resources are identified by URIs @Path("orders/{order_id}") public class OrderResource { @GET @Path("customer") CustomerResource getCustomer(...) {...} } 11
  • 12. Standard Set of Methods Method Purpose GET Read, possibly cached POST Update or create without a known ID PUT Update or create with a known ID DELETE Remove 12
  • 13. Standard Set of Methods • Annotate resource class methods with standard method • @GET, @PUT, @POST, @DELETE, @HEAD • @HttpMethod meta-annotation allows extensions, e.g. WebDAV • JAX-RS routes request to appropriate resource class and method • Flexible method signatures, annotations on parameters specify mapping from request • Return value mapped to response 13
  • 14. Standard Set of Methods @Path("properties/{name}") public class SystemProperty { @GET Property get(@PathParam("name") String name) {...} @PUT Property set(@PathParam("name") String name, String value) {...} } 14
  • 15. Multiple Representations • Offer data in a variety of formats • XML • JSON • (X)HTML • Maximize reach • Support content negotiation • Accept header GET /foo Accept: application/json • URI-based GET /foo.json 15
  • 16. Resource Representations • Representation format identified by media type. E.g.: • XML - application/properties+xml • JSON - application/properties+json • (X)HTML+microformats - application/xhtml+xml • JAX-RS automates content negotiation • GET /foo Accept: application/properties+json 16
  • 17. Multiple Representations • Static - Annotate methods or classes with static capabilities • @Produces, @Consumes • Dynamic - Use Variant, VariantListBuilder and Request.selectVariant for dynamic capabilities 17
  • 18. Content Negotiation: Accept Header Accept: application/xml Accept: application/json;q=1.0, text/xml;q=0.5, application/xml;q=0.5, @GET @Produces({"application/xml","application/json"}) Order getOrder(@PathParam("order_id") String id) { ... } @GET @Produces("text/plain") String getOrder2(@PathParam("order_id") String id) { ... } 18
  • 19. Content Negotiation: URL-based @Path("/orders") public class OrderResource { @Path("{orderId}.xml") @GET public Order getOrderInXML(@PathParam("orderId") String orderId) { . . . } @Path("{orderId}.json") @GET public Order getOrderInJSON(@PathParam("orderId") String orderId) { . . . } } 19
  • 21. JAX-RS 1.1 Code Sample import javax.inject.Inject; import javax.enterprise.context.RequestScoped; @RequestScoped public class ActorResource { @Inject DatbaseBean db; public Actor getActor(int id) { return db.findActorById(id); } } 21
  • 22. Content Negotiation import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.PathParam; import javax.inject.Inject; import javax.enterprise.context.RequestScoped; @Path("/actor/{id}") @RequestScoped public class ActorResource { @Inject DatbaseBean db; @GET @Produces("application/json") public Actor getActor(@PathParam("id") int id) { return db.findActorById(id); } } http://blogs.sun.com/arungupta/entry/totd_124_using_cdi_jpa 22
  • 23. Link Things Together <order self="http://example.com/orders/101230"> <customer ref="http://example.com/customers/bar"> <product ref="http://example.com/products/21034"/> <amount value="1"/> </order> 23
  • 24. Responses Contain Links HTTP/1.1 201 Created Date: Wed, 03 Jun 2009 16:41:58 GMT Server: Apache/1.3.6 Location: http://example.com/properties/foo Content-Type: application/order+xml Content-Length: 184 <property self="http://example.com/properties/foo"> <parent ref="http://example.com/properties/bar"/> <name>Foo</name> <value>1</value> </order> 24
  • 25. Responses Contain Links • UriInfo provides information about deployment context, the request URI and the route to the resource • UriBuilder provides facilities to easily construct URIs for resources 25
  • 26. Responses Contain Links @Context UriInfo i; SystemProperty p = ... UriBuilder b = i.getBaseUriBuilder(); URI u = b.path(SystemProperties.class) .path(p.getName()).build(); List<URI> ancestors = i.getMatchedURIs(); URI parent = ancestors.get(1); 26
  • 27. Stateless Communications • Long lived identifiers • Avoid sessions • Everything required to process a request contained in the request 27
  • 28. JAX-RS Summary • Java API for building RESTful Web Services • POJO based • Annotation-driven • Server-side API • HTTP-centric 28
  • 29. JAX-RS 1.1 More Code Samples • Processing POSTed HTML Form @POST @Consumes("application/x-www-form-urlencoded") public void post(@FormParam("name") String name) { // Store the message • Sub-Resources } @Singleton @Path("/printers") public class PrintersResource { @GET @Path("/list") @Produces({"application/json", "application/xml"}) public WebResourceList getListOfPrinters() { ... } @GET @Path("/ids/{printerid}") @Produces({"application/json", "application/xml"}) public Printer getPrinter(@PathParam("printerid") String printerId) { ... } 29
  • 30. JAX-RS 1.1 Integration with Java EE 6 – Servlets 3.0 • No or Portable “web.xml” <web-app> @ApplicationPath(“resources”) <servlet> <servlet-name>Jersey Web Application</servlet-name> public class MyApplication <servlet-class> extends javax.ws.rs.core.Application com.sun.jersey.spi.container.servlet.ServletContainer </servlet-class> { <init-param> } <param-name>javax.ws.rs.Application</param-name> <param-value>com.foo.MyApplication</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>Jersey Web Application</servlet-name> <url-pattern>/resources/*</url-pattern> </servlet-mapping> </web-app> 30
  • 31. JAX-RS 1.1 Integration with Java EE 6 – EJB 3.1 • Use stateless or singleton EJBs in the WAR as resource and provider classes @Path(“stateless”) @Stateless @Singleton public class MyStatelessRootResource { public class MyStatelessResource { @Context UriInfo ui; @Context UriInfo ui; @GET … public String get() { return “GET”; } } @EJB MyStatelessResource subResource; @Path(“sub-resource”) public MyStatelessResource sub() { return subResource; } } 31
  • 32. JAX-RS 1.1 Jersey Client-side API • Consume HTTP-based RESTful Services • Easy-to-use • Better than HttpURLConnection! • Reuses JAX-RS API • Resources and URI are first-class citizens • Not part of JAX-RS yet • com.sun.jersey.api.client 32
  • 33. JAX-RS 1.1 Jersey Client API – Code Sample Client client = Client.create(); WebResource resource = client.resource(“...”); //curl http://example.com/base String s = resource.get(String.class); //curl -HAccept:text/plain http://example.com/base String s = resource. accept(“text/plain”). get(String.class); http://blogs.sun.com/enterprisetechtips/entry/consuming_restful_web_services_w ith 33
  • 34. JAX-RS 1.1 Jersey Client API – NetBeans Code Generation 34
  • 35. JAX-RS 1.1 WADL Representation of Resources • Machine processable description of HTTP-based Applications • Generated OOTB for the application <application xmlns="http://research.sun.com/wadl/2006/10"> <doc xmlns:jersey="http://jersey.dev.java.net/" jersey:generatedBy="Jersey: 1.1.4.1 11/24/2009 01:37 AM"/> <resources base="http://localhost:8080/HelloWADL/resources/"> <resource path="generic"> <method id="getText" name="GET"> <response> <representation mediaType="text/plain"/> </response> </method> <method id="putText" name="PUT"> <request> <representation mediaType="text/plain"/> </request> </method> </resource> </resources> </application> 35
  • 36. Java SE Deployment • RuntimeDelegate is used to create instances of a desired endpoint class • Application supplies configuration information • List of resource classes and providers as subclass of Application • Implementations can support any Java type • Jersey supports Grizzly (see below), LW HTTP server and JAX-WS Provider 36
  • 37. Example Java SE Deployment Application app = ... RuntimeDelegate rd = RuntimeDelegate.getInstance(); Adapter a = rd.createEndpoint(app, Adapter.class); SelectorThread st = GrizzlyServerFactory.create( “http://127.0.0.1:8084/”, a); 37
  • 38. Servlet • JAX-RS application packaged in WAR like a servlet • For JAX-RS aware containers • web.xml can point to Application subclass • For non-JAX-RS aware containers • web.xml points to implementation-specific Servlet; and • an init-param identifies the Application subclass • Resource classes and providers can access Servlet request, context, config and response via injection 38
  • 39. Java EE • Resource class can be an EJB session or singleton bean • Providers can be an EJB stateless session or singleton bean • JAX-RS annotations on local interface or no-interface bean • If JCDI (JSR 299) also supported then • Resource classes can be JCDI beans • Providers can be JCDI beans with application scope • Full access to facilities of native component model, e.g. resource injection 39
  • 40. JAX-RS status • JAX-RS 1.0: 18th October 2008 • JAX-RS 1.1: 23rd November 2009 • Aligned with Java EE 6, but not in the Web profile! • JAX-RS 2.0: Future<?> • Implementations • Apache CXF, Apache Wink, eXo, Jersey, RESTEasy, Restlet, Triaxrs 40 40
  • 41. The Future<?> • JAX-RS 1.0 is 2 years old • Implementations have innovated in that 2 year period... and other frameworks • Play, SiteBricks, Scalate, Spring, VRaptor • JAX-RS 2.0 should take innovations that work well and standardize • Premature standardization is a root of evil 41
  • 42. Jersey Open source, production quality, reference implementation … and more ... 42
  • 43. GET /Samples • Many samples are provided with the release • Atom, JAXB, JSON, Scala, Spring, WADL • Using GlassFish (+embedded) and Grizzly • Download the 1.1.0 samples • Samples are maven-based • Works with NetBeans 6.x + maven plugin • Individual sample zip files are also available • e.g. Sparklines, Mandel 43
  • 44. GET /Involved • Ask/answer questions, propose fixes/features • mailto:users@jersey.dev.java.net 44
  • 45. GET /Features • Client API • JSON with JAXB • Spring and Guice integration • MIME multipart API • Atom with Abdera API • WADL • Grizzly and Simple servers 45
  • 46. JAX-RS 2.0 http://markmail.org/thread/wgm3hj3rrva3j6jo ● Client API ● Low level using Builder pattern, Higher-level ● Hypermedia ● MVC Pattern ● Resource controllers, Pluggable viewing technology ● Bean Validation ● Form or Query parameter validation ● Closer integration with @Inject, etc. ● Server-side asynchronous request processing ● Server-side content negotiation 46
  • 47. References • oracle.com/goto/glassfish • glassfish.org • blogs.sun.com/theaquarium • youtube.com/user/GlassFishVideos • Follow @glassfish 47
  • 48. <Insert Picture Here> Developing RESTful Web services with JAX-RS Arun Gupta, Java EE & GlassFish Guy blogs.sun.com/arungupta, @arungupta