RESTful Services Java (JAX-RS)


JAX-RS代表RESTful Web服務的Java API。JAX-RS是一款基於JAVA的程式設計語言和API規範,為建立基於RESTful Web服務提供支援。它的2.0版本發布於2013年5月24日。JAX-RS大量使用從Java SE5注釋可用來簡化基於Java Web服務建立和部署開發。 它還提供支援建立用戶端RESTful Web服務。

規範

下面是通常用於註解對映的資源作為Web服務的資源。

S.N. 註解 & 描述
1 @Path
資源類/方法的相對路徑。
2 @GET
HTTP GET請求,用於獲取資源。
3 @PUT
HTTP PUT請求,用於建立資源。
4 @POST
HTTP POST請求,用於建立/更新資源。
5 @DELETE
HTTP DELETE請求,用於刪除的資源。
6 @HEAD
HTTP HEAD請求,用來獲取方法可用狀態。
7 @Produces
狀態通過Web服務產生的HTTP響應,例如APPLICATION/XML, TEXT/HTML, APPLICATION/JSON等。
8 @Consumes
狀態的HTTP請求型別,例如 application/x-www-form-urlencoded 接受POST請求的過程中HTTP主體表單資料。
9 @PathParam
結合傳遞到方法,在路徑中的值的引數。
10 @QueryParam
結合傳遞給方法的路徑中的查詢引數的引數。
11 @MatrixParam
結合傳遞給方法的路徑中的HTTP矩陣引數的引數。
12 @HeaderParam
結合傳遞到方法到HTTP頭中的引數。
13 @CookieParam
結合傳遞給方法一個Cookie引數。
14 @FormParam
結合傳遞到方法的一種形式值的引數。
15 @DefaultValue
分配一個預設值,以傳遞一個引數給方法。
16 @Context
上下文中資源,例如HTTP請求的上下文。