基于Spring設(shè)計(jì)并實(shí)現(xiàn)RESTful Web Services
在本教程中，你將會(huì)使用Spring來(lái)創(chuàng)建一個(gè)具有生產(chǎn)力的RESTful網(wǎng)絡(luò)服務(wù)。
為什么用RESTful網(wǎng)絡(luò)服務(wù)?
從和Amazon Web Services的整合，到聚合多個(gè)數(shù)據(jù)源，RESTful網(wǎng)絡(luò)服務(wù)遵從了Roy Fielding的架構(gòu)風(fēng)格的指導(dǎo)方針，提供了簡(jiǎn)單、高效的web APIs，支持的API用戶數(shù)量從少量到***別。
你要實(shí)現(xiàn)一個(gè)RESTful風(fēng)格的網(wǎng)絡(luò)服務(wù)，可能會(huì)是因?yàn)?
- 你正在創(chuàng)建一個(gè)API，而客戶端需要通過(guò)網(wǎng)絡(luò)才能使用它。
- 你想要開(kāi)放你們單位的數(shù)據(jù)提供給各類客戶們通過(guò)網(wǎng)絡(luò)來(lái)使用。
- 你需要把你的應(yīng)用和組織內(nèi)其它應(yīng)用整合起來(lái)，但是你無(wú)法控制其它應(yīng)用所用的語(yǔ)言、工具或架構(gòu)。
或者你只是出于好奇想看看Spring實(shí)現(xiàn)的RESTful網(wǎng)絡(luò)服務(wù)長(zhǎng)什么樣子。不管處于什么原因，你找對(duì)地方了。
你將創(chuàng)建什么
Yummy Noodle Bar(美味面條吧)正在全球化。它想要給一系列商務(wù)聚合組織提供一個(gè)RESTful Web服務(wù)，特別是Let’s Nosh(讓我們來(lái)點(diǎn)小吃)，一個(gè)受歡迎的餐廳指南，它將大型商務(wù)引入小規(guī)模的面條吧。你將擴(kuò)展Yummy Noodle Bar的內(nèi)部應(yīng)用程序，創(chuàng)建一個(gè)新的公共Web API以供提交，跟蹤，取消，以及修改訂單。
你需要什么
- 大約每節(jié)三十分鐘。你應(yīng)該能夠在每周的午餐時(shí)間，通過(guò)整個(gè)教程，以您的方式輕松的工作（或在周末做這一切?。?/li>
- 安裝構(gòu)建工具Gradle，版本1.6或更高版本。
- 一份代碼拷貝（可通過(guò)git 或下載的ZIP文件獲得）。
- 你選擇的IDE。Spring推薦Spring Tool Suite，這是免費(fèi)下載的。
下載并運(yùn)行代碼
如果你下載過(guò)基礎(chǔ)代碼，你會(huì)發(fā)現(xiàn)本教程每節(jié)都在一個(gè)單獨(dú)的文件夾，編號(hào)為1，2，3，等。也有一些代碼片段：實(shí)際上是原始的，并且每個(gè)部分有單獨(dú)的完整代碼片段。
初始的 代碼集包括：
- 一個(gè)項(xiàng)目布局
- 本教程開(kāi)始創(chuàng)建的核心領(lǐng)域與事件類（上面的'Yummy Noodle Bar Application'）
- 對(duì)于這些類的一些基本的單元測(cè)試
每個(gè)部分的完整代碼在包括初始代碼的基礎(chǔ)上，再加上教程某一點(diǎn)的實(shí)現(xiàn)代碼。
你可以選擇從初始代碼集，或者你也可以從一個(gè)給定部分的完整代碼集開(kāi)始。不是每個(gè)代碼文件都顯示在教程中，因?yàn)槟菚?huì)將事情搞得很慢。但重要的事情是，比如寫測(cè)試，創(chuàng)建RESTful服務(wù)，以及看一些關(guān)鍵領(lǐng)域的對(duì)象。
有許多用于構(gòu)建的系統(tǒng)，而本教程使用Gradle和Gradle Wrapper來(lái)進(jìn)行構(gòu)建，所以如果你手頭有一份代碼的拷貝，你不需要安裝任何東西來(lái)運(yùn)行這些代碼。
例如，如果你想要檢查最初的代碼集，你可以這樣做:
- $ git clone https://github.com/spring-guides/tut-rest.git
- $ cd tut-rest/initial
- $ ./gradlew clean test
在那里，你可以瀏覽build/reports/tests 并查看所有的測(cè)試結(jié)果。
如果你想跳到第6節(jié)，本教程的***一部分，來(lái)運(yùn)行該web應(yīng)用及其測(cè)試，可以這樣:
- $ cd ../6/complete
- $ ./gradlew tomcatRunWar
在另外一個(gè)控制臺(tái)中輸入：
- $ ./gradlew test
有些章節(jié)不需要運(yùn)行該web應(yīng)用來(lái)執(zhí)行測(cè)試。
Yummy Noodle Bar應(yīng)用框架和核心領(lǐng)域
該應(yīng)用目前的架構(gòu)在下面這個(gè)"Life Preserver"圖中有所展示:
Life Preserver圖是一種工具，用來(lái)構(gòu)建那些遵從了Hexagonal Architecture原則的應(yīng)用，有時(shí)也被稱為'Ports and Adapters'，它最早由Alistair Cockburn進(jìn)行描述。Life Preserver圖展示了你的應(yīng)用的核心領(lǐng)域以及包圍在其周圍的整合領(lǐng)域，這些領(lǐng)域可以直接對(duì)應(yīng)到程序包或組件，你將會(huì)在整個(gè)教程中使用到它們，所以這是一種理解事物模型的很棒的方式。
打開(kāi)初始項(xiàng)目，你將會(huì)看到上面的life preserver圖映射到了src/main/java/com/yummynoodleba目錄下的不同包中。
在核心應(yīng)用的頂層包c(diǎn)om.yummynoodlebar.core中，包含著下列內(nèi)容:
- domain. 組件包，只包含應(yīng)用核心領(lǐng)域概念。這些類是核心領(lǐng)域普世語(yǔ)言（領(lǐng)域驅(qū)動(dòng)設(shè)計(jì)里的術(shù)語(yǔ)，建議參考鏈接里的原文 - 譯者注）的顯式表達(dá)。
- repository. 組件，用于存儲(chǔ)和獲取系統(tǒng)領(lǐng)域?qū)ο蟮漠?dāng)前狀態(tài)。
- event. 組件，包含領(lǐng)域可以接收和處理的事件。
- service. 組件，用于接收到事件時(shí)，處理可執(zhí)行的操作。
花些時(shí)間讓你自己熟悉每個(gè)包里的組件。對(duì)核心領(lǐng)域組件的測(cè)試在項(xiàng)目的src/test里。這些測(cè)試會(huì)告訴你如何使用這些組件。
RESTful web服務(wù)領(lǐng)域
RESTful web服務(wù)能夠把你的應(yīng)用和所有可能用到你服務(wù)的客戶端集成在一起。因此，RESTfulF服務(wù)存在于他們自己的集成領(lǐng)域，在你的應(yīng)用程序核心之外，正如下面的圖一樣，RESTfulF能夠服務(wù)于你的應(yīng)用程序的整個(gè)生命周期中。
把你的應(yīng)用程序和外面的世界整合在一起，需要考慮下面的一些設(shè)計(jì)和實(shí)現(xiàn)約束：
- RESTful服務(wù)API是你的關(guān)注的地方;核心應(yīng)用程序結(jié)構(gòu)不應(yīng)影響API的設(shè)計(jì)。
- 組件實(shí)現(xiàn)RESTful服務(wù)需要提高速度，這樣更適合更多的用戶依賴你的服務(wù)。
- 你的RESTful服務(wù)組件不應(yīng)該包含任何核心應(yīng)用程序邏輯，但是他們需要和你的應(yīng)用程序核心領(lǐng)域組件進(jìn)行合作，這樣更方便協(xié)調(diào)必要的功能服務(wù)接口
英文原文：Designing and Implementing RESTful Web Services with Spring
譯文鏈接：http://www.oschina.net/translate/designing-and-implementing-restful-web-services-with-spring
