JAX-RS(Java API for RESTful Web Services)是一个Java编程语言应用程序接口,支持按照表象化状态转变(REST)架构风格创建Web服务[1]。JAX-RS使用了Java SE 5引入的Java 标注来简化Web服务客户端和服务端的开发和部署。

规范内容

JAX-RS提供了一些标注将一个资源类,一个POJOJava类,封装为Web资源。标注包括:

  • @Path,标注资源类或方法的相对路径
  • @GET,@PUT,@POST,@DELETE,标注方法是用的HTTP请求的类型
  • @Produces,标注返回的MIME媒体类型
  • @Consumes,标注可接受请求的MIME媒体类型
  • @PathParam,@QueryParam,@HeaderParam,@CookieParam,@MatrixParam,@FormParam,分别标注方法的参数来自于HTTP请求的不同位置,例如@PathParam来自于URL的路径,@QueryParam来自于URL的查询参数,@HeaderParam来自于HTTP请求的头信息,@CookieParam来自于HTTP请求的Cookie。

JAX-RS的实现

JAX-RS的实现包括[2]

Jersey

根据 Java EE 6 教程第1卷:Jersey是由Sun开发的产品级质量的JSR 311: JAX-RS: The Java API for RESTful Web Services的参考实现。Jersey实现了JSR-311中对标注的支持,这使得开发人员使用Java开发RESTfulWeb服务更加容易。除此以外,Jersey还增加了JSR以外的附加特性[3]

注释

  1. ^ Hadley, p. 1.
  2. ^ Mark Little,比较各JAX-RS实现页面存档备份,存于互联网档案馆
  3. ^ Building RESTful Web Services with JAX-RS and Jersey. [2010-07-07]. (原始内容存档于2009-06-11). 

参考文献

外部链接

参见