Spring Data 團隊很高興地宣佈使用 RESTful 語義將領域物件匯出到 Web 的下一個重要進展:Spring Data REST 1.1.0.M1 現已在 SpringSource 里程碑倉庫中提供。
Spring Data REST 主頁 | GitHub 上的原始碼 | 參考文件
將領域物件匯出到 Web
Spring Data REST 是一組 Spring MVC 元件,您可以將其新增到自己的 Spring MVC 應用中,以便使用 RESTful、HATEOAS 語義將您的 Spring Data Repository 匯出到 Web。它透過將 Repository 匯出到可通過幾種不同方式配置的 RESTful URL 來提供一致的互動 API。
Spring Data REST 支援頂級實體(由 Spring Data Repository 直接管理的領域物件)的 CRUD 操作,只需編寫一行程式碼,定義一個擴充套件 Spring Data CrudRepository 介面的介面即可。完成這些後,您的實體將擁有完整的 RESTful 語義。您可以使用遵循 HATEOAS 原則、可發現的標準 URL 建立新實體、更新現有實體以及刪除它們。這意味著訪問您的 Spring Data REST 應用程式的使用者代理不需要提前知道您正在匯出哪些資源。它可以透過對 JSON 中提供的 URL 進行連續呼叫來發現存在哪些實體以及這些實體上存在哪些關係。這些“連結”是 HATEOAS REST 應用程式的真正基礎和力量所在。
從頭開始的更改
版本 1.1 幾乎是完全重寫的。它不僅比 1.0 更易於配置,並且更好地符合 Spring 3.2 過渡的 Spring MVC 期望,而且 Spring Data REST 內部最大的變化是它現在支援除 JPA 之外的其他型別的 Spring Data repository 實現。無論使用何種後端資料儲存,CRUD 和管理關係(如果資料儲存支援)的 HTTP 語義保持不變。
這意味著現在可以在同一個 Spring Data REST 應用程式中匯出 JPA 實體和 MongoDB 實體,並使用通用的 URL 結構以及標準的 Spring HATEOAS Resource 表示形式來訪問所有實體和集合。訪問這些 RESTful URL 的使用者代理不需要特殊瞭解後端實體由哪個資料儲存管理,而且最重要的是,您無需編寫任何程式碼即可獲得該功能!
MongoDB 支援
Spring Data REST 1.1 現在支援匯出 MongoDB CrudRepository 實現。相同的 HTTP 語義適用於 MongoDB @Document 實體和 JPA 實體。當然支援 GET、POST、PUT、DELETE,也支援 @DBRef。您可以使用 GET、POST、PUT 和 DELETE 檢視和管理兩個文件之間的關係,並且可以根據您的 @Query 定義匯出 finder 方法。請參閱 spring-data-mongodb 參考文件,瞭解物件對映與 JPA 風格對映的不同之處以及查詢定義的完整詳細資訊。
Gemfire 支援
Spring Data REST 1.1 現在支援將使用高效能 Gemfire 資料庫的實體匯出到不同的區域(Region)。閱讀 Spring Data Gemfire 文件,瞭解詳細的配置選項以及 Gemfire 中的 POJO 對映與其他對映技術的不同之處。
接下來將支援 Neo4J
Spring Data REST 1.1 現已準備好在下一版本 spring-data-neo4j 2.3 中支援 Neo4J GraphRepository。當該版本普遍可用時(應該在 Spring Data REST 1.1 RELEASE 普遍可用時或之前),您將能夠使用標準的 HATEOAS 語義訪問 @NodeEntity 及其關係,就像您使用其他資料儲存一樣。
新增到您現有的應用中
Spring Data REST 的設計方式是,如果您願意,可以為 Spring Data REST 應用程式建立一個完整的應用程式。畢竟,它只是一個標準的 Spring MVC Web 應用。但是當您將 Spring Data REST 新增到您自己的服務中時,事情會變得非常有趣。
Spring HATEOAS 作者 Oliver Gierke 建立了一個示例應用程式,演示了在現代 Web 應用程式中使用 HATEOAS 原則。它被稱為 spring-restbucks,是 Jim Webber、Savas Parastatidis 和 Ian Robinson 在《REST in Practice》一書中描述的 Restbucks 應用程式的實現,該書是關於 REST 服務的系統性理論:《REST 實戰》。
混合使用 REST 服務
透過將 Spring Data REST 與您的其他 RESTful 服務混合使用,您可以在 Spring Data REST 匯出的那些領域物件(您無需編寫任何程式碼即可將其公開)與那些不代表實際實體而是流程的服務之間實現無縫整合。您可以在 spring-restbucks 應用程式中看到支付服務如何與領域物件 CRUD 互動的示例,其中信用卡支付處理由自定義控制器處理,而物件 CRUD 由 Spring Data REST 處理。您的自定義控制器實際上可以 piggyback(搭乘)在 Spring Data REST URL 上,以便在整個應用程式中保持一致且簡單的 URL 結構,無論該 URL 指向您的自定義控制器、Spring Data REST JPA Repository 還是任何其他支援的 Repository 樣式。
它不是排他性的
Spring Data REST 不是非此即彼的選擇。如果您不想將所有 Repository 都暴露給 Web 客戶端,沒問題!有幾種不同的方式可以關閉 Repository 的功能。您可以在原始碼中嵌入註解,或者,如果您沒有訪問許可權或根本無法新增 Spring Data REST 註解,您可以使用流暢的 DSL 風格配置來告訴 Spring Data REST 如何公開您的資源。在您的應用程式中使用 Spring Data REST 並不是對某一種方式的專屬承諾。Spring Data REST 的結構使其能夠與您現有的應用程式良好協作,因此您可以整合您想要的 Spring Data REST 功能片段,同時仍然保留您習慣在 Spring MVC 控制器中建立的所有自定義編碼服務。
JSONP 支援將移至過濾器
Spring Data REST 1.0 中內建的 JSONP 支援已從核心框架中移除,取而代之的是即將推出的通用 JSONP Servlet Filter,它的工作效果將遠優於 1.0 版本中 JSONP 的實現方式。當該過濾器普遍可用時,JSONP 支援不僅可以新增到 Spring Data REST 中,還可以新增到幾乎任何基於 Servlet 的 REST 資源中。
安裝與文件
要開始嘗試使用 Spring Data REST,請檢視參考文件,瞭解其概況,然後透過簡單地將 spring-data-rest-webmvc artifact(目前在SpringSource 里程碑倉庫中為 1.1.0.M1)新增到您的專案中,從而在您自己的應用程式中開始使用它,然後匯入 Spring Data REST 配置,就像您在 spring-restbucks 應用程式中看到的那樣。
在 CONFESS_2013 瞭解更多資訊
如果您計劃參加 4 月第一週在維也納舉行的 CONFESS_2013 會議,那麼您可以在我關於將實體直接匯出到 Web 的演講中瞭解所有關於 Spring Data REST 的資訊。
連結
Spring Data REST 主頁 | GitHub 上的原始碼 | 參考文件