JAX-RS介绍——Java API forRESTful WebServices,JAX-RS的目标是Web Services开发(这与HTML Web应用不同)而Spring MVC的目标则是Web应用开发
2017-01-18 16:29
801 查看
JAX-RS
Java API forRESTful WebServices旨在定义一个统一的规范,使得 Java 程序员可以使用一套固定的接口来开发 REST 应用,避免了依赖于第三方框架。是一个Java编程语言的应用程序接口,支持按照表象化状态转变 (REST)架构风格创建Web服务Web服务。与传统的 servlet 模型相比,JAX-RS 提供了一种可行的、更为简便、移植性更好的方式来在 Java 内实现 RESTful 服务。使用注释让您能够轻松提供 Java 资源的路径位置并将 Java 方法绑定到 HTTP 请求方法。一种可移植的数据绑定架构提供了一些本机的 Java 类型支持并允许进行序列化/反序列化处理的完全定制。javax.ws.rs.core.Application 子类的扩展以及 web.xml 内的相应清单表明了用最少的部署描述符配置就能进行轻松部署。
JAX-RS 的具体实现由第三方提供,例如 Sun 的参考实现 Jersey、Apache 的 CXF 以及 JBoss 的 RESTEasy。
JAX-RS标注
JAX-RS提供了一些标注将一个资源类,一个POJO类,封装为Web资源。标注包括:@Path,标注资源类或方法的相对路径
@GET,@PUT,@POST,@DELETE,标注方法是用的HTTP请求的类型,分别对应 4 种 HTTP 方法,用于对资源进行创建、检索、更新和删除的操作。
若要创建资源,应该使用 POST 方法;
若要检索某个资源,应该使用 GET 方法;
若要更改资源状态或对其进行更新,应该使用 PUT 方法;
若要删除某个资源,应该使用 DELETE 方法。
@Produces,标注返回的MIME媒体类型
@Consumes,标注可接受请求的MIME媒体类型
@PathParam,@QueryParam,@HeaderParam,@CookieParam,@MatrixParam,@FormParam,分别标注方法的参数来自于HTTP请求的不同位置,
@PathParam来自于URL的路径,
@QueryParam来自于URL的查询参数,
@HeaderParam来自于HTTP请求的头信息,
@CookieParam来自于HTTP请求的Cookie。
@Path("/") public class BookkeepingService { ...... @Path("/person/") //资源方法;若无@POST,则为子资源定位器 @POST @Consumes("application/json") public Response createPerson(Person person) { //JSON 格式的请求体被自动映射为实体参数person ...... } @Path("/person/") @PUT @Consumes("application/json") public Response updatePerson(Person person) { ...... } @Path("/person/{id:\\d+}/") //正则表达式 @DELETE public Response deletePerson(@PathParam("id") int id) { ...... } @Path("/person/{id:\\d+}/") @GET @Produces("application/json") public Person readPerson(@PathParam("id") int id) { ...... } @Path("/persons/") @GET @Produces("application/json") public Person[] readAllPersons() { //数组类型的返回值被自动映射为 JSON 格式的响应体——? ...... } @Path("/person/{name}/") @GET @Produces("application/json") public Person readPersonByName(@PathParam("name") String name) { ...... }
这是一个示意的例子!
相关文章推荐
- JAX-RS -- Java API for RESTful Web Services
- jax-rs(Java API for RESTful Web Services)实践教程 之二 —— get/post/put/delete/head
- jax-rs(Java API for RESTful Web Services) 实践教程 之三 —— 生产Produces与消费Consumes
- jax-rs(Java API for RESTful Web Services) 实践教程 之五 —— 注入全局变量 和 rest的生命周期
- jax-rs(Java API for RESTful Web Services)实践教程 之二 —— get/post/put/delete/head
- JAX-RS(Java API for RESTful Web Services)常用注解
- jboss7 Java API for RESTful Web Services (JAX-RS) 官方文档
- jax-rs(Java API for RESTful Web Services) 实践教程 之四 —— @Context注入HttpServletRequest 使REST保持状态!
- jax-rs(Java API for RESTful Web Services) 实践教程 之一 —— 初探jax-rs
- JAX-RS(Java API for RESTful Web Service)_1.1解析
- RESTful Webservices with Java (Jersey / JAX-RS)
- 如何在 Java 上使用 JAX-RS (RESTful 风格的 Web Services)
- java REST入门:使用 JAX-RS 简化 REST 应用开发
- JAX-RS基础 for RESTful Web Service
- java 利用JAX-RS快速开发RESTful 服务
- java 利用JAX-RS快速开发RESTful 服务
- java 利用JAX-RS快速开发RESTful 服务
- java 利用JAX-RS快速开发RESTful 服务
- 用 Java 技术创建 RESTful Web (服务 JAX-RS:一种更为简单、可移植性更好的替代方式)
- 最给力的java REST入门:使用 JAX-RS 简化 REST 应用开发(转自代码商人)