2007-08-19 13:44:18 / 个人分类：QTP

1.取得Cppunit发行版本,下载的是cppunit-1.10.2
2.使用INSTALL-WIN32.txt，
3.查看examples中的例子，观看其配置。

Libraries:
----------

All the compiled libraries and DLL can be found in the 'lib' directory.
Most libraries can be build from src/CppUnitLibraries.dsw workspace.

lib\:
cppunit.lib    : CppUnit static library "Multithreaded DLL"
cppunitd.lib   : CppUnit static library "Debug Multithreaded DLL"
cppunit_dll.dll   : CppUnit dynamic library (DLL) "Multithreaded DLL"
cppunit_dll.lib   : CppUnit dynamic import library "Multithreaded DLL"
cppunitd_dll.dll  : CppUnit dynamic library (DLL) "Debug Multithreaded DLL"
cppunitd_dll.lib  : CppUnit dynamic import library "Debug Multithreaded DLL"
qttestrunner.dll  : QT TestRunner dynamic library (DLL) "Multithreaded DLL"
qttestrunner.lib  : QT TestRunner import library "Multithreaded DLL"
testrunner.dll   : MFC TestRunner dynamic library (DLL) "Multithreaded DLL"
testrunner.lib   : MFC TestRunner import library "Multithreaded DLL"
testrunnerd.dll   : MFC TestRunner dynamic library (DLL) "Debug Multithreaded DLL"
testrunnerd.lib   : MFC TestRunner import library "Debug Multithreaded DLL"
testrunneru.dll   : MFC Unicode TestRunner dynamic library (DLL) "Multithreaded DLL"
testrunneru.lib   : MFC Unicode TestRunner import library "Multithreaded DLL"
testrunnerud.dll  : MFC Unicode TestRunner dynamic library (DLL) "Debug Multithreaded DLL"
testrunnerud.lib  : MFC Unicode TestRunner import library "Debug Multithreaded DLL"
TestRunnerDSPlugIn.dll : The add-in you register in VC++.

A. 新建一个MFC应用程序
                                                  B. 在“工具”－选项－目录

                       
                                                      C. 在工程配置里面选择RTTI

                       

Link下加入 Debug\cppunitd.lib Debug\testrunnerd.lib ，记得把这辆个文件从cppunit-1.10.2\lib拷出来，把相应的dll文件也拷到debug目录下

        D. 在App初始化函数中App::InitInstance()的开头加入
 #include <cppunit/ui/mfc/TestRunner.h>
#include <cppunit/extensions/TestFactoryRegistry.h>
在其中加入  
CppUnit::MfcUi::TestRunner runner;
runner.addTest( CppUnit::TestFactoryRegistry::getRegistry().makeTest() );
 runner.run();   
记得把原来的窗口注掉，不然调用的还是原来的窗口。

E. 加入要测的类叫XXX
我们起这个类的测试叫testXXX 类

#include <cppunit/TestCase.h>
#include <cppunit/extensions/HelperMacros.h>

#include "testXXX .h"

class testXXX : public CppUnit::TestCase 
{
 CPPUNIT_TEST_SUITE(testXXX );
  CPPUNIT_TEST(testcase1);   //这里就是我们的testcase的函数原型名字
  CPPUNIT_TEST(testcase2);
 CPPUNIT_TEST_SUITE_END();

public:
 void setUp();
 void tearDown();

protected:
 void testcase1();//声明我们的测试函数
 void testcase2();

private:
 testXXX *fixture;

};

其cpp文件必须要有

CPPUNIT_TEST_SUITE_REGISTRATION(testXXX);
然后
void testXXX::setUp()
{
 fixture = new testXXX();//当然要按照实际的类构造你的测试对象了
}
 
void testXXX::tearDown()
{
 delete fixture;
 fixture = NULL;//析构你的测试对象
}

下面就是你的测试函数

void testXXX::testcase1()
{
     CPPUNIT_ASSERT(condition1);//如果condition1为false激发这个assert
     CPPUNIT_ASSERT_MESSAGE(”msg“ , condition2);
    ……
}

第二个类似这样就可以
运行结果类似于下面的窗口

                    

        ok，好多东西我还没有使用，今天就到这里，不过感觉挺好设置的，还是觉得比较麻烦了些，在MinGW Developer Studio不知道能否使用，我还没有使用过，赶明儿试试。

  1. CppUnit是xUnit系列中的c++实现版本，它是从JUnit移植过来的，第一个移植版本由Michael Feathers完成，安装cppunit,你可以在此下载cppunit的最新版本，最新版本是CppUnit release 1.12.0，安装方法，现解压，然后到文件夹下找到INSTALL-WIN32.txt（windows平台）

        2.打开\examples下的examples.dsw，编译链接即可完成。

        3.分析所要测试的类class

class Money
{
public:
  Money( double amount, std::string currency )
    : m_amount( amount )
    , m_currency( currency )
  {
  }

  double getAmount() const
  {
    return m_amount;
  }

  std::string getCurrency() const
  {
    return m_currency;
  }

  bool ōperator ==( const Money &other ) const
  {
    return m_amount == other.m_amount  && 
           m_currency == other.m_currency;
  }

  bool operator !=( const Money &other ) const
  {
    return !(*this == other);
  }

  Money &operator +=( const Money &other )
  {
    if ( m_currency != other.m_currency )
      throw IncompatibleMoneyError();

    m_amount += other.m_amount;
    return *this;
  }

private:
  double m_amount;
  std::string m_currency;
};

        4. 所要测试的有哪些接口呢？

        我们分析一下这个类的公开的属性和方法。这些都是我们要测试的接口。

构造函数
Money( double amount, std::string currency )
接口函数有
double getAmount() const
std::string getCurrency() const
bool ōperator ==( const Money &other ) const
bool operator !=( const Money &other ) const
Money &operator +=( const Money &other )

添加一个测试集test suite
 
        测试集包含一组相关的测试用例，他的目的像其他的框架中的test suite和test fixture共同的功能。
        有两个关键的方法（都是可选的）是setup和teardown，它们总是成对出现。
struct TestAccountSuite : TestSuite
{
    const char* name() { return "Account suite"; }
 
    void setup()
    {
        account = new Account();
    }
 
    void teardown() 
    {
        delete account;
    }
 
    Account* account;
};

        把它们组织到一起
        一旦一个测试集和至少一个测试用例完成之后我们可以将它们放到一个runner中执行。
#include <stdio.h>
#include "shortcut.h"
#include "tests/account.h"
int main(int argc, char* argv[])
{
    TestRunner runner;
    TestAccountSuite accountSuite;
    TestAccountWithdrawal accountWithdrawalTest;
 
    accountSuite.AddTest(&accountWithdrawalTest);
    runner.AddSuite(&accountSuite);
    runner.RunTests();
    
    return 0;
}

        这个很小的系统的好处是能够都在一个头文件中。这就防止不同类的声明定义重复。因为之用一个头文件，所以只需要要一个驱动（driver），比如在main函数中。
这个系统可以很容易添加一个测试用例到现有的程序中。比如，一些用例被#ifdef DEBUG宏控制块，在Release版本就不会输出到二进制文件中，不会连接到其他单元测试库上。
        显然这不是长效的解决方法，尽管是一个好的方法的开始。开发人员能够在开发时间内分离测试和code才是

基类
        所有的测试用例派生与一个基类TestCase.
struct TestCase
{
    TestCase() : next(0) {}
    
    virtual void test(TestSuite* suite) {}
    virtual const char* name() { return "?"; }
    
    TestCase* next;
};

        有个名字的方法用来记录错误的。用一个指针指向测试用例的列表。它本身是个虚函数能够派生。

        测试集test suite具有相同的结构，除了包含一系列case和两个重载函数setup和teardown

+struct TestSuite
{
    TestSuite() : next(0), tests(0) {}
 
    virtual void setup() {}
    virtual void teardown() {}
    virtual const char* name() { return "?"; }
 
    void AddTest(TestCase* tc)
    {
        tc->next = tests;
        tests = tc;
    }
 
    TestSuite* next;
    TestCase* tests;
};

        像开始提及的一样这个test suite类扮演着其他框架中的 test suite和test fixture类的角色. 这在写框架中，当fixture提供setup/teardown机制时，suite常常扮演测试组织的角色，因为 ShortCUT是一个简单的框架,就不需要创建这些复杂的类了。当开发需要一个类似的功能是很容易定制的加上

执行Runner
 
        一个测试的runner是测试的主体，当然也是一个非常直接的他的主线是调用测试的方法，run每个suite。
struct TestRunner
{
    ...
    void RunSuite(TestSuite* suite, int& testCount, int& passCount)
    {
        TestCase* test = suite->tests;
        while (test)
        {
            try
            {
                suite->setup();
                test->test(suite);
                passCount++;
            }
            catch (TestException& te)
            {
                log->write("FAILED '%s': %s\n", test->name(), te.text());
            }
            catch (...)
            {
                log->write("FAILED '%s': unknown exception\n", test->name());
            }
 
            try
            {
                suite->teardown();
            }
            catch (...)
            {
                log->write("FAILED: teardown error in suite '%s'\n", suite->name());
            }
 
            test = test->next;
            testCount++;
        }
    }
    ...
}

        这个关键点要注意，首先记录类执行在框架之外。这就容易让结果输出到另外一个目标中，像一个窗体。第二点，烦恼的是测试集合和测试用例像个链子一样，这就像一个LIFO的规则一样，反向与添加时候的顺序。

        这就会有一个简单的方式能够修复这个问题，但是为了框架的简单性我删除了它。

        这个框架的主要目标是是个尽量简单的解决方案。像TestLog类可以加到上面来帮助满足需求，尽管框架是简单的，但也不会失去基本的机动性。
        头文件有200行代码，四分之一是不需要的，希望能能够组建一个能够剪裁的系统、能够很容易使用修改定制的系统。

 介绍：
        在QA中，主要有两种测试
        单元测试：验证我们系统中的所有逻辑单元的验证行为（并不考虑其他单元的相互关系，比如其他的可以打成桩函数等。）
        系统测试（集成测试）各个单元之间的相互关系，检测系统运行行为。
单元测试用例设计
        在开发过程中，程序员通常用调试器来测试他们的程序，但是很少有人去单步调试程序，不会检测每个可能的变量值，这样我们就要借助一些工具来完成。就是我们所说的“单元测试框架”来测试我们的程序。
        我们来测试一个简单的c程序

BOOL addition(int a, int b)
{
    return (a + b);
}
        我们的用例必须借助其他的c函数来完成验证所有的可能性，返回True或者False来说明测试是否通过
BOOL additionTest()
{
    if ( addition(1, 2) != 3 )
        return (FALSE);

    if ( addition(0, 0) != 0 )
        return (FALSE);

    if ( addition(10, 0) != 10 )
        return (FALSE);

    if ( addition(-8, 0) != -8 )
        return (FALSE);

    if ( addition(5, -5) != 0 )
        return (FALSE);

    if ( addition(-5, 2) != -3 )
        return (FALSE);

    if ( addition(-4, -1) != -5 )
        return (FALSE);

    return (TRUE);
}
        我们看到，测试所有的可能性需要
        正数+负数， 0+0， 负数+0， 正数+0，正数+正数，负数+正数，负数+负数
        每个cases比较了加的结果和期望值，如果不通过就False，如果都通过就返回True

        行为上可以设计下面的例子：
int additionPropertiesTest()
{
    // conmutative: a + b = b + a
    if ( addition(1, 2) != addition(2, 1) )
        return (FALSE);

    // asociative: a + (b + c) = (a + b) + c
    if ( addition(1, addition(2, 3)) != addition(addition(1, 2), 3) )
        return (FALSE);

    // neutral element: a + NEUTRAL = a
    if ( addition(10, 0) != 10 )
        return (FALSE);

    // inverse element: a + INVERSE = NEUTRAL
    if ( addition(10, -10) != 0 )
        return (FALSE);

    return (TRUE);
}

        但是这样当代码变化时用例就得跟着相应的变化，或者去加一个新的case
        XP（极限编程）推荐就是在编写代码之前先写测试用例。就是测试驱动开发。

CPPUnit

CPPUnit
        各Case应该被写在类里面从TestCase 导出。这个类对我们所有基本功能进行测试, 在Test Suite（测试用例集合）登记等等

例如, 我们写了一个功能在磁盘存放一些数据的小模块。 这个模块(类名DiskData) 有主要二功能: 装载和保存数据到文件里面：
typedef struct _DATA
{
    int  number;
    char string[256];
} DATA, *LPDATA;

class DiskData
{
public:
    DiskData();
    ~DiskData();

    LPDATA getData();
    void setData(LPDATA value);

    bool load(char *filename);
    bool store(char *filename);

private:
    DATA m_data;
};

        现在, 什么编码方式并不重要, 因为最重要事是我们必须肯定它必须做, 是这个类应该做: 正确地装载和存放数据到文件。

        为了做这个验证，我们去创造一个新的测试集，包括二个测试用例: 一个装载数据和另为存储数据。

使用 CPPUnit

        你能在这里http://cppunit.sourceforge.net/得到最新的CPPUnit 版本, 你能发现所有的库 , 文献, 例子和其它有趣的材料。(我下载了版本为1.8.0 并且这个颁布工作良好)

        在Win32里, 你能在VC++ 之下(6.0 和以后版本)使用CPPUnit , 但是当CPPUnit 使用ANSI C++, 有少量接口时针对其它环境象C++Builder。

        在CPPUnit发布版本里面，所有建造库的步骤和信息，可以在INSTALL-WIN32.txt文件找到,。当所有二进制文件被构建之后, 你就能写你自己的测试集了。

        想在VC中写自己的测试程序，可以按照以下步骤：
        建立一个MFC的对话框（或文档视图结构）
        允许时间类型信息，Alt+F7 --> C/C++ --> C++ language --> Enable RTTI
        把Cppunit\inlude放到include目录：Tools - Options - Directories - Include.
        用cppunitd.lib (静态连接) 或者cppunitd_dll.lib (动态链接)，testrunnerd.lib来链接你的程序。
        如果动态链接，就要把testrunnerd.dll 拷到应用程序目录来运行。

        Ok,看一下测试用例的类的定义吧。

#if !defined(DISKDATA_TESTCASE_H_INCLUDED)
#define DISKDATA_TESTCASE_H_INCLUDED

#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000

#include <cppunit/TestCase.h>
#include <cppunit/extensions/HelperMacros.h>

#include "DiskData.h"

class DiskDataTestCase : public CppUnit::TestCase
{
  CPPUNIT_TEST_SUITE(DiskDataTestCase);
      CPPUNIT_TEST(loadTest);
      CPPUNIT_TEST(storeTest);
  CPPUNIT_TEST_SUITE_END();

public:
    void setUp();
    void tearDown();

protected:
    void loadTest();
    void storeTest();

private:
    DiskData *fixture;   
};

#endif
  首先, 必须包含TestCase.h和HelperMacros.h. 第一步,我们的从我们的Testcase基类配生的新类。第二，用一些宏使我们的定义的更方便，如 CPPUNIT_TEST_SUITE (开始测试定义), CPPUNIT_TEST (定义一个测试用例) 或 CPPUNIT_TEST_SUITE_END (结束一个测试集).

        我们的类(DiskDataTestCase)有重载了两个方法setUp()和tearDown(). 一个开始，一个结束测试。

        测试过程如下

        启动程序
        点击“Run”
        调用Call setUp()方法: 构建我们的测试对象fixture  
        调用第一个测试方法
        调用tearDown() 方法，清除对象
        调用Call setUp()方法: 构建我们的测试对象fixture  
        调用第一个测试方法
        调用Call setUp()方法: 构建我们的测试对象fixture
... 
        就像下面的形式：

#include "DiskDataTestCase.h"

CPPUNIT_TEST_SUITE_REGISTRATION(DiskDataTestCase);

void DiskDataTestCase::setUp()
{
    fixture = new DiskData();
}

void DiskDataTestCase::tearDown()
{
    delete fixture;
    fixture = NULL;
}

void DiskDataTestCase::loadTest()
{
    // our load test logic
}

void DiskDataTestCase::storeTest()
{
    // our store test logic
}

编写测试用例
        一旦我们知道我们要测什么之后，我们就可以写测试用例了。我们能够执行所有的我们需要的操作：使用普通库函数，第三方库，win32api库函数，或简单使用c++内部操作

        有时候，我们需要调用外部辅助文件或者数据库，比较外部文件和内部数据是否一致。
        每发现一个错误时9比如发现内部数据和外部数据不同我们就创建一个异常，使用 CPPUNIT_FAIL(message) 来显示异常信息。

        检测一个条件就使用
        CPPUNIT_ASSERT(condition):如果为false就抛出异常
        CPPUNIT_ASSERT_MESSAGE(message, condition): 如果为false就抛出制定的信息。
        CPPUNIT_ASSERT_EQUAL(expected,current): 检测期望值 
        CPPUNIT_ASSERT_EQUAL_MESSAGE(message,expected,current): 当比较值不相等时候抛出的制定的信息。
        CPPUNIT_ASSERT_DOUBLES_EQUAL(expected,current,delta): 带精度的比较 
        下面是测试loadTest的例子，
//
// These are correct values stored in auxiliar file
//
#define AUX_FILENAME    "ok_data.dat"
#define FILE_NUMBER    19
#define FILE_STRING    "this is correct text stored in auxiliar file"

void DiskDataTestCase::loadTest()
{
    // convert from relative to absolute path
    TCHAR    absoluteFilename[MAX_PATH];
    DWORD    size = MAX_PATH;

    strcpy(absoluteFilename, AUX_FILENAME);
    CPPUNIT_ASSERT( RelativeToAbsolutePath(absoluteFilename, &size) );

    // executes action
    CPPUNIT_ASSERT( fixture->load(absoluteFilename) );

    // ...and check results with assertions
    LPDATA    loadedData = fixture->getData();

    CPPUNIT_ASSERT(loadedData != NULL);
    CPPUNIT_ASSERT_EQUAL(FILE_NUMBER, loadedData->number);
    CPPUNIT_ASSERT( 0 == strcmp(FILE_STRING,
            fixture->getData()->string) );
}

   在这个case我们得到四个可能的错误：
load method's return value
getData method's return value
number structure member's value
string structure member's value

        第二个用例也是相似的。但是困难点，我们需要使用已知的数据来填充fixture，把它存在磁盘临时文件里，然后打开两个文件（新的和辅助文件），读并比较内容，两者如一致就正确

void DiskDataTestCase::storeTest()
{
    DATA    d;
    DWORD      tmpSize, auxSize;
    BYTE     *tmpBuff, *auxBuff;
    TCHAR    absoluteFilename[MAX_PATH];
    DWORD    size = MAX_PATH;

    // configures structure with known data
    d.number = FILE_NUMBER;
    strcpy(d.string, FILE_STRING);

    // convert from relative to absolute path

    strcpy(absoluteFilename, AUX_FILENAME);
    CPPUNIT_ASSERT( RelativeToAbsolutePath(absoluteFilename, &size) );

    // executes action
    fixture->setData(&d);
    CPPUNIT_ASSERT( fixture->store("data.tmp") );

    // Read both files contents and check results
    // ReadAllFileInMemory is an auxiliar function which allocates a buffer
    // and save all file content inside it. Caller should release the buffer.
    tmpSize = ReadAllFileInMemory("data.tmp", tmpBuff);
    auxSize = ReadAllFileInMemory(absoluteFilename, auxBuff);

    // files must exist
    CPPUNIT_ASSERT_MESSAGE("New file doesn't exists?", tmpSize > 0);
    CPPUNIT_ASSERT_MESSAGE("Aux file doesn't exists?", auxSize > 0);

    // sizes must be valid
    CPPUNIT_ASSERT(tmpSize != 0xFFFFFFFF);
    CPPUNIT_ASSERT(auxSize != 0xFFFFFFFF);

    // buffers must be valid
    CPPUNIT_ASSERT(tmpBuff != NULL);
    CPPUNIT_ASSERT(auxBuff != NULL);

    // both file's sizes must be the same as DATA's size
    CPPUNIT_ASSERT_EQUAL((DWORD) sizeof(DATA), tmpSize);
    CPPUNIT_ASSERT_EQUAL(auxSize, tmpSize);

    // both files content must be the same
    CPPUNIT_ASSERT( 0 == memcmp(tmpBuff, auxBuff, sizeof(DATA)) );

    delete [] tmpBuff;
    delete [] auxBuff;

    ::DeleteFile("data.tmp");
}

调用用户接口
        最后，我们看看用一个mfc 对话框（TestRunner.dll）用来说明。

        我们需要在我们的初始化函数中做如下初始化

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

BOOL CMy_TestsApp::InitInstance()
{
    ....

    // declare a test runner, fill it with our registered tests and run them
    CppUnit::MfcUi::TestRunner runner;

    runner.addTest( CppUnit::TestFactoryRegistry::getRegistry().makeTest() );

    runner.run();   

    return TRUE;
}
        只要定义一个test的实例，然后注册所有用例，在跑case。