且构网

分享程序员开发的那些事...
且构网 - 分享程序员编程开发的那些事

mockcpp使用方法简明指导

更新时间:2022-09-27 18:04:57

mockcpp使用方法简明指导mock工具介绍
mock工具的作用是指定函数的行为(模拟函数的行为)。可以对入参进行校验,对出参进行设定,还可以指定函数的返回值。

几个相关概念:
(1)mock规范:每个MOCKER(function)开始,跟一系列的.stubs、.with、.will等的内容的整体,称为一个mock规范。
(2)核心关键字:指stubs/defaults/expects/before/with/after/will/then/id等这些直接跟在点后面的关键字。
(3)扩展关键字:指once()/eq()/check()/returnValue()/repeat()等这些作为核心关键字参数的关键字。
 
下面,请看两段mockcpp的使用规范示例代码,其中带“/”或者“|”的表示在该位置可能有多种选择;带中括号的表示是可选的。
mockcpp的sample代码
一段简单的mockcpp使用sample代码:(带有完整核心关键字)
TEST(mockcpp simple sample)
{
MOCKER(function) / MOCK_METHOD(mocker, method)
.stubs() / defaults() / expects(once())
[.before("some-mocker-id")]
[.with(eq(3))]
[.after("some-mocker-id")]
.will(returnValue(1)) / .will(repeat(1, 20))
[.then(returnValue(2))]
[.id("some-mocker-id")]
}
 
 

下面是一段比较详细的mockcpp使用sample代码:(带有完整扩展关键字)
TEST(mockcpp detail sample)
{
MOCKER(function) / MOCK_METHOD(mocker, method)
.stubs() / defaults() / expects(never() | once() | exactly(3) | atLeast(3) | atMost(3) )
[.before("some-mocker-id")]
[.with( any() | eq(3) | neq(3) | gt(3) | lt(3) | spy(var_out) | check(check_func)
| outBound(var_out) | outBoundP(var_out_addr, var_size) | mirror(var_in_addr, var_size)
| smirror(string) | contains(string) | startWith(string) | endWith(string) )]
[.after("some-mocker-id")]
.will( returnValue(1) | repeat(1, 20) | returnObjectList(r1, r2)
| invoke(func_stub) | ignoreReturnValue()
| increase(from, to) | increase(from) | throws(exception) | die(3))
[.then(returnValue(2))]
[.id("some-mocker-id")]
}
 
 

注:
1、扩展关键字分类:
expects里面的叫匹配关键字(Matcher);
with里面的叫约束关键字(Constraint);
will/then里面的叫桩关键字(Stub)。
2、spy的作用是监视执行该被mock的函数function被调用时传入的值,会保存在var_out中,供用例中其它地方使用。
3、outBound的作用是设置函数function的出参的值。多半是把该值作为后面部分被测代码的输入。(注意与spy区别)
4、outBoundP,与outBound作用相同,只是用于数组的情况。
5、mirror的作用是对数组类型的入参进行检查。(outBoundP是设置出参的值,两者是不同的)
6、check的作用是进行定制化的入参检查,比如只检查结构体的部分成员。可以通过函数指针或者仿函数的方式指定,用仿函数还能预先保存一些值,非常方便。(有些mock工具叫它follow)
7、check也能够用于设置出参的情况。
8、die表示程序退出,并且返回指定的值。它是异常退出,用于模拟一个函数调用崩溃的情况。
9、increase(from, to),表示依次返回from到to的对象,任何重载了++运算符的对象都可以用。
10、outBound和outBoundP都可以带一个约束参数,用于对参数进行检查,因为有同时作为in和out的参数。(如:outBound(var_out, eq(3))  )

下面是结合上面sample的mockcpp使用说明

1、mock C函数或者类的静态成员方法用MOCKER; 
     mock 类的非静态成员方法需要先用MockObject<MyClass> mocker;声明一个mock对象,再用MOCK_METHOD(mocker, method)来mock指定方法。

2、紧跟着MOCKER/MOCK_METHOD之后的是stubs、或者defaults、或者expects,三个必须有一个。(这是与AMOCK不同的地方,在这个层次上确定这三个关键字必须有一个,可以让mock语法更清晰)
   stubs 表示指定函数的行为,不校验次数。
   expects 与stubs的区别就是校验次数。(.expects(once()) / .expects(never()) / .expects(exactly(123)))
   defaults 表示定义一个默认的mock规范,但它优先级很低;如果后面有stubs或者expects重新指定函数行为,就会按照新指定的来运行。(一般用在setup中)

3、用will指定函数的返回值;
   如果要指定20次调用都返回1,则用.will(repeat(1, 20));
   要指定第一次返回1,第二次返回2,第三次返回3,就用
      .will(returnValue(1))
      .then(returnValue(2))
      .then(returnValue(3))
   如果你指定了前三次的返回值依次为1、2、3,那么第四次、第五次调用,都是返回最后的返回值3。

4、用id给一个mock规范指定一个名字,然后可以用after、before来指定多个mock应该的调用顺序。
   注意before在with前,after在with后,id在整个mock规范的最后。
 
5、使用mockcpp时,校验是否按照mock规范进行调用的,应该用:
GlobalMockObject::verify();
verify之后,会自动执行reset。(如果是对象的mock,应该用mocker.verify(),同样也会自动reset。)

如果单单只想reset,也可以:(这很少见,难道前面你定义的mock规范都不想要了,也不校验?那为何要定义呢?)
GlobalMockObject::reset();
 
 一般是在teardown中调用verify。






本文转sinojelly51CTO博客,原文链接:http://blog.51cto.com/sinojelly/431897,如需转载请自行联系原作者