Java EE 6 Web Services：JAX-RS 1.1提供了基于注解的REST支持

JavaEE 6规范提供了Java API for RESTful Web Services（JAX-RS）支持，提供了基于POJO的框架以构建轻量级的Web Services，该框架符合REST（Representational State Transfer）风格的软件架构。JAX-RS 1.1隶属于JSR 311，其所提供的几个注解可用于将Java类的方法公开为Web资源。
JAX-RS会自动进行Java类与MIME媒体类型之间的转换。比如说，如果通过注解“@Produces（MediaType.TEXT_PLAIN）”标记某个类方法，JAX-RS则会将该Java类型转换为“text/plain”MIME类型，这代表了普通文本，同时通过HTTP响应将该类型的内容发送给客户端。

Java EE 6包含了JAX-RS的最新版，即JAX-RS 1.1，该版本充分利用了Java EE 6的新特性，而Jersey则是JAX-RS规范开源的参考实现，Jersey 1.1.5实现了JAX-RS 1.1。

注解增加了一些额外的说明信息，可以标识资源并辅助处理HTTP请求。JAX-RS所支持的一些注解列举如下：

Path：该注解为资源指定了一个相对路径。@Path所标识的URI路径用于资源类或是类方法处理请求所用。

GET：@GET所注解的方法用于处理HTTP GET请求。当客户端向代表某个Web资源的URI直接发送HTTP GET请求时，JAX-RS运行时会调用被@GET所注解的方法来处理该GET请求。

POST：@POST所注解的方法用于处理HTTP POST请求。

Produces：该注解用于标识MIME媒体类型，这样资源中的方法就会生成该类型的内容并返回给客户端。

Consumes：@Consumes注解用于标识MIME媒体类型，这表示了资源中的方法可以接受客户端所请求的类型。与@Produces注解一样，如果在类上指定了@Consumes注解，该注解就会应用到类中的所有方法；如果在某个方法上指定了@Consumes注解，那么它会覆盖类上所指定的@Consumes注解。

JAX-RS还提供了其他一些方便的特性，比如基于参数的注解可以获得请求中的信息，@QueryParam,就是这样一种注解，它可以从请求URL的查询字符串中获得查询参数。其他基于参数的注解还有@MatrixParam，它可以从URL路径的segment部分获取信息；@HeaderParam可以从HTTP头中获得信息，而@CookieParam则可以从cookie相关的HTTP头中获得cookie信息。

还有不少辅助类和接口简化了Java中RESTful Web Services的构建和使用，列举如下：

• MediaType类可用于获取MIME媒体类型。该类的实例是不可变的。
• UriInfo是个接口，可以获取应用和请求的URI信息。
• UriBuilder能够获取URI模板信息，它可以从URI的各个组成部分来构建URI。
• Response是个抽象类，代表了HTTP响应。在应用向运行时提供元数据时，它定义了返回实例与运行时之间的契约。应用中的类可以直接继承Response类，也可以使用其静态方法来通过ResponseBuilder创建实例。
• Response.ResponseBuilder用于构建Response对象，使用了Builder模式。

来自JBoss的RESTEasy框架也实现了JAX-RS规范。Apache开源的服务框架CXF也在2.3版中提供了对JAX-RS 1.1的支持。

查看英文原文：Java EE 6 Web Services: JAX-RS 1.1 Provides Annotation Based REST Support