CppUnit使用简介

简单描述CppUnit在Linux系统下的使用方法，以便在单元测试过程中能够提高正确率和效率。

1.2术语、定义和缩略语

1.3安装CppUnit

首先，需要到这个（http://sourceforge.net/project/showfiles.php?group_id=11795）地址下载一个CppUnit安装程序。该地址不仅有CppUnit安装程序，还有CppUnit的说明文档。本文以CppUnit1.12.0版进行说明。

有了压缩包了，就可以进行解压缩安装了，在压缩包所在目录下执行如下命令：

tar –xzf cppunit-1.12.0.tar.gz

cd cppunit-1.12.0

./configure

make

make check

make install

几乎每条命令都要执行几分钟。到此就已经完成安装了。

如果写好程序后进行编译，编译器报告没有库文件，则需要把/usr/local/lib下和cppunit有关的几个库文件拷贝到/usr/lib目录下。

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::TestSuite suite;

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为库文件。