Moco介紹
在開發(fā)過程中,經(jīng)常會使用到一些http網(wǎng)絡接口,而這部分功能通常是由第三方開發(fā)團隊或者是后端同事進行開發(fā)的帚湘,在我們開發(fā)時不能給我們提供服務,更有甚者甚淡,要集成的服務在開發(fā)時還不存在大诸。這為我們的聯(lián)調(diào)和測試造成了麻煩,常見的解決方案是搭建一個web server材诽。
為什么要開發(fā)Moco這個框架底挫?
具體到模擬服務上,處理的手法也是各種各樣脸侥,因為服務以HTTP集成居多,無論是Web Service盈厘,還是REST睁枕,所以,一種典型的做法是沸手,開發(fā)一個模擬服務外遇,打成WAR包,部署到一個應用服務器上契吉。而我們知道跳仿,一旦牽扯到應用服務器部署,就是非常耗時的捐晶,部署的時間量級通常是分鐘級的菲语。而且妄辩,模擬服務器通常不是一次性的工作,我們需要在開發(fā)過程中山上,反復調(diào)整眼耀,這就進一步增加了維護一個模擬服務器的成本。有的應用服務器是非常消耗資源的佩憾,要用專門的機器來部署它哮伟。更進一步,如果機器資源有限妄帘,團隊就只能共享一臺機器楞黄,這樣,即便我為測試自己的部分做一個小的改動抡驼,很有可能因為得不到機器的使用權谅辣,而要等上幾天時間
Moco就是針對這樣一個特定的場景而生的。Moco是一個簡單搭建模擬服務器的程序庫/工具婶恼,這個基于 Java 開發(fā)的開源項目已經(jīng)在 Github 上獲得了不少的關注桑阶。該項目的簡介是這樣描述自己的:Moco 是一個簡單搭建 stub 的框架,主要用于測試和集成勾邦。
開發(fā)團隊只要根據(jù)自己的需要進行相應的配置蚣录,就會很方便得到一個模擬服務器。而且眷篇,由于 Moco 本身的靈活性萎河,其用途已經(jīng)不再局限于最初的集成測試,比如蕉饼,Moco 可以用于移動開發(fā)虐杯,模擬尚未開發(fā)的服務;Moco 還可以用于前端開發(fā)昧港,模擬一個完整的 Web 服務器等等擎椰。
Moco本身支持API和獨立運行兩種方式。通過使用API创肥,開發(fā)人員可以在JUnit达舒、JBehave等測試測試框架里使用Moco,極大程度地降低了集成點測試的復雜度
Moco可以提供以下服務:
- HTTP APIs
- Socket APIs
- REST API
Moco原理簡介:Moco會根據(jù)一些配置叹侄,啟動一個真正的HTTP服務(會監(jiān)聽本地的某個端口)巩搏。當發(fā)起請求滿足一個條件時,它就給回復一個應答趾代。Moco的底層沒有依賴于像Servlet這樣的重型框架贯底,而是基于一個叫Netty網(wǎng)絡應用框架直接編寫的,這樣一來撒强,繞過了復雜的應用服務器禽捆,所以笙什,它的速度是極快的
Moco已經(jīng)在github上開源,可點擊連接:https://github.com/dreamhead/moco
Moco獨立運行所需環(huán)境
Moco獨立運行時所需準備的有:
- Java運行環(huán)境
- 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服務監(jiān)聽的端口 -
<configuration -file>
:配置文件路徑
這就在本地啟動了一個http server得湘,其中監(jiān)聽端口為12345,配置文件是MocoApi.json顿仇。只要在本機發(fā)起一個請求淘正,如:http://localhost:12345,該請求就會被這個web server handle
如果別的機子想訪問這個服務臼闻,只要把localhost替換成本機IP即可
啟動https服務
啟動https服務鸿吆,需要先生成證書,并用如下命令啟動服務:地方多發(fā)呆發(fā)地方的地方的地方的發(fā)呆發(fā):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服務監(jiān)聽的端口 -
<configuration -file>
:配置文件路徑 -
<path-to-cert.jks>
:證書路徑
這就在本地啟動了一個http server述呐,其中監(jiān)聽端口是12346惩淳,配置文件是MocoApi.json,證書文件是test.cer
Moco HTTP(s) API配置
啟動服務之后乓搬,必然會根據(jù)需求stub出各種各樣接口反饋思犁,我們會把這個配置放在一個json文件中,啟動Moco的時候进肯,需要指定使用的配置文件路徑激蹲,這樣配置就可以生效了。Moco服務可以檢測到配置文件的變更江掩,假如你修改了配置文件学辱,不需要重新啟動Moco,服務照樣可以生效环形。更詳細的配置介紹請查看:https://github.com/dreamhead/moco/blob/master/moco-doc/apis.md
配置文件的工作原理大致如下:
如何在配置文件添加注釋
json不支持注釋策泣,想要添加注釋的話,可以在description字段中加入描述
約定請求Body
約定接口的uri
約定請求參數(shù)
約定請求方法
約定HTTP版本
約定請求頭部
約定cookie
約定請求form
表單可以添加多項抬吟,多項的時候萨咕,必須全部匹配,接口才算匹配成功
約定以指定xml作為請求body
用xpath對請求進行匹配
約定以指定json作為請求body
用正則表達式對請求進行匹配
匹配操作
設置Response content
設置Response 狀態(tài)碼
設置Response HTTP版本
設置Response 頭部
設置重定向
設置cookie
掛載文件
template的用法
Moco內(nèi)置了一些變量拗军,在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出接口愉烙,模擬出簡單的場景讨盒。如果接收到請求后需要做一些處理,如需查詢數(shù)據(jù)庫步责、進行運算返顺、或者一些復雜的操作,就無能為力了蔓肯。所以是否選用Moco遂鹊,就取決于開發(fā)者是否只是需要一個簡單的模擬服務器。