使用 gomonkey Mock 函数及方法示例详解

 更新时间:2022年06月02日 14:20:47   作者:CG国斌  
在 Golang 语言中,写单元测试的时候,不可避免的会涉及到对其他函数及方法的 Mock,即在假设其他函数及方法响应预期结果的同时,校验被测函数的响应是否符合预期,这篇文章主要介绍了使用 gomonkey Mock 函数及方法,需要的朋友可以参考下

前言

在 Golang 语言中,写单元测试的时候,不可避免的会涉及到对其他函数及方法的 Mock,即在假设其他函数及方法响应预期结果的同时,校验被测函数的响应是否符合预期。

其中,在 Mock 其他函数及方法的时候,我们常用到的一个测试类库是「gomonkey」。特别地,对于方法和函数的 Mock,略有差异,在这里我们就分别给出函数和方法 Mock 示例,方便大家参考。

函数

在 Golang 语言中,函数是没有接受者的方法,其形式为

func function_name([parameter list]) [return_types] {
   函数体
}

对于函数的 Mock 相对来说比较简单,假设我们对 A 函数进行单元测试,且 A 函数里面又调用了 B 函数,例如

func A(ctx context.Context, str string) error {
   if len(str) == 0 {
	  return errors.New("str is empty")
   }
   return test_package_name.B(ctx, str)
}

为了将 A 函数的每一行代码都覆盖到,则其单元测试可以写为:

func TestA(t *testing.T) {
	type args struct {
		ctx    context.Context
		str    string
	}
	tests := []struct {
		name    string
		args    args
		Setup   func(t *testing.T)
		wantErr error
	}{
		{
			name: "len(str) == 0",
			wantErr: errors.New("str is empty")
		},
		{
			name: "正常响应",
			Setup: func(t *testing.T) {
				patches := gomonkey.ApplyFunc(test_package_name.B, func(_ context.Context, _ string) error {
					return nil
				})
				t.Cleanup(func() {
					patches.Reset()
				})
			},
			args: args{
				ctx:     context.Background(),
				str:     "test",
			},
			wantErr: nil,
		},
	}

	// 执行测试用例
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			if tt.Setup != nil {
				tt.Setup(t)
			}
			err := A(tt.args.ctx, tt.args.str)
			if err != nil {
				assert.EqualError(t, err, tt.wantErr.Error(), "error 不符合预期")
			}
		})
	}
}

其中,ApplyFunc函数是用来 Mock 函数的,其第一个参数为需要 Mock 的函数名称(不需要写参数列表),第二个参数为需要 Mock 的函数结果;特别地,在Setup里面,我们要记得显式调用Cleanuppatches进行Reset操作,防止该 Mock 影响其他测试用例。

方法

在 Golang 语言中,方法是含有接受者的函数,其形式为

func (variable_name variable_data_type) function_name([parameter list]) [return_type]{
   函数体
}

对于方法的 Mock 相对来说复杂一下,假设我们对 A 函数进行单元测试,且 A 函数里面又调用了结构 C 的 B 方法,例如

func A(ctx context.Context, str string) error {
   if len(str) == 0 {
	  return errors.New("str is empty")
   }
   c := &test_package_name.C{}
   return c.B(ctx, str)
}

为了将 A 函数的每一行代码都覆盖到,则其单元测试可以写为:

func TestA(t *testing.T) {
	// 初始化C结构
	var c *test_package_name.C
	
	type args struct {
		ctx    context.Context
		str    string
	}
	tests := []struct {
		name    string
		args    args
		Setup   func(t *testing.T)
		wantErr error
	}{
		{
			name: "len(str) == 0",
			wantErr: errors.New("str is empty")
		},
		{
			name: "正常响应",
			Setup: func(t *testing.T) {
				patches := gomonkey.ApplyMethod(reflect.TypeOf(c), "B", func(_ *test_package_name.C, _ context.Context, _ string) error {
					return nil
				})
				t.Cleanup(func() {
					patches.Reset()
				})
			},
			args: args{
				ctx:     context.Background(),
				str:     "test",
			},
			wantErr: nil,
		},
	}

	// 执行测试用例
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			if tt.Setup != nil {
				tt.Setup(t)
			}
			err := A(tt.args.ctx, tt.args.str)
			if err != nil {
				assert.EqualError(t, err, tt.wantErr.Error(), "error 不符合预期")
			}
		})
	}
}

其中,ApplyMethod函数是用来 Mock 方法的,其第一个参数为需要 Mock 的方法的接受者类型,第二个参数为需要 Mock 的方法名称(字符串类型),第三个参数为需要 Mock 的方法的定义及 Mock 结果;特别地,第一个参数和第三个参数需要我们注意:

  • 第一个参数,需要使用reflect.TypeOf获取接受者的类型,初始化的接受者必须是真正的类型,如结构 C 组合了结构 D,而B方法是通过组合 D 得到的,则初始化的时候需要定义结构 D,而不是结构 C,否则会报空指针异常;
  • 第三个参数,虽然B方法的声明是func(ctx context.Context, str string),但是在使用ApplyMethod的时候,需要将B方法的声明修改为func(c *test_package_name.C, ctx context.Context, str string),即需要将方法的接受者置为方法的第一个参数。

参考

还有就是,大家在使用gomonkey的时候,有可能遇到权限校验的问题以及非 Debug 模式运行失败的问题,可以参考:

golang使用gomonkey和monkey来mock方法或者函数时报panic: permission denied

使用 gomonkey 遇到非 debug 模式执行失败的问题及解决方法

到这里,本文就要结束了,希望对大家有所帮助。

到此这篇关于使用 gomonkey Mock 函数及方法的文章就介绍到这了,更多相关gomonkey Mock 函数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Go语言开源库实现Onvif协议客户端设备搜索

    Go语言开源库实现Onvif协议客户端设备搜索

    这篇文章主要为大家介绍了Go语言Onvif协议客户端设备搜索示例实现,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-04-04
  • Go语言中循环Loop的用法介绍

    Go语言中循环Loop的用法介绍

    这篇文章介绍了Go语言中循环Loop的用法,文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-07-07
  • 详解Go语言中init的使用与常见应用场景

    详解Go语言中init的使用与常见应用场景

    Go 中有一个特别的 init() 函数,它主要用于包的初始化,这篇文章将以此为主题介绍 Go 中 init() 函数的使用和常见使用场景,希望对大家有所帮助
    2024-02-02
  • Go语言同步与异步执行多个任务封装详解(Runner和RunnerAsync)

    Go语言同步与异步执行多个任务封装详解(Runner和RunnerAsync)

    这篇文章主要给大家介绍了关于Go语言同步与异步执行多个任务封装(Runner和RunnerAsync)的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-01-01
  • 一文带你掌握Go语言中文件的写入操作

    一文带你掌握Go语言中文件的写入操作

    这篇文章主要和大家分享一下Go语言中文件的写入操作,文中的示例代码讲解详细,对我们学习Go语言有一定的帮助,需要的小伙伴可以参考一下
    2022-12-12
  • Golang sync包中errgroup的使用详解

    Golang sync包中errgroup的使用详解

    Go 语言为我们提供了丰富的并发原语,且大多数都位于 sync 包下,今天我们来探讨一下该库下的原语之一:errgroup,感兴趣的小伙伴可以了解一下
    2023-05-05
  • golang 字符串拼接方法对比分析

    golang 字符串拼接方法对比分析

    这篇文章主要为大家介绍了golang 字符串拼接方法对比分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • Go处理包含多种引号的字符串的几种方法

    Go处理包含多种引号的字符串的几种方法

    在Go中,有几种方式可以处理包含多种引号的字符串,以确保代码的可读性和正确性,本文将给大家详细介绍了这几种处理方式,并通过代码示例讲解的非常详细,需要的朋友可以参考下
    2024-04-04
  • go语言中使用ent做关联查询的示例详解

    go语言中使用ent做关联查询的示例详解

    go语言的ent框架是facebook开源的ORM框架,是go语言开发中的常用框架,而关联查询又是日常开发中的常见数据库操作,故文本给出一个使用ent做关联查询的使用示例,需要的朋友可以参考下
    2024-02-02
  • 详细介绍Go语言之数组与切片

    详细介绍Go语言之数组与切片

    这篇文章介绍Go语言之数组与切片,数组是具有相同唯一类型的一组已编号且长度固定的数据项序列,这种类型可是任意的原始类型如整形、字符串或自定义类型。切片是数组的一个引用,因此切片是引用类型,在进行传递时,遵守引用传递的机制,下面我们就来详细了解一下该内容
    2021-10-10

最新评论