[vs2010 配置与实例] CppUnit快速入门

简介测试是软件开发过程中极其重要的一环，详尽周密的测试能够减少软件BUG，提高软件品质。

测试包括单元测试、系统测试等。

其中单元测试是指针对软件功能单元所作的测试，这里的功能单元可以是一个类的属性或者方法，测试的目的是看这些基本单元是否工作正常。

由于单元测试的内容很基础，因此可以看作是测试工作的第一环，该项工作一般由开发人员自行完成。

如果条件允许，单元测试代码的开发应与程序代码的开发同步进行。

虽然不同程序的单元测试代码不尽相同，但测试代码的框架却非常相似，于是便出现了一些单元测试类库，CppUnit便是其中之一。

CppUnit是XUnit中的一员，XUnit是一个大家族，还包括JUnit和PythonUnit等。

CppUnit简单实用，学习和使用起来都很方便，网上已有一些文章对其作介绍，但本文更着重于讲解其中的基本概念和使用方法，以帮助初次接触CppUnit的人员快速入门。

安装1、先下个最新版cppunit-1.12.1.tar.gz解压缩，进入cppunit-1.12.1\src目录，就是源代码所在，打开CppUnitLibraries.dsw工程，是用vc6.0写的，用vs2010打开转换到CppUnitLibraries.sln ok，2、然后依次运行CppUnitLibraries.dsw工程下的每个项目，这样做的目的是为了方面发现问题和找到正确的解决方法。

下面是我在运行相应项目时所提示的错误以及解决办法1)运行项目Cppunit解决办法：选择Cppunit右键属性->（debug）配置属性->常规->目标文件名：$(ProjectName)修改成cppunit d（这样做是为保持链接器->常规->目标文件名一致）；2)运行项目cppunit_dll解决办法：选择Cppunit右键属性->（debug）配置属性->常规->目标文件名：$(ProjectName)修改成cppunit d_dll （这样做是为保持库管理器->常规->目标文件名一致）；3）到这里这里会发现其实每个项目的错误基本上都是TargeName(xxx)与Linker的OutputFile属性值不匹配；依次修改项目DllPlugInTester、DSPlugIn、TestPlugInRunner、TestRunner的Debug配置属性（每个后面都记得加个”d”，而且库管理器中为：目标文件名.xx，xx不需要修改，但库管理器中的目标文件名可能要修改，改成与:常规---目标文件名一致！）4）当然当修改完DSPlugIn的Debug配置属性后再运行我们发现我们仔细观察到底新的错误是什么呢？这里修改方式就是最上面的红色字中提到的修改TestRunner下UserInterface\DynamicWindow\MsDevCallerListCtrl.cpp文件第67行，改成：#import "libid:80cc9f66-e7d8-4ddd-85b6-d9e6cd0e93e2" version("8.0") lcid("0")raw_interfaces_onlynamed_guids5）再次运行DSPlugIn项目我们会发现依然有错误解决方法：选择项目->属性->配置属性->链接器->高级->无入口点选择"是(/NOENTRY)"6)最后为了生成全面的库文件我需要分别在Debug、release、Debug unicode、releaseunicode四种配置属性中生成全部解决方案。

（运行过程中会遇到错误基本上都可以从上文中找到解决方法）7)编译完成后，提示成功6 失败0 即安装完毕详细说明：解压后，你可以看到CppUnit包含如下目录：config：配置文件contrib： contribution，其他人贡献的外围代码doc：文档，需要通过doxygen工具生成，也可以直接从sourceforge站点上下载打包好的文档examples：示例代码include：头文件lib：存放编译好的库src：源文件，以及编译库的工程等然后打开src目录下的CppUnitLibraries工程，执行build/batch build，编译成功的话，生成的库文件将被拷贝到lib目录下。

你也可以根据需要选择所需的项目进行编译，其中项目cppunit为静态库，cppunit_dll为动态库，生成的库文件为：cppunit.lib：静态库release版cppunitd.lib：静态库debug版cppunit_dll.lib：动态库release版cppunitd_dll.lib：动态库debug版要使用CppUnit，还得设置好头文件和库文件路径，以VC6为例，选择Tools/Options/Directories，在Include files和Library files中分别添加%CppUnitPath%/include和%CppUnitPath%/lib，其中%CppUnitPath%表示CppUnit所在路径。

做好准备工作后，我们就可以编写自己的单元测试代码了。

需说明的是，CppUnit所用的动态运行期库均为多线程动态库，因此你的单元测试程序也得使用相应设置，否则会发生冲突。

概念在使用之前，我们有必要认识一下CppUnit中的主要类，当然你也可以先看后面的例子，遇到问题再回过头来看这一节。

CppUnit核心内容主要包括六个方面，1. 测试对象（Test，TestFixture，...）：用于开发测试用例，以及对测试用例进行组织管理。

2. 测试结果（TestResult）：处理测试用例执行结果。

TestResult与下面的TestListener采用的是观察者模式（Observer Pattern）。

3. 测试结果监听者（TestListener）：TestListener作为TestResult的观察者，担任实际的结果处理角色。

4. 结果输出（Outputter）：将结果进行输出，可以制定不同的输出格式。

5. 对象工厂（TestFactory）：用于创建测试对象，对测试用例进行自动化管理。

6. 测试执行体（TestRunner）：用于运行一个测试。

以上各模块的主要类继承结构如下：Test TestFixtureTestResultTestListener_______|_________ | | | | |TestSuccessListenerTestCompositeTestLeaf | || |____________|TestResultCollectorTestSuit |TestCase|TestCaller<Fixture>OutputterTestFactoryTestRunner____________________|_________________ || | |TestFactoryRegistryCompilerOutputterTextOutputterXmlOutputter |TestSuiteFactory<TestCaseType>接下来再对其中一些关键类作以介绍。

Test：所有测试对象的基类。

CppUnit采用树形结构来组织管理测试对象（类似于目录树），因此这里采用了组合设计模式（Composite Pattern），Test的两个直接子类TestLeaf和TestComposite分别表示“测试树”中的叶节点和非叶节点，其中TestComposite主要起组织管理的作用，就像目录树中的文件夹，而TestLeaf才是最终具有执行能力的测试对象，就像目录树中的文件。

Test最重要的一个公共接口为：virtual void run(TestResult *result) = 0;其作用为执行测试对象，将结果提交给result。

在实际应用中，我们一般不会直接使用Test、TestComposite以及TestLeaf，除非我们要重新定制某些机制。

TestFixture：用于维护一组测试用例的上下文环境。

在实际应用中，我们经常会开发一组测试用例来对某个类的接口加以测试，而这些测试用例很可能具有相同的初始化和清理代码。

为此，CppUnit引入TestFixture来实现这一机制。

TestFixture具有以下两个接口，分别用于处理测试环境的初始化与清理工作：virtual void setUp(); //初始化virtual void tearDown(); //清理TestCase：测试用例，从名字上就可以看出来，它便是单元测试的执行对象。

TestCase从Test和TestFixture多继承而来，通过把Test::run制定成模板函数（Template Method）而将两个父类的操作融合在一起，run函数的伪定义如下：// 伪代码void TestCase::run(TestResult* result){result->startTest(this); // 通知result测试开始if( result->protect(this, &TestCase::setUp) ) // 调用setUp，初始化环境result->protect(this, &TestCase::runTest); // 执行runTest，即真正的测试代码result->protect(this, &TestCase::tearDown); // 调用tearDown，清理环境result->endTest(this); // 通知result测试结束}这里要提到的是函数runTest，它是TestCase定义的一个接口，原型如下：virtual void runTest();用户需从TestCase派生出子类并实现runTest以开发自己所需的测试用例。

另外还要提到的就是TestResult的protect方法，其作用是对执行函数（实际上是函数对象）的错误信息（包括断言和异常等）进行捕获，从而实现对测试结果的统计。

TestSuit：测试包，按照树形结构管理测试用例TestSuit是TestComposite的一个实现，它采用vector来管理子测试对象（Test），从而形成递归的树形结构。

TestCaller：TestCase适配器（Adapter），它将成员函数转换成测试用例虽然我们可以从TestCase派生自己的测试类，但从TestCase类的定义可以看出，它只能支持一个测试用例，这对于测试代码的组织和维护很不方便，尤其是那些有共同上下文环境的一组测试。