CppUnit使用简介
1 引言
1.1摘要
简单描述CppUnit在Linux系统下的使用方法，以便在单元测试过程中能够提高正确率和效率。
1.2 术语、定义和缩略语
| 序号 |
术语或缩略语 |
说明性定义 |
| 1 |
CppUnit |
一个用于单元测试的开源软件 |
| 2 |
|
|
|
|
|
|
1.3 安装CppUnit
首先，需要到这个（http://sourceforge.net/project/showfiles.php?group_id=11795）地址下载一个CppUnit安装程序。该地址不仅有CppUnit安装程序，还有CppUnit的说明文档。本文以CppUnit<chsdate isrocdate="False" islunardate="False" day="30" month="12" year="1899" w:st="on">1.12.0</chsdate>版进行说明。
有了压缩包了，就可以进行解压缩安装了，在压缩包所在目录下执行如下命令：
tar –xzf cppunit-<chsdate isrocdate="False" islunardate="False" day="30" month="12" year="1899" w:st="on">1.12.0</chsdate>.tar.gz
cd cppunit-<chsdate isrocdate="False" islunardate="False" day="30" month="12" year="1899" w:st="on">1.12.0</chsdate>
./configure
make
make check
make install
几乎每条命令都要执行几分钟。到此就已经完成安装了。
如果写好程序后进行编译，编译器报告没有库文件，则需要把/usr/local/lib下和cppunit有关的几个库文件拷贝到/usr/lib目录下。
2 建立CppUnit测试用例
2.1 建立一个被测函数
class Complex
{
friend int ōperator==(const Complex &a, const Complex &b);
friend Complex operator+(const Complex &a, const Complex &b);
double real, imaginary;
public:
Complex(double r, double i = 0):real(r), imaginary(i){}
};
int ōperator==(const Complex &a, const Complex &b)
{
return (int)(a.real==b.real && a.imaginary==b.imaginary);
}
Complex operator+(const Complex &a, const Complex &b)
{
Complex c(0, 0);
c.real = a.real+b.real;
c.imaginary = a.imaginary+b.imaginary;
return c;
}
假设Complex就是即将要测试的类，测试两个运算符重载。
2.2 建立一个简单的测试用例
建立CppUnit测试类，需要继承TestCase类。我们需要作的主要就是重写setUp()和tearDown()函数，并根据被测函数写测试函数。其中，setUp()函数主要用于初始化变量；tearDown()做善后处理，一般用于释放堆空间。OK，让我们写一个简单的测试类。
class ComplexNumberTest:public CppUnit::TestCase
{
private:
Complex *m_10_1, *m_1_1, *m_11_2;
public:
void setUp();
void tearDown();
void testEquality();
void testAddition();
};
void ComplexNumberTest::setUp()
{
m_10_1 = new Complex(10, 1);
m_1_1 = new Complex(1, 1);
m_11_2 = new Complex(11, 2);
}
void ComplexNumberTest::tearDown()
{
delete m_10_1;
m_10_1 = NULL;
delete m_1_1;
m_1_1 = NULL;
delete m_11_2;
m_11_2 = NULL;
}
///测试函数operator==()
void ComplexNumberTest::testEquality()
{
CPPUNIT_ASSERT(*m_10_1 == *m_10_1);
CPPUNIT_ASSERT(!(*m_10_1 == *m_11_2));
}
///测试函数operator+()
void ComplexNumberTest::testAddition()
{
CPPUNIT_ASSERT(*m_10_1+*m_1_1 == *m_11_2);
}
函数都写好了，其中CPPUNIT_ASSERT()是一个类似于断言的宏定义，根据括号内的逻辑语句是true或false得出不同的结果，至于所得结果的用法，下面介绍。
需要注意的是，不要自作聪明的给这个类加入构造函数、复制构造函数、赋值函数。任何不必要的函数都会让程序编译不过去。
2.3 使用TestSuite
你不希望用上小节的类，一条一条的在main函数中调用执行吧？这样的工作量将大的惊人。我们有更好的办法，把它们都加入到一个TestSuite中，直接执行这个suite的run()成员函数就可以了，下面是加入方法：
CppUnit::TestResult result;
suite.addTest(new CppUnit::TestCaller<ComplexNumberTest>(
“testEquality”,
&ComplexNumberTest::testEquality));
suite.addTest(new CppUnit::TestCaller<ComplexNumberTest>(
“testAddition”,
&ComplexNumberTest::testAddtion));
suite.run(&result);
首先定义一个suite，然后定义一个result，result用于接收测试的执行结果。
用addTest()函数来添加测试用例，尖括号中是测试类。内层圆括号的第一个参数是一个字符串，当测试出现异常时，将输出这个字符串，以表示该部分的测试不成功；第二个参数是测试类中函数的地址。其他部分照搬。
执行run(&result)函数。这样还不可以，虽然测试函数被执行了，但无法得到任何结果。如果是这样执行，我们得到的仅仅是CppUnit这个软件工作正常，要想得到软件的测试结果，还要用到下一小节介绍的一个类。
2.4 使用TestRunner
我们接下来要做的就是，把上小节的代码段装到一个成员函数中。需要在测试类中以静态方式定义该函数。我们在ComplexNumberTest类中加入如下函数：
static CppUnit::Test* suite()
{
CppUnit::TestSuite *suiteOfTests = new CppUnit::TestSuite("ComplexNumberTest");
suiteOfTests->addTest(new CppUnit::TestCaller<ComplexNumberTest>
("testEquality", &ComplexNumberTest::testEquality));
suiteOfTests->addTest(new CppUnit::TestCaller<ComplexNumberTest>
("testAddition", &ComplexNumberTest::testAddition));
return suiteOfTests;
}
可以看出，这里没有用到result，也没有执行run()函数，而是直接返回的suite对象。用TestRunner对象来接受静态函数的返回值就可以了。主函数如下：
int main()
{
CppUnit::TextUi::TestRunner runner;
runner.addTest(ComplexNumberTest::suite());
runner.run();
return 0;
}
主函数中首先定义了一个runner对象，用该对象的addTest()函数把suite()函数加入到runner对象中，执行run()函数。该runner.run()函数不仅有suite.run()函数的功能，还能给出输出结果，报告测试成功还是测试出错以及出错的位置。
2.5 使用宏
有一种更简单的方法可以替代2.3小节的代码，那就是使用宏。我们可以把ComplexNumberTest中的静态函数suite()删除，用以下四条宏语句来代替这个函数：
CPPUNIT_TEST_SUITE(ComplexNumberTest);
CPPUNIT_TEST(testEquality);
CPPUNIT_TEST(testAddition);
CPPUNIT_TEST_SUITE_END();
其中，第一条宏的参数是测试类的名字，中间两条宏的参数是测试函数，有多少个测试函数，就要有多少个CPPUNIT_TEST()宏。最后一条宏是与第一条配对的。
除此之外，还有许多可用的宏，比如需要测试一个函数是否能够抛出异常，可以用宏CPPUNIT_TEST_EXCEPTION(testMethod, ExceptionType)，其中testMethod是测试函数，ExceptionType是异常类型；测试一个函数是否会失败，可以用CPPUNIT_TEST_FAIL(testMethod)，这个宏与CPPUNIT_TEST()做相反的操作。
2.6 编译该测试文件
把以上代码复制粘贴到一个cpp文件中进行编译还不能通过，需要引入如下头文件：
#include <cppunit/TestRunner.h>
#include <cppunit/TestResult.h>
#include <cppunit/extensions/HelperMacros.h>
#include <cppunit/ui/text/TestRunner.h>
编译时，需要引用两个库文件，可以用如下命令进行编译：
g++ mytest.cpp –o mytest –lcppunit –ldl
命令中，mytest.cpp为源文件，mytest为目标文件，cppunit和dl为库文件。