Book Image

Developing RESTful Web Services with Jersey 2.0

By : Sunil Gulabani
Book Image

Developing RESTful Web Services with Jersey 2.0

By: Sunil Gulabani

Overview of this book

<p>JAX-RS 2.0 is an enhanced framework based on RESTful architecture. It provides support for both the client and the server. Jersey 2.0 is the reference implementation of JAX-RS 2.0 (JSR 339 specification). This framework has undergone major revisions. The enhanced framework helps developers to use a low-level and simplified API.</p> <p>This practical, hands-on guide will help you to create RESTful web services easily with individual aspects of the application requests. It will enable you to learn and implement RESTful web services using the new features included in JAX-RS 2.0. It’s a jump start for those who want to try their hand at the new API. It aims to provide practical knowledge of the API along with detailed understanding.</p> <p>This book covers the new features of JAX-RS 2.0. It covers the complete lifecycle of a web service, that is, from server side to client side. The book focuses on the server API and the client API.</p> <p>You will learn how to use the server API in order to create web services that will be deployed on the server. This has all different implementations of HTTP methods and media representations. You will also get acquainted with the client API which specifies how to consume the deployed application’s web services. This includes how to handle different HTTP methods and media representations in response to the web services.</p> <p>You will also get to know Server Sent Events (SSE), which the server uses to push the data event directly to the client. The book will finally take you through the WADL specification. By the end of the book, you will be well equipped to implement Jersey 2.0 and JAX-RS.</p>
Table of Contents (13 chapters)

Parameter annotations


Parameter's annotations are used to retrieve values from the request. The different types of parameter annotations are listed as follows:

  • @PathParam

  • @QueryParam

  • @MatrixParam

  • @HeaderParam

  • @CookieParam

  • @FormParam

  • @BeanParam

@PathParam

@PathParam is a parameter annotation that enables you to map a variable URI path's fragments into your method call. The following example shows the use of the @PathParam method:

@Path("/userService")
public class UserResource {
    ...
    @GET
    @Path("{name}")
    public String getUserByName(@PathParam("name")String name) {
        return name;
    }
    ...
}

In the example, the getUserByName() method takes a parameter as a name. We can access the URI parameter using PathParam. It binds the URI template's parameter to the parameter that is defined in the getUserByName() method.

@QueryParam

This annotation allows you to map a URI query string parameter or a URL form encoded parameter to your method invocation. The following example...