CppUnitLite使用详解

来源：互联网发布：poco下载软件编辑：程序博客网时间：2024/05/17 08:38

一直想给现在的项目做C++的单元测试，而且也想看看一个单元测试框架的实现。无意中发现了CppUnitLite，CppUnit的轻量级, 确实简单易用。

一. 下载及目录结构
下载地址:(http://download.csdn.net/source/304011), 下载后目录结构如下：
/om
   /CppUnitLite
   /Failure.cpp
   /Failure.h
   /SimpleString.cpp
   /SimpleString.h
   ...
   /CppUnitTests
   /Cpp
   /StackMain.cpp
   /StackTest.cpp
   /Stack.h
   /readme.txt

其中CppUnitLite根目录下面的几个Failure.h,SimpleString.cpp什么的就是CppUnitLite的核心代码了,而 Cpp文件夹和CppUnitTests文件夹下面则是针对CppUnitLite的测试文件,是VC6.0的项目.readme.txt以Stack为例教我们如何将CppUnitLite应用到我们的项目中(当然你也可以直接打开CppUnitTests文件夹下的CppUnitTests.dsw, 运行结果应该和下面的步骤一致):

二. 快速入门
1.首先建一个C++的静态库项目CppUnitLite,将什么Failure.cpp什么的(也就是上面所谈到核心代码)全部都添加到项目中,编译成CppUnitLite.lib,要去掉预编译选项.

2.再建一个Stack的Win32控制台项目,将StackMain.cpp和StackTest.cpp两个文件加入进来,并且静态链接CppUnitLite.lib,并且设置项目
依赖性:Stack项目依赖于CppUnitLite项目.

3.最后,Run吧.如果前面设置的都正确应该会在Console控制台下显示There were no test failures.

三.自己的项目使用CppUnitLite.

我们如果自己的项目如何使用CppUnitLite这个测试框架,具体说就是要加哪些文件和添哪些代码呢?还是从最简单的入手,看看StackMain.cpp和StackTest.cpp.

StackMain.cpp：

#include "CppUnitLite/TestHarness.h"
int main()
{
TestResult tr;
TestRegistry::runAllTests(tr);
return 0;
}

StackTest.cpp:

#include "CppUnitLite/TestHarness.h"
#include "Stack.h"
#include <string>
SimpleString StringFrom(const std::string& value)
{
return SimpleString(value.c_str());
}
TEST( Stack, creation )
{
Stack s;
LONGS_EQUAL(0, s.size());
std::string b = "asa";
CHECK_EQUAL("asa", b);
}

StackMain.cpp就是我们的Main函数,它保证运行所有的TestCase,这个几乎都不用改.
StackTest.cpp就是我们自己要写的代码了,做了些什么事情呢?
添加测试框架头文件"TestHarness.h".
添加你要测的类的头文件"Stack.h"
加入宏TEST,这个宏之后的代码就是你要测的东西.比如,我们要测试1+1=2,就可以这样写:

TEST(foo, creation)
{
int a = 1;
int b = 1;
int result = a + b;
CHECK(result == 2);
CHECK(result == 3);
}

没错的话会有如下提示:Failure: "1 == 2" line 16 in C:/Documents and Settings/jczeng/Desktop/CppUnitLit
e/om/StackTest.cpp
There were 1 failures
Press any key to continue
它会将有几个Case没过和具体哪一行错了都提示出来.

四. MFC下使用CppUnitLite.
上面都只是列举的最简单情况,如果是测试MFC等项目,要注意这么几点:
1.控制台项目要选择支持MFC.
2.由于MFC是支持多线程调试的,要把CppUnitLite中的输出fprintf(stdout,xxx)改成printf.
3.此外,可能还会有些链接错误,具体问题可以查MSDN和下来交流．

CppUnitLite的实现分析

1. 类TestRegistry是一个Singleton模式。

l 外界通过instance()方法获得它的一个实例。

l 它实际是所有测试用例的注册表。

l 它包含了一个指向测试用例链表的指针，即Test指针。并且维护该链表。

l 实例方法add负责向链表中加入一个新的测试用例，并将已有的测试链表作为新的测试用例的下一个节点。所以测试用例链表是一个LIFO队列。

l 它负责调用所有测试用例的执行方法

2. 类Test是所有测试用例的基类。

l 构造函数负责将本身加入到TestRegistry注册表中，并作为首节点。

l 它提供了一个纯虚函数run，具体的测试用例override此虚方法。

l 它包含一个执行下一个测试用例的指针，所以Test本身是一个测试用例链表。

3. 宏TEST包含实际的一条测试用例的代码。

l 负责定义一个Test的子类。

l override基类的纯虚函数run，使得子类可以别实例化。

l 负责生成该子类的一个实例。（基类的构造函数保证将该实例添加到TestRegistry注册表中）。

4. 类TestResult负责收集所有测试用例的执行结果

l 虚函数testStarted表示开始执行测试测试用例。

l 虚函数testEnded表示测试用例执行完毕。

l 虚函数addFailure表示执行某一条测试时，出现错误。

5. 辅助宏CHECK，CHECK_EQUAL在预期和结果不符时，调用TestResult的虚函数addFailure。

6. 类Failure、SimpleString属于辅助类，分别代表执行测试时的错误信息（如文件名、行号，预期结果、实际结果等），简单字符串。