GoogleTest中的gMock是一个库,用于创建mock类并使用它们。
当你编写原型或测试(prototype or test)时,完全依赖真实对象通常是不可行或不明智的(not feasible or wise)。模拟对象(mock object)实现了与真实对象相同的接口,但是需要你在运行时指定它将如何使用以及它应该做什么.在测试驱动开发(TDD, Test-Driven Development)中经常使用.
当使用gMock时,首先,使用一些简单的宏来描述要mock的接口,它们将扩展到mock类的实现;接下来,你将创建一些mock对象,并使用直观的语法指定其期望和行为;然后练习(exercise)使用mock对象的code. gMock将在出现任何违反预期的行为时立即捕获(catch)它.
MOCK_METHOD宏语法如下:MOCK_METHOD宏将生成定义
MOCK_METHOD(return_type,method_name, (args...));
MOCK_METHOD(return_type,method_name, (args...), (specs...));
参数依次是:接口返回值类型、接口名、接口形参列表。可选的第四个参数specs...是以逗号分隔的限定符列表,接收限定符包括:const、override、noexcept、Calltype(calltype)、ref(qualifier). 如果参数没有适当地用圆括号括起来,那么参数中的逗号将阻止MOCK_METHOD正确地解析参数.
MOCK_METHOD必须在mock类定义的public部分中使用,无论被mock的方法在基类中是public, protected, 还是private.
在gMock中,使用EXPECT_CALL宏来设置对mock方法的期望,EXPECT_CALL宏语法如下:
EXPECT_CALL(mock_object,method_name(matchers...))
创建一种期望(expectation),设置mock object的预期行为:第一个参数是mock object;第二个参数是mock object中的方法,两者用逗号分隔,如果有参数需要同时把参数传进去
通过EXPECT_CALL来指定Mock Object的对应行为
EXPECT_CALL必须在执行(exercises)mock对象的任何代码之前.
参数matchers...是一个以逗号分隔的匹配器列表(list of matchers),对应于方法method_name的每个参数。期望仅适用于参数与所有匹配器匹配的method_name调用.如果省略(matchers...),则期望的行为就像每个参数的匹配器都是通配符匹配器(_)一样。
宏的任何一种形式都可以后跟一些可选子句,这些子句提供有关期望的更多信息。以下可链接子句(chainable clauses)可用于修改期望,并且必须按以下顺序使用:
EXPECT_CALL(mock_object, method_name(matchers...))
.With(multi_argument_matcher) // Can be used at most once
.Times(cardinality) // Can be used at most once
.InSequence(sequences...) // Can be used any number of times
.After(expectations...) // Can be used any number of times
.WillOnce(action) // Can be used any number of times
.WillRepeatedly(action) // Can be used at most once
.RetiresOnSaturation(); // Can be used at most once
(1).With:将期望限制为仅应用于其参数整体与多参数匹配器multi_argument_matcher匹配的mock函数调用.With子句最多可以在期望中使用一次,并且必须是第一个子句;
(2).Times:指定期望mock函数调用的次数.参数cardinality(基数)表示期望调用的数量,可以是以下之一,都定义在::testing命名空间中:AnyNumber()、AtLeast(n)、AtMost(n)、Between(m, n)、Exactly(n) or n;
(3).InSequence:指定mock函数调用应按特定顺序进行.参数sequences...是任意数量的序列对象.
(4).After:指定mock函数调用顺序发生在一个或多个其它调用之后.
(5).WillOnce:为单个匹配函数调用指定mock函数在被调用时的实际行为.参数action表示函数调用将执行的操作.
(6).WillRepeatedly:为所有后续匹配函数调用指定mock函数在调用时的实际行为。在执行WillOnce子句中指定的操作(如果有)后生效。
(7).RetiresOnSaturation:指示在达到期望的匹配函数调用数后,期望将不再处于活动状态.
gMock要求在调用mock函数之前设置期望值,否则行为是未定义的。不要在调用EXPECT_CALL和调用mock函数之间交替,并且在将mock传递给API后,不要对mock设置任何期望。这意味着EXPECT_CALL应该被解读为预期将来会发生调用,而不是调用已经发生。
如果你对参数的值不感兴趣,将_写为参数,这意味着"任何事情都会发生".如果你不关心任何参数,而不是为每个参数指定_,你可以省略参数列表,这适用于所有非重载方法.如果方法重载,则需要通过指定参数的数量以及可能的参数类型来帮助gMock解决预期的重载问题。
ON_CALL宏语法如下:若要自定义特定mock对象的特定方法的默认操作,使用ON_CALL.它具有与EXPECT_CALL类似的语法,但它用于在不需要调用mock方法时设置默认行为
ON_CALL(mock_object,method_name(matchers...))
gMock典型的工作流程是:
(1).从testing命名空间导入gMock名称,以便可以不限定地使用它们(每个文件只需执行一次);
(2).创建一些mock对象;
(3).指定你对它们的期望(一个方法将被调用多少次?用什么论证?它用过怎么做?等);
(4).练习(exercise)一些使用mock的code;如有必要,使用GoogleTest断言检查结果;如果一个mock方法被调用的次数超过预期,或者使用了错误的参数,你将立即收到错误;
(5).当mock被销毁时,gMock将自动检查是否满足了对它的所有期望.
注:以上内容主要来自于GoogleTest官方文档:gMock for Dummies | GoogleTest
以下为测试代码:
#include <string>
#include "gmock/gmock.h"
namespace gmock_ {
class Foo {
public:
// Must be virtual as we'll inherit from Foo.
virtual ~Foo() {}
virtual bool SetName(const std::string& name) = 0;
virtual std::string GetName() const = 0;
};
class MockFoo : public Foo {
public:
MOCK_METHOD(bool, SetName, (const std::string&), (override));
MOCK_METHOD(std::string, GetName, (), (const, override));
};
class Area {
public:
virtual ~Area() {}
virtual int area() = 0;
};
int GetValue(Area* p) { return p->area() / 2; }
class MockArea : public Area {
public:
MOCK_METHOD(int, area, (), (override));
};
} // namespace gmock_
TEST(gmock, name) {
using namespace gmock_;
using ::testing::AtLeast;
using ::testing::Return;
MockFoo foo;
EXPECT_CALL(foo, SetName("Mike"))
.Times(AtLeast(2))
.WillOnce(Return(1))
.WillOnce(Return(0));
EXPECT_TRUE(foo.SetName("Mike"));
EXPECT_FALSE(foo.SetName("Mike"));
EXPECT_CALL(foo, GetName())
.Times(AtLeast(1))
.WillRepeatedly(Return("Mike"));
EXPECT_EQ("Mike", foo.GetName());
}
TEST(gmock, area) {
using namespace gmock_;
using ::testing::Return;
MockArea m;
EXPECT_CALL(m, area()).WillRepeatedly(Return(10));
EXPECT_EQ(5, GetValue(&m));
}
执行结果如下所示:
GitHub: https://github.com/fengbingchun/Messy_Test