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（刪除）

?

相關的架包結構

·??????核心服務器：jersey-core.jar，jersey-server.jar，jsr311-api.jar，asm.jar

·??????核心客戶端：（用于測試）jersey-client.jar

·??????JAXB?支持：（在高級樣例中使用）jaxb-impl.jar，jaxb-api.jar，activation.jar，stax-api.jar，wstx-asl.jar

·??????JSON?支持：（在高級樣例中使用）jersey-json.jar

·??????Spring支持：（在高級樣例中使用）jersey-spirng.jar

元注解信息說明

生存周期說明

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注解。

總結

以上是生活随笔為你收集整理的Jersey注解详解的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。