CppUint试用总结

一、关于CppUint

CppUnit是一个非常优秀的开源测试框架,主要功能就是对单元测试进行管理,并可进行自动化测试。

CppUint进行测试时,一般先以某个函数或者某个类作为测试单元,完成测试;在完成这些基本的测试后,再将引用到测试过的这些函数或者类的函数或者类,左为测试单元完成测试;继续下去,从而完成整个模块甚至是整个系统的测试,从而达到更多清除bug的目的。

测试中,始终以功能代码为主要测试对象,对GUI部分太弱。

二、基本原理

CppUint进行测试的基本原理是:对于每一批测试,编写一个继承自TestFixture的测试类,其中setUp和tearDown 两个虚函数分别用于进行测试数据的初始化和释放操作;对于每一项测试,分别定义一个void返回类型的无参数方法,检测测试过程,可以用以下几个宏:

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时失败

其中,“失败”的含义就是程序运行出现异常,并且所有测试过程中止。

       在完成一个或者多个测试类的编写后,需要用TestRunner类的实例来运行每个测试类的测试函数进行测试。TestRunner类型共有:TextUi::TestRunner,QtUi::TestRunner,MfcUi::TestRunner三个,都可以用来运行测试,其区别为:

TextUi::TestRunner

默认将信息输出到控制台,也可以指定输出到std::ostringstream

QtUi::TestRunner

QTGUI输出信息

MfcUi::TestRunner

MFCGUI输出信息

       整个测试过程需要另外附加代码,所以通常情况下,测试用例代码和被测试对象因在不同的项目中。应该在另一个项目(最好在不同的目录)中编写测试类,然后把被测试的对象包含在测试项目中。根据测试工程建立的类型,Consol可以选择TextUi::TestRunner,将结果输出至控制台显示,MFC的GUI可以使用MfcUi::TestRunner,使用GUI来控制并查看测试结果。测试工程与被测试对象所在工程的类型是可以不同的。

       在使用VC作为开发工工具时,建议使用TextUi::TestRunner,并更改其Outputter实例,使用附加的TraceOutputter,将信息输出到信息输出栏,双击信息输出栏中一行,即可定位到出错位置。

三、安装方式

3.1常规安装方式

VC使用为例,步骤如下:

1.       获取原始包,比如cppunit-1.10.2.rar,解压缩到某个目录,比如d:\cppunit-1.10.2

2.       打开VC,菜单Tools > Options,在Options对话框的Directories页中,include Files添加“d:\cppunit-1.10.2\include”,Library Files添加“d:\cppunit-1.10.2\lib”。

3.       打开工程d:\cppunit-1.10.2\src\CppUnitLibraries.dsw,在该工程中,cppuint是静态库版本,cppunit_dll是动态库版本,一般只需要完成release版本编译,如果想要研究源代码,可以考虑编译debug版本,用于调试和跟踪代码。

4.       如要使用MfcUi::TestRunner,编译dsplugin工程和TestRunner工程。dsplugin是一个VC的插件,TestRunner就是MfcUi::TestRunner的实现。

3.2建议公司内部安装方式

建立一个简单的安装包,将需要的文件和配置等,自动完成拷贝和添加,供开发人员使用。

所有人使用同一个编译版本,避免不必要的麻烦。

四、使用方法

4.1测试类定义

步骤如下:

1.       包含文件#include <cppunit/extensions/HelperMacros.h>

2.       声明一个类,比如,CMyTestFixture,继承自CppUnit::TestFixture

3.       声明setUptearDown函数。

4.       声明测试函数,比如RunTestFunc

5.       如果含有其他测试函数,继续添加。

6.       在类声明部分添加如下宏,声明改类为测试类,并且声明那些函数为测试函数

CPPUNIT_TEST_SUITE( CMyTestFixture);

CPPUNIT_TEST( RunFunc );

CPPUNIT_TEST_SUITE_END();

7.       最后在实现的CPP文件中,添加下面的宏,用于注册测试类到某个测试项目,比如以"MyTest"命名的项目。

CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( CMyTestFixture, "MyTest" );

8.       实现setUptearDown,以及各个测试函数。

 

下面是一个例子的头文件

#include <cppunit/extensions/HelperMacros.h>

class CMyTestFixture : public CppUnit::TestFixture

{

       CPPUNIT_TEST_SUITE( CMyTestFixture );

       CPPUNIT_TEST( RunTestFunc);

       CPPUNIT_TEST_SUITE_END();

public:

       CMyTestFixture();

       virtual ~CMyTestFixture();

       virtual void setUp();

       virtual void tearDown();

       void RunTestFunc();

};

下面是实现文件内容

 

CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( CMyTestClass, "MyTest" );

 

       CMyTestFixture::CMyTestFixture()

       {

              ……

       }

       CMyTestFixture::~CMyTestFixture()

       {

//            ……

       }

       void CMyTestFixture::setUp()

       {

//            ……

       }

       void CMyTestFixture:: tearDown()

       {

//            ……

       }

       void CMyTestFixture::RunTestFunc()

       {

//            ……

              CPPUNIT_ASSERT_MESSAGE( "Error Here", 0);

//            ……

       }

};

4.2运行测试

以控制台中运行为例,步骤如下:

1.       包含头文件#include <cppunit/extensions/TestFactoryRegistry.h>

2.       包含TextUi::TestRunner的头文件#include <cppunit/ui/text/TestRunner.h>

3.       定义TestRunner的实例:CppUnit::TextUi::TestRunner      runner;

4.       根据项目命名,得到某个项目的实例:

       CppUnit::TestFactoryRegistry &registry =

CppUnit::TestFactoryRegistry::getRegistry("MyTest");

5.       将测试内容添加到TestRunner实例中:runner.addTest( registry.makeTest());

6.       运行测试:runner.run();

如下,就是一个例子代码:

#include <cppunit/extensions/TestFactoryRegistry.h>

#include <cppunit/ui/text/TestRunner.h>

 

int main(int argc, char* argv[])

{

       CppUnit::TextUi::TestRunner  runner;

      

       CppUnit::TestFactoryRegistry &registry =

                     CppUnit::TestFactoryRegistry::getRegistry("MyTest");

       runner.addTest( registry.makeTest());

       runner.run();

 

       return 0;

}

以及其运行后的效果:

根据框中所显示的内容,可以知道在什么位置,测试失败了。

 

如果要输出到VC的输出窗口,对控制台中的代理做如下修改:

1.       再添加一个包含的头文件#include <cppunit/TraceOutputter.h>

2.       在进行步骤6运行测试前,添加如下代码

runner.setOutputter( new CppUnit::TraceOutputter( runner.result()));

部分修改后的代码如下:

       runner.addTest( registry.makeTest());

       runner.setOutputter( new CppUnit::TraceOutputter( runner.result()));

       runner.run();

根据框中所显示的内容,可以知道在什么位置,并且直接双击该行,直接定位到相应代码。使用时一定要注意,如果使用该模式,只能在Windows下使用,必须在#include <cppunit/TraceOutputter.h>前一定要先#include <windows.h>

 

如果使用MfcUi::TestRunner,对控制台中的代理做如下修改:

1.       步骤2中包含TextUi::TestRunner的头文件改成包含MfcUi::TestRunner的头文件

#include <cppunit/ui/MFC/TestRunner.h>

2.       步骤3定义TestRunner的实例的代码改成:CppUnit::MfcUi::TestRunner runner;

根据框中所显示的内容就是错误的位置,直接双击该条,也可以定位到相应代码。该方法必须在MFC下使用。

 

       在目前以VC最为主要开发工具的情况下,使用输出到VC的输出窗口的方法比较合适。

       在具体使用后,再提供更具体的使用实例和一些使用方法和技巧。

标签:  VC CPPUNIT

转自 http://www.cnblogs.com/wishma/archive/2008/08/01/1258370.html

你可能感兴趣的:(CppUint试用总结)