REST Web 服务（二）----JAX-RS 介绍

1. 什么是JAX-RS？

JAX-RS——Java API for RESTful Web Services，是为 Java 程序员提供的一套固定的接口（Java API），用于开发表述性状态转移（REST）架构风格的 WEB 服务应用，避免了依赖第三方框架。同时，JAX-RS 使用 POJO 编程模型和基于标注（标签）的配置，并集成了 JAXB，从而可以有效缩短 REST 应用的开发周期。REST 作为一种轻量级的 Web 服务架构被原来越多的开发者所使用，JAX-RS 的发布则规范了 REST 应用开发的接口。

常见的 JAX-RS 实现方法有：

1)Jersey——伴随 JSR311的发布，SUN 公司发布的 JSR311的参考实现；

2)CXF——XFire 与 Celtix 的合并；

3)RESTEasy——JBoss 的 JAX-RS 项目。

2. JAX-RS注解有哪些？

JAX-RS提供了一些标注将一个资源类，一个POJO Java类，封装为Web资源。标注包括：

@Path，标注资源类或者方法的相对路径

 @Path("/")
 public class Bookstore {}

 @Path("items/{itemid}/")
  public Item getItem(@PathParam("itemid") String itemid) {}

@GET，@PUT，@POST，@DELETE，标注方法是HTTP请求的类型。

 @GET
 public Bookstore getXml() {
         return this;
 }

@Produces，标注返回的MIME媒体类型

 @Produces("text/html;qs=5")
 public class Bookstore {}

 @Produces({MediaType.APPLICATION_XML, MediaType.TEXT_XML, MediaType.APPLICATION_JSON})
 public Bookstore getXml() {
         return this;
 }

@Consumes，标注可接受请求的MIME媒体类型

 @Consumes(MediaType.APPLICATION_XML)
 public Response putTodo(JAXBElement<Todo> todo) {
     Todo c = todo.getValue();
     return putAndGetResponse(c);
  }

@PathParam， @QueryParam， @HeaderParam， @CookieParam， @MatrixParam， @FormParam, 分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，@QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。

例子：

 @Path("items/{itemid}/")
 public Item getItem(@PathParam("itemid") String itemid) {

@Context： 使用该注释注入上下文对象，比如 Request、Response、UriInfo、ServletContext 等。

3. JAX-RS例子

REST with Java (JAX-RS) using Jersey - Tutorial

JAX-RS Tutorial

另外还可以从（Jersey，CXF,RESTEasy）包中找到大量的例子。