QTS单元测试框架

1.QTS单元测试框架介绍
目前QTS项目采用C/C++语言,而CppUnit就是xUnit家族中的一员,它是一个专门面向C++的单元测试框架。因此,QTS采用CppUnit测试框架是比力抱负的选择。
CppUnit按照条理来管理测试,最底层的就是TestCase,当有了几个TestCase以后，可以将它们组织成TestFixture。在TestFixture中,可以创建被测试的类的实例,并编写TestCase对类实例举行测试,多个TestFixture可以通过TestSuite来对测试举行管理。
通过派生TestFixture类来计划某个类或某组相干功能的单元测试,Fixture界说公共函数setUp()初始化每个成员变量,tearDown()来释放setUp中使用的资源。在每个测试中,CPPUNIT_ASSERT(bool)来判定某个函数和表达式的正确性,在派生类的声明中,通过CPPUNIT_TEST来增加对应的测试函数,通过CPPUNIT_TEST_SUITE和CPPUNIT_TEST_SUITE_END来分装所有的测试函数,规定这些测试函数执行的序次。
 2.QTS单元测试框架搭建
2.1CppUnit介绍
A、CppUnit源代码构成
CppUnit测试框架的源代码可以到 http://sourceforge.net/projects/cppunit/ 上下载。下载解压后，你将看到如下文件夹：

主要的文件夹有：
· doc: CppUnit的说明文档。别的，代码的根目录，还有三个说明文档，分别是INSTALL，INSTALL-unix，INSTALL-WIN32.txt。
· examples: CpppUnit提供的例子，也是对CppUnit自身的测试，通过它可以学习如何使用CppUnit测试框架举行开发。
· include: CppUnit头文件。
· src: CppUnit源代码目录。
B、初识CppUnit测试环境
解压源代码包后， CppUnit结构如下:
    1、进入example文件夹，用VC打开examples.dsw。我们先来看看CppUnit自带的测试例子。这些例子都是针对CppUnit自身的单元测试集，一方面这是CppUnit作者开发CppUnit框架过程中写的测试用例，另一方面，我们可以通过这些例子来学习如安在我们自己的工程中添加测试用例。

    2、将CppUnitTestApp工程设为Active Project（Win32 Debug），编译后运行，则可以看到CppUnit的基于GUI方式举行单元测试TestRunner的界面。点击“Run”，将会看到如图二所示界面：
 

这是一个针对CppUnit的单元测试结果，它表明刚才我们做了11个测试，全部通过。
点击“Browse”,我们还可以选择想要举行的单元测试，如图三：

2.2 CppUnit单元测试环境搭建
第一步:编译CppUnit 静态库文件*.lib和动态库文件*.dll:

• CppUnit的lib和dll
  

 CppUnit为我们提供了两套框架库，一个为静态的lib，一个为动态的dll。
  cppunit project：静态lib
  cppunit_dll project：动态dll和lib
在开发中我们可以根据现实环境作出选择。进入src文件夹，打开CppUnitLibraries.dsw。分别编译这两个project，输出位置均为lib文件夹。
在开发中我们可以根据现实环境作出选择。进入src文件夹，打开CppUnitLibraries.dsw。在菜单上选择Build->Batch Build..->Rebuild All，输出位置均为lib文件夹。
为了方便开发，我们把这些编译出来的lib和dll拷贝到我们自己创建的一个文件夹中(当然你也可以不这么做)，例如F:\Mytest\lib\，同时我们也把CppUnit源代码中include文件夹copy到我们自己的include文件夹下。   
第二步:创建基于对话框的工程
打开VC，在File菜单项下选择New，创建基于dialog的工程。工程名Project name、存放位置Location可以自己决定，其他选项如下：

按OK确认后，进入如下界面。选择Dialog based选项，按Finish按钮后，一个空的基于对话框的工程就创建起来了。

第三步:屏蔽工程对话框
在工程CouterTest.cpp文件中（本指南中为该文件名，现实学习时根据自己的工程文件名而变），找到BOOL CCounterTestApp::InitInstance()方法，将如下附带代码注释掉：也就是代码中带*的部门

1. BOOL CCounterTestApp::InitInstance()
2. {
3.         AfxEnableControlContainer();
5.         // Standard initialization
6.         // If you are not using these features and wish to reduce the size
7.         //  of your final executable, you should remove from the following
8.         //  the specific initialization routines you do not need.
10. #ifdef _AFXDLL
11.         Enable3dControls();                        // Call this when using MFC in a shared DLL
12. #else
13.         Enable3dControlsStatic();        // Call this when linking to MFC statically
14. #endif
16.         /*
17.         CCounterTestDlg dlg;
18.         m_pMainWnd = &dlg;
19.         int nResponse = dlg.DoModal();
20.         if (nResponse == IDOK)
21.         {
22.                 // TODO: Place code here to handle when the dialog is
23.                 //  dismissed with OK
24.         }
25.         else if (nResponse == IDCANCEL)
26.         {
27.                 // TODO: Place code here to handle when the dialog is
28.                 //  dismissed with Cancel
29.         }
31.   */
32.         // Since the dialog has been closed, return FALSE so that we exit the
33.         //  application, rather than start the application's message pump.
34.         return FALSE;
35. }

复制代码

由于我们盼望这个Project运行后显示的是图2如许的CppUnit自带的界面，所以我们必要在Instance()中屏蔽掉原有的对话框（蓝色部门注释掉），代之以CppUnit的GUI。

第四步:实现CppUnit测试执行器，并将测试套添加到测试执行器中。
A、在BOOL CCounterTestApp::InitInstance()中，添加如下附加注释的代码：

1. BOOL CCounterTestApp::InitInstance()
2. {
3.         AfxEnableControlContainer();
5.         // Standard initialization
6.         // If you are not using these features and wish to reduce the size
7.         //  of your final executable, you should remove from the following
8.         //  the specific initialization routines you do not need.
10. #ifdef _AFXDLL
11.         Enable3dControls();                        // Call this when using MFC in a shared DLL
12. #else
13.         Enable3dControlsStatic();        // Call this when linking to MFC statically
14. #endif
16.         //添加CppUnit的MFC类型的测试执行器
17.         CppUnit::MfcUi::TestRunner runner;
19.         //为被测试类（这里是CCounter）定义一个测试工厂(这里取名叫CounterTest):
20.         CppUnit::TestFactoryRegistry &registry
21. = CppUnit::TestFactoryRegistry::getRegistry("CounterTest");
23.         //并将工厂添加到测试执行器中
24. runner.addTest( registry.makeTest() );
26.         //运行执行器，显示执行器GUI界面
27.         runner.run();
29.         /*
30.         CCounterTestDlg dlg;
31.         m_pMainWnd = &dlg;
32.         int nResponse = dlg.DoModal();
33.         if (nResponse == IDOK)
34.         {
35.                 // TODO: Place code here to handle when the dialog is
36.                 //  dismissed with OK
37.         }
38.         else if (nResponse == IDCANCEL)
39.         {
40.                 // TODO: Place code here to handle when the dialog is
41.                 //  dismissed with Cancel
42.         }
44.   */
45.         // Since the dialog has been closed, return FALSE so that we exit the
46.         //  application, rather than start the application's message pump.
47.         return FALSE;
48. }

复制代码

B、由于在BOOL CCounterTestApp::InitInstance()中引用了CppUnit的类，所以在文件开始处要添加如下头文件：

1. #include <cppunit/extensions/TestFactoryRegistry.h>
2. #include <cppunit/ui/mfc/TestRunner.h>

复制代码

第五步：添加被测对象CCounter。
将被测对象地点文件（CounterMod.h和CounterMod.cpp） 添加到工程中：

第六步：在工程中为被测对象CCounter编写测试类文件MyTest(可以自界说文件名)：
按照下面示图加入测试类的*.h文件和*.cpp文件：

MyTest.h中的代码如下：

1. #include "cppunit/extensions/HelperMacros.h"
3. class IsCodeLineTest : public CppUnit::TestFixture {
4.         // 声明一个TestSuite
5.         CPPUNIT_TEST_SUITE( IsCodeLineTest);
6.         // 添加测试用例到TestSuite, 定义新的测试用例需要在这儿声明一下
7.         CPPUNIT_TEST( Test1 );
8.         // TestSuite声明完成
9.         CPPUNIT_TEST_SUITE_END();
10.        
12. public:
13.         // 定义测试用例
14.         void Test1 ();
15.        
16. };

复制代码

MyTest.cpp中的代码如下（留意头文件要做相应的修改）：

1. #include "stdafx.h"
3. #include "MyTest.h"
4. #include "CounterMod.h"
6. // 把这个TestSuite注册到名字为"CounterTest"的工厂中
7. CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( IsCodeLineTest,"CounterTest" );
9. #define RET_OK 0
10. #define RET_FAIL 1
12. void IsCodeLineTest::Test1()
13. {
14.      //定义输入参数
15.         int bIsComment;
16.         CString  szFileLine;
18.         //定义期望输出
19.         int iOkReturn;
20.         int iOkIsComment;
22.         //定义测试实际输出
23.         int iResult;
24.        
25.         CCounter m_counter;
27.         //用例输入
28.         szFileLine = "int a";
29.         bIsComment = false;
31.         //期望输出
32.         iOkReturn = RET_OK;
33.         iOkIsComment = false;
35.         //驱动被测函数
36.         iResult = m_counter.IsCodeLine(szFileLine,bIsComment);
38.         //结果比较
39.         CPPUNIT_ASSERT_EQUAL(iOkReturn,iResult);
40.              CPPUNIT_ASSERT_EQUAL(iOkIsComment,bIsComment);
41. }

复制代码

第七步：加入CppUnit 库文件：

把CppUnit相干的lib文件和dll文件（cppunitd.lib,cppunitd_dll.lib,testrunnerd.lib）加入到工程中：

第八步：设置头文件和lib库文件路径、打开RTTI开关、给dLL库设置环境变量：

• 在VC的tools/options/directories/include files和library files中设置CppUnit include文件路径和lib文件路径：
  

在你的VC project中打开RTTI开关。具体位置Project Settings/C++/C++ Language：

C、为TestRunnerd.dll设置环境变量
　　 TestRunnerd.dll为我们提供了基于GUI的测试环境。为了让我们的测试程序能正确的调用它，必要把TestRunnerd.dll拷贝到你的工程路径下。或者最简单的方法是在操作体系的环境变量Path中添TestRunnerd.dll的路径，如许是最省事的。

第九步：编译执行。编译毗连成功后，运行测试，出现下面的界面,表现测试用例Test1运行成功.

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。