Linux下Cppunit的简单运用

 

操作系统：

软件版本：cppunit-1.12.0.tar.gz

代码调试通过

 

一、           CppUnit的原理

先简单介绍几个CppUnit的基本术语：

1、Fixture：一个或一组测试用例的测试对象。可以是你要测试的对象或者函数。

2、TestCase：测试用例。是对测试对象的某个功能或流程编写的测试代码。对一个Fixture，可能有多个测试用例。

3、TestSuite：同时运行的测试用例的集合。可以是一个fixture的多个测试函数、也可以是多个fixture的所有测试用例。

使用时，在测试的主文件中将TestCase注册到TestSuite中，并运行。

 

二、 下载与安装

可以在http://sourceforge.net/projects/cppunit/找到最新的源码并下载至本地。我下载的版本是cppunit-1.12.0.tar.gz

 

解压：tar -zxvf cppunit-1.12.0.tar.gz

进入cppunit-1.12.0的目录

//因为我是非root用户，没有对/usr/local/lib/和/usr/include的相应权限，//所以将安装的根目录设置为我的个人目录

.configure –prefix=/home/me

make

make install    

这样，库文件就复制到/home/me了。

还要将cppunit-1.12.0中的头文件include复制到/home/me中。

 

三、利用cppunit建立测试的一般框架

通常将测试代码和被测的代码放在不同的工程里面，以免对我们要测试的代码造成污染，这也是运用cppunit的优点之一吧。

这样我们便有两个工程：

其一、待测工程：~/money

有两个文件：

Money.h

 Money.cpp

/**********************************************Money.h***********************************************/#ifndef _MONEY_H#define _MONEY_H#include <iostream>#include <string>using namespace std;class CMoney{public: CMoney( double amount, string currency ) : m_amount( amount ) , m_currency( currency ) { } ~CMoney(){} double GetAmount() const; string GetCurrency() const; bool operator ==( const CMoney &other ) const; bool operator !=( const CMoney &other ) const; CMoney &operator +=( const CMoney &other );private: double m_amount; string m_currency;};#endif

/*********************************************Money.cpp***********************************************/#include <iostream>#include <string>#include "Money.h"using namespace std;double CMoney::GetAmount() const{ return m_amount;}string CMoney::GetCurrency() const{ return m_currency;}bool CMoney::operator ==( const CMoney &other ) const{ return ((m_amount == other.m_amount) && (m_currency == other.m_currency));}bool CMoney::operator !=( const CMoney &other ) const{ return !(*this == other);}CMoney &CMoney::operator +=( const CMoney &other ){ if ( m_currency != other.m_currency ) cout << "Incompatible moneys" << endl; m_amount += other.m_amount; return *this;}

测试工程：~/MoneyTest

该工程下有三个文件：

Money_Test.h

Money_Test.cpp

Money_Test_Main.cpp

这三个文件的作用分别是：

Money_Test.h：声明一个TestSuite，并将你所需要的测试用例都在此处进行声明

Mone_Test.cpp：编写测试用例

Money_Test_Main.cpp：运行测试。该文件与具体的测试用例无关。

/*******************************************Money_Test.h2010.5.28********************************************/#ifndef _MONEY_TEST_H#define _MONEY_TEST_H#include "cppunit/extensions/HelperMacros.h"#include "Money.h"class CMoneyTest:public CppUnit::TestFixture{ /*声明一个TestSuite*/ CPPUNIT_TEST_SUITE(CMoneyTest); /*添加测试用例到TestSuite,定义新的测试用例都要在这里声明； 如果此处未声明某个测试用例，程序编译和运行都不会报错 仅仅是该测试用例不会被执行。 */ CPPUNIT_TEST(testConstructor); CPPUNIT_TEST(testOptorEqual); CPPUNIT_TEST(testOptorNotEqual); CPPUNIT_TEST(testOptorAdd); /*TestSuite声明完成*/ CPPUNIT_TEST_SUITE_END();public: CMoneyTest(){} /*初始化 */ void setUp(); /*清除动作 */ void tearDown(); /*test app in Money.cpp*/ /*test case */ void testConstructor(); void testOptorEqual(); void testOptorNotEqual(); void testOptorAdd();};

 

/************************************Money_Test.cpp5.28****************************************/#include "Money_Test.h"#include "Money.h"#include <string>using namespace std;/* 将该TestSuite注册到名字为“alltest”的TestSuite中，如果未定义会自动定义，也可以使用CPPUNIT_TEST_SUITE_REGISTRATION( MathTest );定义到全局未命名的TestSuite中 */CPPUNIT_TEST_SUITE_NAMED_REGISTRATION(CMoneyTest,"alltest");/*初始化动作*/void CMoneyTest::setUp(){}/*清除动作*/void CMoneyTest::tearDown(){}/*编写测试用例，此处编写四个用例分别来测试CMoney类的四个成员函数*//*test app in Money.cpp*//*test constructor*/void CMoneyTest::testConstructor(){ double dNum = 22124.44; string sCurrency = "DD"; CMoney MyMoney(dNum, sCurrency); CPPUNIT_ASSERT_EQUAL(dNum, MyMoney.GetAmount()); CPPUNIT_ASSERT_EQUAL(sCurrency, MyMoney.GetCurrency());}/*test operator ==()*/void CMoneyTest::testOptorEqual(){ // Set up const CMoney money123FF( 123, "FF" ); const CMoney money123USD( 123, "USD" ); const CMoney money12FF( 12, "FF" ); const CMoney money12USD( 12, "USD" ); // Process & Check CPPUNIT_ASSERT(money123FF == money123FF); // == CPPUNIT_ASSERT(!(money12FF == money123FF)); // != amount CPPUNIT_ASSERT(!(money123USD == money123FF)); // != currency CPPUNIT_ASSERT(!(money12USD == money123FF)); // != currency and != amount}/*test operator!=()*/void CMoneyTest::testOptorNotEqual(){ // Set up const CMoney money123FF( 123, "FF" ); const CMoney money123USD( 123, "USD" ); const CMoney money12FF( 12, "FF" ); const CMoney money12USD( 12, "USD" ); // Process & Check CPPUNIT_ASSERT(!(money123FF != money123FF)); // == CPPUNIT_ASSERT(money12FF != money123FF); // != amount CPPUNIT_ASSERT(money123USD != money123FF); // != currency CPPUNIT_ASSERT(money12USD != money123FF); // != currency and != amount}/*test operator+=()*/void CMoneyTest::testOptorAdd(){ // Set up const CMoney money12FF( 12, "FF" ); const CMoney expectedMoney( 135, "FF" ); // Process CMoney money( 123, "FF" ); money += money12FF; // Check CPPUNIT_ASSERT( expectedMoney == money ); // add works}

/****************************************************Money_Test_Main.cpp2010.5.28********************************************************/#include <cppunit/extensions/TestFactoryRegistry.h>#include <cppunit/ui/text/TestRunner.h>int main(){ CppUnit::TextUi::TestRunner runner; /*从注册的TestSuite获取特定的TestSuite,没有参数的话则获取未命名的TestSuite*/ CppUnit::TestFactoryRegistry ®istry = CppUnit::TestFactoryRegistry::getRegistry("alltest"); /*添加这个TestSuite到TestRunner中*/ runner.addTest(registry.makeTest()); /*运行测试*/ runner.run();}

CppUnit 提供的验证成功失败的方式有：

       CPPUNIT_ASSERT(condition)                              

// 确信condition为真

       CPPUNIT_ASSERT_MESSAGE(message, condition)   

// 当condition为假时失败, 并打印message

       CPPUNIT_FAIL(message)                                    

// 当前测试失败, 并打印message

       CPPUNIT_ASSERT_EQUAL(expected, actual)            

// 确信两者相等

       CPPUNIT_ASSERT_EQUAL_MESSAGE(message, expected, actual)      

// 失败的同时打印message

       CPPUNIT_ASSERT_DOUBLES_EQUAL(expected, actual, delta)      

// 当expected和actual之间差大于delta时失败

 

关于CPPUNIT_ASSERT_EQUAL还有一点要说明，该宏对于expected和actual是有要求的，也就是所谓的Requirement：

• 具有相同的类型（比如都是std::string）
• 可以使用<<序列化到std::strstream（assertion_traits<T>::toString中指明）
• 能用==作比较（assertion_traits<T>::equal中指明）

不过，后两条可以通过为assertion_traits定制特化版本去除掉。

四、编译与调试

编译、链接动态库：

g++ -o test Money_Test.cpp Money_Test_Main.cpp ~/money/Money.cpp -I ~/money -I ~/cppunit/include -lcppunit -ldl -L ~/cppunit/lib

运行前要将共享库的目录放到LD_LIBRARY_PATH中。

export LD_LIBRARY_PATH=~/cppunit/lib:$LD_LIBRARY_PATH

运行：

       ./test

测试结果：

OK (4 tests)

说明所写的4个测试用例均成功。

 

 

参考资料

Tx7do@上海半丁 Linux下的CppUnit 的HelloWorld手记

李群：便利的开发工具 CppUnit 快速使用指南

http://www.ibm.com/developerworks/cn/linux/l-cppunit/index.html

CppUnit使用指南