使用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阅读 158,233评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,013评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,030评论 0 241
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,827评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,221评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,542评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,814评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,513评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,225评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,497评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,998评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,342评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,986评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,812评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,560评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,461评论 2 266

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,563评论 25 707
  • 序言 要写出好的测试代码,必须精通相关的测试框架。对于Golang的程序员来说,至少需要掌握下面四个测试框架: G...
    Aedan阅读 2,244评论 0 0
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,293评论 18 399
  • 去年的今天(大概是今天把),招协换届了,我如愿拿到了聘书。今天,看着陪伴了一年的干事变成部长,觉得心里感慨万分。当...
    Forri阅读 659评论 1 0
  • 0 系列目录# WEB请求处理 WEB请求处理一:浏览器请求发起处理 WEB请求处理二:Nginx请求反向代理 W...
    七寸知架构阅读 4,191评论 3 55