CppUnit使用简介

1 引言

1.1摘要

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

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()是一个类似于断言的宏定义,根据括号内的逻辑语句是truefalse得出不同的结果,至于所得结果的用法,下面介绍。

需要注意的是,不要自作聪明的给这个类加入构造函数、复制构造函数、赋值函数。任何不必要的函数都会让程序编译不过去。

2.3 使用TestSuite

你不希望用上小节的类,一条一条的在main函数中调用执行吧?这样的工作量将大的惊人。我们有更好的办法,把它们都加入到一个TestSuite中,直接执行这个suiterun()成员函数就可以了,下面是加入方法:

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,然后定义一个resultresult用于接收测试的执行结果。

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为目标文件,cppunitdl为库文件。

你可能感兴趣的:(cpp)