本篇介紹這個版本中引入的新技術。這些新技術使這個平臺變得更加強大，其中三個重要的新技術包括：

　　◆RESTful Web Services Java API (JAX-RS)

　　◆面向Java EE平臺的上下文和依賴性注入(CDI)

　　◆Bean驗證

　　本文將介紹RESTful Web Services Java API (JAX-RS)。

　　RESTful Web Services Java API (JAX-RS)

　　RESTful Web Services Java API (JAX-RS)，JSR 311讓你可以迅速構建遵循REST(Representational State Transfer，表象化狀態轉變。參考閱讀：《什么是REST》)風格軟件架構的輕量級Web服務。REST中的一個重要概念是資源的存在性，每個資源都一個全局引用標識符，即URI。特別是數據和函數都被認為是可通過URI識別和訪問的資源。為了操縱這些資源，網絡組件，客戶端和服務器通過一個標準的接口通信，如HTTP和一個組固定的動詞 — GET，PUT，POST和DELETE — 交換這些資源。

　　RESTful Web服務是按照REST架構風格構建的Web服務，利用RESTful方法使用基于SOAP的技術構建Web服務已經成為一個受歡迎的選擇，這都得感謝REST的輕量級特性和直接通過HTTP傳輸數據的能力。

　　JAX-RS為在Java中構建RESTful Web服務提供了標準化API，API提供了一組注解，以及相關的類和接口。對POJO應用注解允許你暴露Web資源，這個方法使得在Java中創建RESTful Web服務變得簡單。

　　JAX-RS 1.0技術規范定稿于2008年10月，包括了一個參考實現Jersey，Java EE 6包括了這個技術規范的最新版本JAX-RS 1.1，這個版本與Java EE 6中的新特性保持一致。

　　下面我們一起來看一個使用JAX-RS構建的RESTful Web服務：

　   import javax.ws.rs.Path;
　　import javax.ws.rs.Produces;
　　import javax.ws.rs.Get;
　　import javax.ws.rs.Post;
　　import javax.ws.rs.Consumes;
　　import javax.ws.rs.core.Response;
　　import javax.ws.rs.core.MediaType;
　　import javax.ws.rs.core UriInfo;
　　import javax.ws.rs.core.UriBuilder;
　　import java.net.URI;
　　@Path ("items")
　　@Produces (MediaType.APPLICATION_XML)
　　Public class ItemsResource {
　　@Context UriInfo uriInfo;
　　@GET
　　Items listItems() {
　　Return Allitems();
　　}
　　@POST
　　@Consumes (MediaType.APPLICATION_XML)
　　Public Response create(Item item) throws ItemCreationException {
　　Item newItem = createItem(item);
　　URI newItemURI = uriInfo.getRequestUriBuilder().path(newItem.getId()).build();
　　return Response.created(newItemURI).build();
　　}
　　...
　　}

 　　在這個例子中，ItemsResource類是管理一組項目的Web服務，類中導入了JAX-RS 1.1注解，類和接口。

　　@Path注解指定了資源的相對路徑，在這里是“items”，類資源URI是基于應用程序上下文的，因此，如果應用程序上下文在這個例子中是//example.com，那么類資源的URI就是//example.com/items，這意味著如果一個客戶端直接請求URI //example.com/items，ItemsResource類將會執行。

　　@GET注解指定了注解的方法，這里是listItems()方法，它處理HTTP GET請求，當某個客戶端直接發起對ItemsResource資源的HTTP GET請求時，JAX-RS運行時調用listItems()方法處理這個GET請求。

　　注意@Produces注解，它指定了返回給客戶端的MIME媒體類型，在ItemsResource這個例子中，@Produces注解指定了MediaType.APPLICATION_XML，MediaType類是一個抽象的MIME媒體類型，MediaType.APPLICATION_XML是XML內容MIME媒體類型的抽象 — application/xml。

　　注解如@Produces建議JAX-RS自動轉換某些內容類型，例如，listItems()方法返回一個Items類型的Java對象，JAX-RS自動將這個Java類型轉換成application/xml MIME類型，使用這個MIME類型響應客戶端的HTTP請求。注意僅當返回的類型默認是支持的才會自動轉換，例如，如果Items是一個JAXB注解Bean，那么將會自動轉換，但如果Items是一個POJO，你需要執行MessageBodyReader處理序列化。

　　你也可以在一個方法上指定@Produces注解，在上面的例子中，你在方法上指定的MIME類型覆蓋了在類的@Produces注解中指定的MIME類型，例如，你可以象下面這樣為listItems()方法指定@Produces注解：

 　@GET @Produces (MediaType.TEXT_PLAIN) Items listItems() { Return Allitems(); }

 　　JAX-RS然后會將Items Java類型轉換為text/plain MIME類型，返回這種類型的內容給HTTP請求客戶端。

　　@POST注解指定了注解的方法，這里是create()方法，它負責響應HTTP POST請求。在這個例子中，這個方法創建了一個新項目，然后返回一個表示它已創建了一個新項目的響應，當客戶端直接向ItemsResource資源發起HTTP POST請求時，JAX-RS運行時調用create()方法處理POST請求。

　　注意@Consumes注解是在create()方法上指定的，注解指定了方法能夠接受的來自客戶端的MIME媒體類型。如果你在類上指定@Consumes，它適用于類中的所有方法，如果你在方法上指定@Consumes，它會覆蓋你在類上指定的@Consumes注解包含的MIME類型。在這個例子中，@Consumes注解指定create()方法可接受XML內容，即MIME類型application/xml，這是從MIME類型轉換到Java類型。當某個客戶端在POST請求中提交XML內容時，JAX-RS調用create()方法自動將傳入的XML內容轉換成方法需要的Item Java類型。

　　JAX-RS也包括大量的進一步簡化有關構建行為的實用類和接口，前面看到的MediaType就是這樣的類，它抽象了MIME媒體類型。其它的一些類和接口是：

　　UriInfo：訪問URI信息的接口，在這個例子中，@Context注解注入UriInfo接口到ItemsResource類中的uriInfo字段。

　　UriBuilder：從它們的組件構建URI的類。

　　Response：代表HTTP響應的類。

　　Response.ResponseBuilder：根據著名的Builder模式構建Response對象的類。

　　這些類和接口在下面這些語句中非常有用：

   　URI newItemURI = uriInfo.getRequestUriBuilder().path(newItem.getId()).build();
　　return Response.created(newItemURI).build();

 　　第一個語句為新項目構建一個URI，getRequestUriBuilder()方法是創建UriBuilder對象的UriInfo方法，path() 和 build()方法是為新項目一起構造URI的UriBuilder方法。

　　第二個語句為新項目創建一個返回給客戶端的Response對象，created方法是一個創建Response.ResponseBuilder 對象的Response方法，build()方法是一個為新項目創建Response 對象的Response.ResponseBuilder方法，這個對象提交元數據給JAX-RS運行時構造HTTP響應。

　　這些實用類和接口隱藏了HTTP編程的許多復雜性，使用JAX-RS的另一個原因是它簡化了構建RESTful Web服務，JAX-RS可以簡化許多類型的Web應用程序，例如，如果你需要構建一個檢查HTTP頭的應用程序，JAX-RS比采用其它技術就更簡單。

　　JAX-RS還有其它便捷功能，例如，JAX-RS包括大量基于參數的注解，從請求中提取信息，@QueryParam就是這樣的注解，通過它你可以從請求URL中的Query組件提取查詢參數，其它基于參數的注解還有@MatrixParam，它從URL路徑提取信息，@HeaderParam注解從HTTP頭提取信息，@CookieParam從Cookies提取信息。