Moco介紹

在開發過程中，經常會使用到一些http網路介面，而這部分功能通常是由第三方開發團隊或者是後端同事進行開發的，在我們開發時不能給我們提供服務，更有甚者，要整合的服務在開發時還不存在。這為我們的聯調和測試造成了麻煩，常見的解決方案是搭建一個web server。

為什麼要開發Moco這個框架？

具體到模擬服務上，處理的手法也是各種各樣，因為服務以HTTP整合居多，無論是Web Service，還是REST，所以，一種典型的做法是，開發一個模擬服務，打成WAR包，部署到一個應用伺服器上。而我們知道，一旦牽扯到應用伺服器部署，就是非常耗時的，部署的時間量級通常是分鐘級的。而且，模擬伺服器通常不是一次性的工作，我們需要在開發過程中，反覆調整，這就進一步增加了維護一個模擬伺服器的成本。有的應用伺服器是非常消耗資源的，要用專門的機器來部署它。更進一步，如果機器資源有限，團隊就只能共享一臺機器，這樣，即便我為測試自己的部分做一個小的改動，很有可能因為得不到機器的使用權，而要等上幾天時間

Moco就是針對這樣一個特定的場景而生的。Moco是一個簡單搭建模擬伺服器的程式庫/工具，這個基於 Java 開發的開源專案已經在 Github 上獲得了不少的關注。該專案的簡介是這樣描述自己的：Moco 是一個簡單搭建 stub 的框架，主要用於測試和整合。

開發團隊只要根據自己的需要進行相應的配置，就會很方便得到一個模擬伺服器。而且，由於 Moco 本身的靈活性，其用途已經不再侷限於最初的整合測試，比如，Moco 可以用於移動開發，模擬尚未開發的服務；Moco 還可以用於前端開發，模擬一個完整的 Web 伺服器等等。

Moco本身支援API和獨立執行兩種方式。通過使用API，開發人員可以在JUnit、JBehave等測試測試框架裡使用Moco，極大程度地降低了整合點測試的複雜度

Moco可以提供以下服務：

• HTTP APIs
• Socket APIs
• REST API

Moco原理簡介：Moco會根據一些配置，啟動一個真正的HTTP服務（會監聽本地的某個埠）。當發起請求滿足一個條件時，它就給回覆一個應答。Moco的底層沒有依賴於像Servlet這樣的重型框架，而是基於一個叫Netty網路應用框架直接編寫的，這樣一來，繞過了複雜的應用伺服器，所以，它的速度是極快的

Moco獨立執行所需環境

Moco獨立執行時所需準備的有：

• Java執行環境
• moco-runner-0.11.0-standalone.jar

如何執行Moco

啟動http服務

Moco的執行非常簡單，只需要一行命令即可
如在命令列中執行：java -jar <path-to-moco-runner> http -p <monitor-port> -c < configuration -file>

• <path-to-moco-runner>：moco-runner-0.11.0-standalone.jar包的路徑
• <monitor-port>：http服務監聽的埠
• <configuration -file>：配置檔案路徑

這就在本地啟動了一個http server，其中監聽埠是12345，配置檔案是MocoApi.json。只要在本機發起一個請求，如：http://localhost:12345，該請求就會被這個web server handle

如果別的機子想訪問這個服務，只要把localhost替換成本機IP即可

啟動https服務

啟動https服務，需要先生成證書，並用如下命令啟動服務：地方多發呆發地方的地方的地方的發呆發：java -jar <path-to-moco-runner> https -p <monitor-port> -c < configuration -file> --https <path-to-cert.jks > --cert mocohttps --keystore mocohttps

• <path-to-moco-runner>：moco-runner-0.11.0-standalone.jar包的路徑
• <monitor-port>：http服務監聽的埠
• <configuration -file>：配置檔案路徑
• <path-to-cert.jks>：證書路徑

這就在本地啟動了一個http server，其中監聽埠是12346，配置檔案是MocoApi.json，證書檔案是test.cer

Moco HTTP(s) API配置

啟動服務之後，必然會根據需求stub出各種各樣介面反饋，我們會把這個配置放在一個json檔案中，啟動Moco的時候，需要指定使用的配置檔案路徑，這樣配置就可以生效了。Moco服務可以檢測到配置檔案的變更，假如你修改了配置檔案，不需要重新啟動Moco，服務照樣可以生效。更詳細的配置介紹請檢視：https://github.com/dreamhead/moco/blob/master/moco-doc/apis.md

配置檔案的工作原理大致如下：

如何在配置檔案添加註釋

json不支援註釋，想要添加註釋的話，可以在description欄位中加入描述

約定請求Body

約定介面的uri

約定請求引數

約定請求方法

約定HTTP版本

約定請求頭部

約定cookie

約定請求form

表單可以新增多項，多項的時候，必須全部匹配，接口才算匹配成功

約定以指定xml作為請求body

用xpath對請求進行匹配

約定以指定json作為請求body

用正則表示式對請求進行匹配

匹配操作

設定Response content

設定Response 狀態碼

設定Response HTTP版本

設定Response 頭部

設定重定向

設定cookie

掛載檔案

template的用法

Moco內建了一些變數，在response中可以使用這些變數，讓反饋更加智慧，以下列舉了常用的變數

• req.version
• req.version
• req.method
• req.content
• req.headers
• req.queries
• req.forms
• req.cookies

使用舉例如下：

Moco在單元測試中使用

Moco除了可以單獨執行外，還可以在單元測試中執行，測試過程中，Moco會啟動一個web server來處理我們的請求

執行在單元測試中的moco server也可以選擇載入json配置檔案

通過stub後臺，便可對http請求進行測試了

Moco的不足

Moco的使用很簡單，配置也很方便，目前更是提供了http、rest、socket服務。但是也僅僅是能stub出介面，模擬出簡單的場景。如果接收到請求後需要做一些處理，如需查詢資料庫、進行運算、或者一些複雜的操作，就無能為力了。所以是否選用Moco，就取決於開發者是否只是需要一個簡單的模擬伺服器。