REST Web 服务(二)----JAX-RS 介绍

it2022-05-05  141

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 @GET 2 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(JAXBElement<Todo> todo) { 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例子

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

JAX-RS Tutorial

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

转载于:https://www.cnblogs.com/hesejiaoshi/p/3828809.html

相关资源:jaxrs-ri-2.25.1.zip

最新回复(0)