单元测试(C++)——gmock通用测试模版(个人总结)

引言

在现代软件开发中,单元测试是保证代码质量的重要工具之一。Google Mock(简称gMock)是谷歌提供的一个强大的C++框架,用于创建mock对象。它允许开发者模拟复杂的行为,从而简化了单元测试的编写。

本文将介绍如何构建一个通用的gMock测试模板,该模板可以轻松地应用于不同的项目和函数,特别是那些与外部依赖或接口交互的函数。

准备工作

在开始之前,请确保环境中已经安装并配置好了Google Test和Google Mock。

设计通用Mock接口

首先定义一个MockInterface类,这个类会包含所有需要模拟的方法。对于每个想要模拟的方法,我们都使用MOCK_METHOD宏来声明。

cpp 复制代码
#include <gmock/gmock.h>

class MockInterface {
public:
    MOCK_METHOD(int, exampleMethod, (int arg1, const std::string& arg2), ());
};

实现全局调用机制

为了让外部C函数能够访问mock对象,需要一个全局指针g_mock_interface,并且提供一个call_mock模板函数来转发调用。

cpp 复制代码
static MockInterface* g_mock_interface = nullptr;

template <typename Ret, typename Class, typename... Args>
Ret call_mock(Ret (Class::*method)(Args...), Args... args) {
    return g_mock_interface ? (g_mock_interface->*method)(args...) : Ret{};
}

编写外部C函数的包装器

对于每一个想要模拟的外部C函数,都需要编写一个包装器函数,它通过call_mock调用mock对象的方法。

cpp 复制代码
extern "C" {
int external_function_example(int arg1, const char* arg2) {
    return call_mock<int, MockInterface, int, const char*>(
        &MockInterface::exampleMethod, arg1, arg2);
}
}

创建测试类

接下来,创建一个继承自::testing::Test的测试类,在其中实现SetUpTearDown方法来初始化和清理测试环境。

cpp 复制代码
class GeneralTest : public ::testing::Test {
protected:
    void SetUp() override {
        g_mock_interface = nullptr;
    }

    void TearDown() override {
        if (/* condition to check resource */) {
            /* cleanup code */
        }
    }
};

编写具体的测试用例

最后,编写具体的测试用例,设置期望行为,并执行测试逻辑。

cpp 复制代码
TEST_F(GeneralTest, ExampleTest) {
    auto mock = new ::testing::NiceMock<MockInterface>();
    g_mock_interface = mock;

    EXPECT_CALL(*mock, exampleMethod(::testing::_, ::testing::_))
        .Times(3)
        .WillOnce(::testing::Return(-1))
        .WillOnce(::testing::Return(0))
        .WillOnce(::testing::Return(1));

    // 执行测试逻辑。
    // ...

    // 验证结果。
    // ...

    g_mock_interface = nullptr;
    delete mock;
}

结论

通过上述步骤,我们创建了一个通用的gMock测试模板,它可以被复用在不同的项目中。此模板不仅简化了mock对象的管理,还提高了测试代码的可读性和维护性。

附录

完整汇总gmock代码模版如下,包含了创建通用的mock接口、全局调用机制、外部C函数包装器、测试类以及具体的测试用例:

cpp 复制代码
#include <gmock/gmock.h>
#include <gtest/gtest.h>

// 定义您的接口或类的mock版本。
class MockInterface {
public:
    // 模拟方法应该根据实际接口定义。这里我们仅提供一个示例。
    MOCK_METHOD(int, exampleMethod, (int arg1, const std::string& arg2), ());
};

// 用于全局访问的mock对象指针。
static MockInterface* g_mock_interface = nullptr;

// 通用的函数调用mock对象的方法。
template <typename Ret, typename Class, typename... Args>
Ret call_mock(Ret (Class::*method)(Args...), Args... args) {
    return g_mock_interface ? (g_mock_interface->*method)(args...) : Ret{};
}

// 外部C函数调用mock方法的例子。
extern "C" {
int external_function_example(int arg1, const char* arg2) {
    return call_mock<int, MockInterface, int, const char*>(
        &MockInterface::exampleMethod, arg1, arg2);
}
}

// 测试类继承自::testing::Test。
class GeneralTest : public ::testing::Test {
protected:
    void SetUp() override {
        g_mock_interface = nullptr;
        // 初始化其他测试资源。
    }

    void TearDown() override {
        // 清理测试资源。
        if (/* condition to check resource */) {
            /* cleanup code */
        }
    }

    // 可以在这里声明测试中使用的成员变量。
};

// 实际的测试用例。
TEST_F(GeneralTest, ExampleTest) {
    // 创建NiceMock实例,并设置为全局mock接口。
    auto mock = new ::testing::NiceMock<MockInterface>();
    g_mock_interface = mock;

    // 设置mock行为。
    EXPECT_CALL(*mock, exampleMethod(::testing::_, ::testing::_))
        .Times(3)
        .WillOnce(::testing::Return(-1)) // 第一次调用返回-1
        .WillOnce(::testing::Return(0))  // 第二次调用返回0
        .WillOnce(::testing::Return(1)); // 第三次调用返回1

    // 执行测试逻辑。
    // ...

    // 验证结果。
    // ...

    // 清理。
    g_mock_interface = nullptr;
    delete mock;
}
相关推荐
西阳未落30 分钟前
LeetCode——双指针(进阶)
c++·算法·leetcode
暴力求解1 小时前
c++类和对象(下)
开发语言·c++·算法
艾莉丝努力练剑2 小时前
【Linux指令 (二)】不止于入门:探索Linux系统核心与指令的深层逻辑,理解Linux系统理论核心概念与基础指令
linux·服务器·数据结构·c++·centos
Mr_WangAndy2 小时前
C++设计模式_结构型模式_外观模式Facade
c++·设计模式·外观模式
FreeBuf_2 小时前
Happy DOM曝CVSS 9.4严重RCE漏洞,PoC已公开(CVE-2025-61927)
java·c语言·c++·python·php
BlackQid2 小时前
深入理解指针Part4——字符、数组与函数指针变量
c++·后端
子正2 小时前
Pytest单元测试一例:u16采样值格式转换的错误
单元测试·pytest
Vect__2 小时前
从底层到上层的“外挂”:deque、stack、queue、priority_queue 全面拆解
数据结构·c++
草莓熊Lotso2 小时前
C++ 手写 List 容器实战:从双向链表原理到完整功能落地,附源码与测试验证
开发语言·c++·链表·list
wxin_VXbishe2 小时前
基于SpringBoot的天天商城管理系统的设计与现-计算机毕业设计源码79506
java·c++·spring boot·python·spring·django·php