Jersey注解详解

REST 在 2000 年由 Roy Fielding 在博士论文中提出，他是 HTTP 规范 1.0 和 1.1 版的首席作者之一。

REST 中最重要的概念是资源（resources），使用全球 ID（通常使用 URI）标识。客户端应用程序使用 HTTP 方法（GET/ POST/ PUT/ DELETE）操作资源或资源集。RESTful Web 服务是使用 HTTP 和 REST 原理实现的Web 服务。通常，RESTful Web 服务应该定义以下方面：

Web 服务的基/根 URI，比如 http://host/<appcontext>/resources。
支持 MIME 类型的响应数据，包括 JSON/XML/ATOM 等等。
服务支持的操作集合（例如 POST、GET、PUT 或 DELETE）。

Jersey的四种行为

方法

HTTP 方法映射到资源的 CRUD（创建、读取、更新和删除）操作。尽管您可以做一些小修改，比如让 PUT 方法变成创建或更新，但基本的模式如下：

HTTP GET：获取/列出/检索单个资源或资源集合。
HTTP POST：新建资源。
HTTP PUT：更新现有资源或资源集合。
HTTP DELETE：删除资源或资源集合。

方法/资源	资源集合; URI 如： http://host/api/resources	成员资源; URI 如： http://host/api /resources/123	对应的操作
POST	列出资源集合的所有成员。	检索标识为 1234 的资源的表示形式。	C（创建）
GET	使用一个集合更新（替换）另一个集合。	更新标记为 1234 的数字资源。	R（读取）
PUT	在集合中创建数字资源，其ID 是自动分配的。	在下面创建一个子资源。	U（更新）
DELETE	删除整个资源集合。	删除标记为 1234 的数字资源。	D（删除）

元注解信息说明

生存周期说明

1. 默认不使用注解，表示生存周期等于request，请求过后自动销毁，默认是线程安全的。

2. application，使用@Singleton注解。生存周期等于整个应用程序的生存周期。

3. session,使用@PerSession注解。生存周期等于一个session请求，session销毁，该rest资源实例也同时销毁。

Bean注解说明

1.@Path
路径信息，表示映射出去的访问路径。
范例如下：@Path("/myResource")

2. @Produces
用于限制post和get方法返回的参数类型，支持json、string、xml、html
范例如下：@Produces({"application/xml", "application/json"})

3. @Consumes
用于限制输入的参数的类型，支持json、string、xml、html
范例如下：@Consumes("text/plain")

4. @QueryParam

通过request传入的参数，可以转换任何有以String为参数的构造函数的类。

5.@DefaultValue
@DefaultValue表示默认参数。
范例如下：@DefaultValue("2") @QueryParam("step") int step,

5. @PathParam
@ MatrixParam，@ HeaderParam，@ CookieParam和@ QueryParam FormParam听从以相同的规则。
@ MatrixParam提取URL路径段的信息。 @ HeaderParam提取的HTTP头信息。 @ CookieParam提取信息的Cookie饼干宣布相关的HTTP标头。
@ FormParam略有特殊，因为它提取请求表示，该类型匹配前面的@Consumes所声明的类型。

范例如下：

@POST

@Consumes("application/x-www-form-urlencoded")

public void post(@FormParam("name") String name) {

6.pojo层面等相关注解，@XmlRootElement,支持JPA注解。