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,标注资源类或者方法的相对路径
1 @Path("/")2 public class Bookstore {}3 4 @Path("items/{itemid}/")5 public Item getItem(@PathParam("itemid") String itemid) {}
@GET,@PUT,@POST,@DELETE,标注方法是HTTP请求的类型。
1 @GET2 public Bookstore getXml() {3 return this;4 }
@Produces,标注返回的MIME媒体类型
1 @Produces("text/html;qs=5")2 public class Bookstore {}3 4 @Produces({MediaType.APPLICATION_XML, MediaType.TEXT_XML, MediaType.APPLICATION_JSON})5 public Bookstore getXml() {6 return this;7 }
@Consumes,标注可接受请求的MIME媒体类型
1 @Consumes(MediaType.APPLICATION_XML)2 public Response putTodo(JAXBElementtodo) {3 Todo c = todo.getValue();4 return putAndGetResponse(c);5 }
@PathParam, @QueryParam, @HeaderParam, @CookieParam, @MatrixParam, @FormParam, 分别标注方法的参数来自于HTTP请求的不同位置,例如@PathParam来自于URL的路径,@QueryParam来自于URL的查询参数,@HeaderParam来自于HTTP请求的头信息,@CookieParam来自于HTTP请求的Cookie。
例子:
1 @Path("items/{itemid}/")2 public Item getItem(@PathParam("itemid") String itemid) {
@Context: 使用该注释注入上下文对象,比如 Request、Response、UriInfo、ServletContext 等。
3. JAX-RS例子
另外还可以从(Jersey,CXF,RESTEasy)包中找到大量的例子。