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提供了一些标注将一个资源类，一个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。

当jax-rs服务基于servlet发布的时候，还可以通过@Context注入servlet的ServletConfig,ServletContext,HttpServletRequest,HttpServletResponse。