使用Golang的官方mock工具--gomock

4C7AD81C-DECF-4C23-802B-9F02EFF42C48.jpg

在Golang的官方Repo(https://github.com/golang/)中有一個單獨的工程叫"mock"(https://github.com/golang/mock),雖然star不是特別多,但它卻是Golang官方放出來的mock工具,充這這點我們也需要使用下,雖然并不是官方的就是最好(比如比標準庫http更快的fasthttp)。

不同場景mock的對象互相不同,那么gomock主要是mock哪些內容呢?

mockgen has two modes of operation: source and reflect. Source mode generates mock interfaces from a source file.
Reflect mode generates mock interfaces by building a program that uses reflection to understand interfaces.

通過gomock的輔助工具我們知道,gomock主要是針對我們go代碼中的接口進行mock的。

安裝

gomock主要包含兩個部分:" gomock庫"和“ 輔助代碼生成工具mockgen”

他們都可以通過go get來獲取:

go get github.com/golang/mock/gomock
go get github.com/golang/mock/mockgen

如何你設置過$GOPATH/bin到你的$PATH變量中,那么這里就可以直接運行mockgen命令了,否則需要使用絕對路徑或者相當于$GOPATH的目錄。

示例

gomock的repo中帶了一個官方的例子,但是這個例子過于強大和豐富,反而不適合嘗鮮,下面我們寫個我們自己的例子(https://www.github.com/cz-it/blog/blog/Go/testing/gomock/example),一個獲取當前Golang最新版本的例子:

tree .
.
├── go_version.go
├── main.go
└── spider
    └── spider.go

目錄結構如上。這里spider.go作為接口文件,定義了spider包的接口:

package spider

type Spider interface {
    GetBody() string
}

這里假設接口GetBody直接可以抓取"https://golang.org"首頁的“Build version”字段來得到當前Golang發布出來的版本。

這里在go_version.go中對這個接口進行使用:

import (
    "github.com/cz-it/blog/blog/Go/testing/gomock/example/spider"
)

func GetGoVersion(s spider.Spider) string {
    body := s.GetBody()
    return body
}

直接返回表示版本的字符串。正常情況下我們會寫出如下的單元測試代碼:

func TestGetGoVersion(t *testing.T) {
    v := GetGoVersion(spider.CreateGoVersionSpider())
    if v != "go1.8.3" {
        t.Error("Get wrong version %s", v)
    }
}

這里spider.CreateGoVersionSpider()返回一個實現了Spider接口的用來獲得Go版本號的爬蟲。

這個單元測試其實既測試了函數GetGoVersion也測試了spider.CreateGoVersionSpider返回的對象。
而有時候,我們可能僅僅想測試下GetGoVersion函數,或者我們的spider.CreateGoVersionSpider爬蟲實現還沒有寫好,那該如何是好呢?

此時Mock工具就顯的尤為重要了。

這里首先用gomock提供的mockgen工具生成要mock的接口的實現:

mockgen -destination spider/mock_spider.go -package spider github.com/cz-it/blog/blog/Go/testing/gomock/example/spider Spider

這里生成了文件:

└── spider
    ├── mock_spider.go
    └── spider.go

這里注意的是,要預先創建好spider/mocks目錄。這樣我們的mock代碼就生成好了,在"spider/mocks/mock_spider.go"文件中。具體的內容可以先不管。這里先看例子中怎么使用:

import (
    "github.com/cz-it/blog/blog/Go/testing/gomock/example/spider"
    "github.com/golang/mock/gomock"
    "testing"
)

func TestGetGoVersion(t *testing.T) {
    mockCtl := gomock.NewController(t)
    mockSpider := spider.NewMockSpider(mockCtl)
    mockSpider.EXPECT().GetBody().Return("go1.8.3")
    goVer := GetGoVersion(mockSpider)

    if goVer != "go1.8.3" {
        t.Error("Get wrong version %s", goVer)
    }
}

這里在單元測試中再也不用先去實現一個Spider接口了,而通過gomock為我們直接生成,然后再集成到我們的單元測試里面。可以看到gomock和testing單元測試框架可以緊密的結合起來工作。

mockgen工具

在生成mock代碼的時候,我們用到了mockgen工具,這個工具是gomock提供的用來為要mock的接口生成實現的。它可以根據給定的接口,來自動生成代碼。這里給定接口有兩種方式:接口文件和實現文件

接口文件

如果有接口文件,則可以通過:

  • -source: 指定接口文件
  • -destination: 生成的文件名
  • -package:生成文件的包名
  • -imports: 依賴的需要import的包
  • -aux_files:接口文件不止一個文件時附加文件
  • -build_flags: 傳遞給build工具的參數

比如mock代碼使用

mockgen -destination spider/mock_spider.go -package spider -source spider/spider.go

就是將接口spider/spider.go中的接口做實現并存在 spider/mock_spider.go文件中,文件的包名為"spider"。

實現文件

在我們的上面的例子中,并沒有使用"-source",那是如何實現接口的呢?mockgen還支持通過反射的方式來找到對應的接口。只要在所有選項的最后增加一個包名和里面對應的類型就可以了。其他參數和上面的公用。

通過注釋指定mockgen

如上所述,如果有多個文件,并且分散在不同的位置,那么我們要生成mock文件的時候,需要對每個文件執行多次mockgen命令(假設包名不相同)。這樣在真正操作起來的時候非常繁瑣,mockgen還提供了一種通過注釋生成mock文件的方式,此時需要借助go的"go generate "工具。

在接口文件的注釋里面增加如下:

//go:generate mockgen -destination mock_spider.go -package spider github.com/cz-it/blog/blog/Go/testing/gomock/example/spider Spider

這樣,只要在spider目錄下執行

go generate

命令就可以自動生成mock文件了。

gomock的接口使用

在生成了mock實現代碼之后,我們就可以進行正常使用了。這里假設結合testing進行使用(當然你也可考慮使用GoConvey)。我們就可以
在單元測試代碼里面首先創建一個mock控制器:

mockCtl := gomock.NewController(t)

* testing.T傳遞給gomock生成一個"Controller"對象,該對象控制了整個Mock的過程。在操作完后還需要進行回收,所以一般會在New后面defer一個Finish

defer mockCtl.Finish()

然后就是調用mock生成代碼里面為我們實現的接口對象:

mockSpider := spider.NewMockSpider(mockCtl)

這里的"spider"是mockgen命令里面傳遞的報名,后面是NewMockXxxx格式的對象創建函數"Xxx"是接口名。這里需要傳遞控制器對象進去。返回一個接口的實現對象。

有了實現對象,我們就可以調用其斷言方法了:EXPECT()

這里gomock非常牛的采用了鏈式調用法,和Swfit以及ObjectiveC里面的Masonry庫一樣,通過"."連接函數調用,可以像鏈條一樣連接下去。

mockSpider.EXPECT().GetBody().Return("go1.8.3")

這里的每個"."調用都得到一個"Call"對象,該對象有如下方法:

func (c *Call) After(preReq *Call) *Call
func (c *Call) AnyTimes() *Call
func (c *Call) Do(f interface{}) *Call
func (c *Call) MaxTimes(n int) *Call
func (c *Call) MinTimes(n int) *Call
func (c *Call) Return(rets ...interface{}) *Call
func (c *Call) SetArg(n int, value interface{}) *Call
func (c *Call) String() string
func (c *Call) Times(n int) *Call

這里EXPECT()得到實現的對象,然后調用實現對象的接口方法,接口方法返回第一個"Call"對象,
然后對其進行條件約束。

上面約束都可以在文檔中或者根據字面意思進行理解,這里列舉幾個例子:

指定返回值

如我們的例子,調用Call的Return函數,可以指定接口的返回值:

mockSpider.EXPECT().GetBody().Return("go1.8.3")

這里我們指定返回接口函數GetBody()返回"go1.8.3"。

指定執行次數

有時候我們需要指定函數執行多次,比如接受網絡請求的函數,計算其執行了多少次。

mockSpider.EXPECT().Recv().Return(nil).Times(3)

執行三次Recv函數,這里還可以有另外幾種限制:

  • AnyTimes() : 0到多次
  • MaxTimes(n int) :最多執行n次,如果沒有設置
  • MinTimes(n int) :最少執行n次,如果沒有設置

指定執行順序

有時候我們還要指定執行順序,比如要先執行Init操作,然后才能執行Recv操作。

initCall := mockSpider.EXPECT().Init()
mockSpider.EXPECT().Recv().After(initCall)

再來回望官方Sample

Sample的結構如下:

sample/
├── README.md
├── imp1
│   └── imp1.go
├── imp2
│   └── imp2.go
├── imp3
│   └── imp3.go
├── imp4
│   └── imp4.go
├── mock_user
│   └── mock_user.go
├── user.go
└── user_test.go

這里,user.go是包含要mock的接口函數的目標文件,而imp1-4是user.go里面接口依賴的文件用來模擬"-imports"和"-aux_files"選項。

user_test.go 文件如同我們的test文件,是對gomock的調用。

而mock_user是生成mock文件的目錄。里面的mock_user.go是通過mockgen生成的。

這里我們看到user.go有generate的注釋:

//go:generate mockgen -destination mock_user/mock_user.go github.com/golang/mock/sample Index,Embed,Embedded

這里指定了同一個包里面的三個接口。然后定義了三個接口,里面方法有依賴impx四個目錄中的文件:

type Embed interface {
    ...
}

type Embedded interface {
    ...
}

type Index interface {
    ...
    ForeignOne(imp1.Imp1)
    ForeignTwo(renamed2.Imp2)
    ForeignThree(Imp3)
    ForeignFour(imp_four.Imp4)
    ...
}

以及其他函數。

最后來看調用,在user_test.go中首先創建控制器并調用其Finish函數:

ctrl := gomock.NewController(t)
defer ctrl.Finish()

然后就是如上面我介紹的,這里分開在幾個不同Test函數中,流程基本上,依次創建mock對象:

mockIndex := mock_user.NewMockIndex(ctrl)

然后調用其mock的方法:

mockIndex.EXPECT().Put("a", 1)

boolc := make(chan bool)
mockIndex.EXPECT().ConcreteRet().Return(boolc)

最后運行go test就可以進行測試了。

$ go test
PASS
ok      github.com/golang/mock/sample   0.013s
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,702評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,615評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,606評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,044評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,826評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,227評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,307評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,447評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,992評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,807評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,001評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,550評論 5 361
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,243評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,667評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,930評論 1 287
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,709評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,996評論 2 374

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,665評論 25 708
  • 序言 要寫出好的測試代碼,必須精通相關的測試框架。對于Golang的程序員來說,至少需要掌握下面四個測試框架: G...
    Aedan閱讀 2,310評論 0 0
  • 1. Java基礎部分 基礎部分的順序:基本語法,類相關的語法,內部類的語法,繼承相關的語法,異常的語法,線程的語...
    子非魚_t_閱讀 31,721評論 18 399
  • 去年的今天(大概是今天把),招協換屆了,我如愿拿到了聘書。今天,看著陪伴了一年的干事變成部長,覺得心里感慨萬分。當...
    Forri閱讀 699評論 1 0
  • 0 系列目錄# WEB請求處理 WEB請求處理一:瀏覽器請求發起處理 WEB請求處理二:Nginx請求反向代理 W...
    七寸知架構閱讀 4,352評論 3 55