Spring Data REST 1.1.0.M1 釋出

版本釋出 | Jon Brisbin | 2013年3月11日 | ...

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 Repositories 匯出到 Web。它透過將倉庫匯出到 RESTful URL 來提供一致的互動 API,這些 URL 可以通過幾種不同的方式進行配置。

Spring Data REST 支援頂級實體(由 Spring Data Repository 直接管理的領域物件)的 CRUD 操作,只需編寫一行程式碼定義一個擴充套件 Spring Data 的 CrudRepository 介面的介面即可。完成此操作後,您的實體就擁有完整的 RESTful 語義。您可以建立新實體、更新現有實體以及使用標準 URL 刪除它們,這些 URL 遵循 HATEOAS 原則,是可發現的。這意味著訪問您的 Spring Data REST 應用程式的使用者代理無需預先知道您匯出了哪些資源。它可以透過對 JSON 中提供的 URL 進行連續呼叫來發現存在哪些實體以及這些實體上存在哪些關係。這些“連結”是 HATEOAS REST 應用程式的真正基礎和強大之處。

徹底重寫

1.1 版本幾乎是徹底重寫。它不僅比 1.0 版本更容易配置,並且更好地符合 Spring 3.2 過渡的 Spring MVC 預期,而且 Spring Data REST 內部的最大變化在於它現在支援 JPA 之外的其他型別的 Spring Data 倉庫實現。無論使用何種後端資料儲存,CRUD 和管理關係(如果資料儲存支援)的 HTTP 語義都保持不變。

這意味著現在可以在同一個 Spring Data REST 應用程式中匯出 JPA 實體和 MongoDB 實體,並使用通用 URL 結構和標準的 Spring HATEOAS Resource 表示形式訪問所有實體和集合。訪問這些 RESTful URL 的使用者代理無需瞭解後端實體由哪個資料儲存管理,最重要的是,您無需編寫任何程式碼即可獲得此功能!

MongoDB 支援

Spring Data REST 1.1 現在支援匯出 MongoDB CrudRepository 實現。與 JPA 實體一樣,同樣的 HTTP 語義適用於 MongoDB @Document 實體。當然支援 GET、POST、PUT、DELETE,@DBRef 也支援。您可以使用 GET、POST、PUT 和 DELETE 檢視和管理兩個文件之間的關係,並且可以根據您的 @Query 定義匯出查詢方法。請參考 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 系統神學:REST in Practice》中描述的 Restbucks 應用程式的實現。

混合 REST 服務

透過將 Spring Data REST 與您的其他 RESTful 服務混合使用,您可以在 Spring Data REST 匯出的領域物件(您無需編寫任何程式碼即可公開這些物件)與不代表實際實體而是代表過程的服務之間實現無縫整合。您可以在 spring-restbucks 應用程式中看到支付服務如何與領域物件 CRUD 互動的示例,其中信用卡支付處理由自定義控制器處理,而物件 CRUD 由 Spring Data REST 處理。您的自定義控制器實際上可以附加到 Spring Data REST URL 上,以便無論 URL 指向您的自定義控制器、Spring Data REST JPA Repository 還是其他任何受支援的 Repository 樣式,整個應用程式都可以保持一致且簡單的 URL 結構。

並非獨佔

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 過濾器,其效果將遠好於 1.0 版本中 JSONP 的實現方式。當該過濾器正式釋出時,JSONP 支援不僅可以新增到 Spring Data REST,還可以新增到幾乎任何基於 Servlet 的 REST 資源。

安裝和文件

要開始使用 Spring Data REST,請查閱參考文件,以便了解情況,然後透過簡單地向 spring-data-rest-webmvc artifact(目前在 SpringSource 里程碑倉庫中的版本為 1.1.0.M1)新增依賴項,並在您自己的應用程式中開始使用它,然後像 spring-restbucks 應用程式中所示那樣匯入 Spring Data REST 配置。

在 CONFESS_2013 瞭解更多

如果您計劃參加四月第一週在維也納舉行的 CONFESS_2013,那麼您可以在我關於將實體匯出到 Web 的演講中瞭解所有關於 Spring Data REST 的資訊。

連結

Spring Data REST 主頁 | GitHub 上的原始碼 | 參考文件

訂閱 Spring 新聞郵件

訂閱 Spring 新聞郵件,保持聯絡

訂閱

領先一步

VMware 提供培訓和認證,助您加速前進。

瞭解更多

獲取支援

Tanzu Spring 提供 OpenJDK™、Spring 和 Apache Tomcat® 的支援和二進位制檔案,一個簡單訂閱即可獲得。

瞭解更多

即將舉行的活動

檢視 Spring 社群所有即將舉行的活動。

檢視全部