什么是gmock?

一个mock对象实现了与真实对象相同的接口,但是它让您在运行时指定如何使用它以及应该做什么(包括它应该调用什么方法,以什么顺序调用方法,调用多少次,用什么参数,返回什么值等)。

当你使用gmock的时候:首先你要用一些简单的宏描述你希望mock的接口,这些宏将拓展为mock类的实现;其次要创建一些mock对象,并且使用直观的语法指定其期望或者行为;最后编写使用mock对象的代码,gMock将会在出现违反预期的时候立即捕获。

学习第一个gmock测试

写mock类

假设原来有一个类为

class Turtle { //... virtual ~Turtle() {} virtual void PenUp() = 0; virtual void PenDown() = 0; virtual void Forward(int distance) = 0; virtual void Turn(int degrees) = 0; virtual void GoTo(int x, int y) = 0; virtual int GetX() const = 0; virtual int GetY() const = 0;};

那么如何用gmock写一个测试呢? 第一步是写一个Mock类,下面是要做的步骤:

  • 首先是从Turtle类里面派生一个MockTurtle类。
  • Take a virtual function of Turtle (while it’s possible to mock non-virtual methods using templates, it’s much more involved).【这一步我大概认为是最好只能mock Turtle的 virtual函数】
  • 第三部是在这个子类里面写MOCK_METHOD();
  • 然后就是在MOCK_METHOD的括号里面写参数,这个参数实际上就是将父类的成员函数进行分解为【返回值类型】、【函数名】、【参数列表】、【const/override】。

如下是上面这个类的Mock类:

#include "gmock/gmock.h"class TurtleMock : public Turtle {public://... MOCK_METHOD(void, PenUp, (), (override)); MOCK_METHOD(void, PenDown,(), (override)); MOCK_METHOD(void, Forward, (int distance), (override)); MOCK_METHOD(void, Turn, (int degrees), (override)); MOCK_METHOD(void, GoTo, (int x, int y), (override)); MOCK_METHOD(int, GetX, (), (const, override)); MOCK_METHOD(int, GetY, (), (const, override));}

mock类放在哪里

当我们写完了这个类,我们应该将其放在哪里呢?

一些人喜欢将其放置在xxx_test.cpp文件中。如果被mock的接口一直是一个人或者一个团队在维护这是ok的,但是如果这个接口的维护之改变了,这个测试就有可能失败了。

所以,一般规定统一个原则:如果你需要mock一个类(假定为Foo)并且它属于其他人拥有,那么将mock class定义在Foo的package(更好的来说,定义在一个测试的子package里面,这样更清楚),将其放置在.h文件和一个cc_library。然后每一个人都可以在他们的测试中参考他们。如果这个类改变了,那么仅仅有一个MockFoo的copy会改变,而且仅有哪些依赖于改变内容的测试需要改变。

另一种实现该目的的方法是,你可以在Foo的顶层引入一个thin layer名为FooAdaptor,并将Foo置于FooAdaptor之下。由于你拥有FooAdaptor,你可以更轻松的处理好Foo中的修改。虽然这种方法在最初的时候需要做耕作的工作,但是这一做可以使你的代码更易于编写和更具有可读性。

使用mock类进行测试

使用的方法很简单,如下:

  1. 从testing的命名空间引入gMock的名字;
  2. 创建一些Mock对象;
  3. 指定你的期望(调用多少次,有什么参数,应该做什么等)
  4. 编写使用这些mocks的代码,可以使用gtest断言检查结果,如果mock方法的调用出现错误或者不符合预期,你会立即收到报错;
  5. 当mock被销毁的时候,gmock会自动检查我们所有的期望是否得到满足。

实现代码如下:

#include "path/to/mock-turtle.h"#include "gmock/gmock.h"#include "gtest/gtest.h"using ::testing::AtLeast; //Step 1TEST(PainterTest, CanDrawSometing) { MockTurtle turtle; //Step 2 EXPECT_CALL(turtle, PenDown()).Times(AtLeast(1)); //Step 3 Painter painter(&turtle); //Step 4 EXPECT_TRUE(painter.DrawCircle(0, 0, 10)); //Step 5}

提示:
1. 如果你从Emacs缓冲区运行测试,则可以在行号上按Enter键跳转到失败的期望值;
2.如果你的mock对象从未删除,则最后的验证不会发生。因此,在堆上分配mocks的时候,应该在测试中打开堆检查器。如果你已经使用gtest_main库,则会自动获取该信息。
3.一定要在mock函数被调用之前设置期望值,否则行为将不确定,并且一定不能将EXPECT_CALL()和调用交错使用。

EXPECT_CALL()该如何写

能够使用mock来进行测试的一个关键点是设置正确的期望值。如果你设置的期望值太过于严苛,你的测试将会在存在不相关改变时失败;如果你设置的期望值太过于轻松,可能会导致一些bug不能被发现。您想正确地做它,以便您的测试可以准确地捕获您打算捕获的错误类型。 gMock为您“做到正确”提供了必要的手段。 通常的语法如下:

EXPECT_CALL(mock_object, method(matcher1, matcher2, ...)) .With(multi_argument_matcher)//多个参数的匹配方式指定 .Times(cardinality)//重复多少次 .InSequence(sequences)//定义这个方法被执行顺序(优先级) .After(expectations)//指定某个方法只能在另一个方法之后执行 .WillOnce(action)//定义一次调用时所产生的行为,比如定义该方法返回怎么样的值等等 .WillRepeatedly(action)//缺省/重复行为 .RetiresOnSaturation();//用于保证期待调用不会被相同的函数的期待所覆盖

宏定义里面包括两个参数,分别是mock object和要调用的方法(包括参数)。如果方法没有重载(overloaded),那么可以在没有匹配器的情况下调用该宏:

EXPECT_CALL(mock_object, non-overloaded-method) .Times(cardinality) .WillOnce(action) .WillRepeatedly(action);

这种语法允许测试编写者指定“使用任何参数调用”,而无需明确指定参数的数量或类型。为避免意外的歧义,此语法只能用于未重载的方法。 我们注意到,在宏定义后面还跟着三个子句,下面我们来讨论下这些子句的语法。我们举个例子,如下:

using ::testing::Return;...EXPECT_CALL(turtle, GetX()) .Times(5) .WillOnce(Return(100)) .WillOnce(Return(150)) .WillRepeatedly(Return(200));

我们可以明白这句话的意思,我们希望调用turtle中的GetX()函数,并且完成以下动作:①调用5次;②第一次返回值为100;③第二次返回值为150;④此后每一次返回值都为200。

Matchers:我们期望怎样的参数

当一个mock函数需要参数的时候,我们需要指定我们期望的参数,例如

// Expects the turtle to move forward by 100 units.EXPECT_CALL(turtle, Forward(100));

一般来说,我们可能不希望参数过于具体,即我们可能只对多个输入参数中只关心一个或几个,而对其它的要求遍历或者不关心。这个时候如果我们对其它参数也指定了具体的参数,可能会导致一些存在的bug我们无法测试到。因此,如果我们对这部分的参数不感兴趣或者需要遍历,可以使用_来替代具体参数值。例如:

// Expects that the turtle jumps to somewhere on the x=50 line.EXPECT_CALL(turtle, GoTo(50, _));

但事实上,上面的100和50也都是matchers,它们实际上可以视同为Eq(100)和Eq(50)。 下面是一个内置的matchers,例如

using ::testing::Ge;...// Expects the turtle moves forward by at least 100.EXPECT_CALL(turtle, Forward(Ge(100)));

如果您不关心任何参数,而不是为每个参数指定_,则可以省略参数列表:

// Expects the turtle to move forward.EXPECT_CALL(turtle, Forward);// Expects the turtle to jump somewhere.EXPECT_CALL(turtle, GoTo);

这适用于所有非重载方法; 如果方法被重载,则需要通过指定参数数量以及可能的参数类型来帮助gMock解决预期的重载。

Cardinalities:将被调用多少次?

.Times(cardinality)

cardinality除了是具体的数字,也可以是模糊的,这非常有助于我们进行测试。如何模糊的使用呢,有以下几种方式:

AnyNumber()The function can be called any number of times.
AtLeast(n)The call is expected at least n times.
AtMost(n)The call is expected at most n times.
Between(m, n)The call is expected between m and n (inclusive) times.
Exactly(n) or nThe call is expected exactly n times. In particular, the call should never happen when n is 0.

一个特殊情况是当使用.Times(0)的时候,就意味着根本不应该使用给定的参数调用该函数,,并且无论何时(错误地)调用该函数,gMock都将报告googletest失败。 .Times()可以被忽略,如果忽略之,gMock将为您推断基数。 规则很容易记住:

  • 如果不存在WillOnce()或者WillRepeatedly(),则是Times(1);
  • 如果有n个WillOnce()且没有WillRepeatedly(),且n>=1,则是Times(n);
  • 如果有n个WillOnce()且有一个WillRepeadtedly(),并且n>=0,则是Times(AtLeast(n))。

Actions:实际做了什么

还记得模拟对象实际上没有有效的实现吗? 作为用户,我们必须告诉它在调用方法时该怎么做。

首先,如果mock函数的返回类型是内置类型或指针,则该函数具有默认操作(void函数将仅返回,布尔函数将返回false,其他函数将返回0)。 此外,在C++11及更高版本中,其返回类型可默认构造的mock函数(即具有默认构造函数)具有返回默认构造值的默认操作。 如果您什么也不说,将使用此行为。

其次,如果mock函数没有默认操作或者默认操作不适合,则可以使用一系列的WillOnce()子句及可选的WillRepeatedly()指定每次期望匹配时要执行的操作,例如

using ::testing::Return;...EXPECT_CALL(turtle, GetX()) .WillOnce(Return(100)) .WillOnce(Return(200)) .WillOnce(Return(300));

这样的话,GetX()将要执行3次,分别返回100、200、300。

注意:
即使该动作可以执行多次,EXPECT_CALL()语句也仅对动作子句进行一次评估。 因此,您必须注意副作用。 以下内容可能无法满足您的要求:
using ::testing::Return;

int n = 100;
EXPECT_CALL(turtle, GetX())
.Times(4)
.WillRepeatedly(Return(n++));
我们可能期望它返回100、101、102、103,但实际上每一次返回都是100。我们可以这样理解,虽然重复进行4次,但是每一次都是独立的,故每一次返回都是100。

Using Multiple Expectations

到目前为止,我们一直使用的是只有一个期望的示例。但是在现实中,我们可能对多个mock对象的多个mock方法指定期望。

默认情况下,当调用mock方法时,gmock将按照与定义相反的顺序搜索期望值,并在找到与参数匹配的有效期望值的时候停止。如果匹配的期望值不能再进行更多的调用,就会收到一个失败的警告。例如:

using ::testing::_;...EXPECT_CALL(turtle, Forward(_)); // #1EXPECT_CALL(turtle, Forward(10)) // #2 .Times(2);

如果连续三次调用Forward(10),则第三次会报错,因为最后一个匹配的期望值(#2)已饱和。 但是,如果将第三个Forward(10)调用替换为Forward(20),则可以,因为现在#1将是匹配的期望值。

Ordered vs Unordered Calls

默认情况下,即使未满足先前的期望,期望也可以匹配调用。 换句话说,调用不必按期望的指定顺序进行。 有时,您可能希望所有预期的调用都按照严格的顺序进行。 在gMock中说这很容易,如下:

using ::testing::InSequence;...TEST(FooTest, DrawsLineSegment) { ... { InSequence seq; EXPECT_CALL(turtle, PenDown()); EXPECT_CALL(turtle, Forward(100)); EXPECT_CALL(turtle, PenUp()); } Foo();}

通过创建InSequence类型的对象,将其范围内的所有期望放入一个序列中,并且必须顺序发生。 由于我们只是依靠该对象的构造函数和析构函数来完成实际工作,因此它的名称确实无关紧要。

在此示例中,我们测试Foo()按编写顺序调用了三个预期函数。 如果调用混乱,将会报错。

参考文献

https://github.com/google/googletest/blob/master/docs/gmock_cheat_sheet.md#CardinalityList

https://github.com/google/googletest/blob/master/docs/gmock_for_dummies.md

https://github.com/google/googletest/blob/master/docs/gmock_cook_book.md