cppunit使用详解

第一步：如何安装 （我的运行环境： fc7 Linux, gcc4）

    cppunit 的安装是相当标准的linux的安装过程

    a. 下载cppunit的源文件

    b. 解压缩

    c. 编译安装程序

      $./configure --prefix=/data/soft/cppunit-1.12

      $make

      $make install

    这里 -prefix=/data/soft/cppunit-1.12 的意思是把安装的根目录设置为 /data/soft/cppunit-1.12

    安装完成以后头文件存储在/data/soft/cppunit-1.12/include，库文件存储在/data/soft/cppunit-1.12/lib。

    因为不是安装在默认的位置所以在编译和连结的时候要指定路径。

    例如：g++ -g -L/data/soft/cppunit-1.12/lib -lcppunit -ldl -I/data/soft/cppunit-1.12/include Main.C

注意这里的几个 -l选项， 尤其是 -ldl 选项。

    第二步： 下面我介绍一下个人认为比较实用的测试程序的结构。

    这个测试类从CppUnit::TestFixture派生，并且由下面的部分组成：

    a. setUp() 方法

       在这个方法里实现一些准备工作，例如生成一些被测类的实列

       setUp(){

             m_vertex = new Vertex( 'V' );

       }

    b. tearDown() 方法

       在这个方法里实现扫尾的工作，例如释放内存

       tearDown(){

          //一些在setUp方法中申请的内存的清理工作

          delete m_vertex;

       }

    c. 测试方法的方法

       例如，在被测类里有一个方法叫做：bool operator==(MyComplex &a), 我们

    要写一个名字叫作test_Equality的方法来测试。

      void GraphTest::testConstructor()

 {

     CPPUNIT_ASSERT( m_vertex->label == 'V' );

     CPPUNIT_ASSERT( m_vertex->wasVisited == true );

     CPPUNIT_ASSERT( m_vertex->isInTreeVerts == true );

 }

    CPPUNIT_ASSERT用来判断里面的表达是是否为真。

    d. 把几个测试方法“打包”为一个suite。

      CppUnit::TestSuite *suite= new CppUnit::TestSuite();

     suite->addTest(new CppUnit::TestCaller<GraphTest> ("testConstructor", &GraphTest::testConstructor));

    测试类就是由这些方法组成。

 e. 运行测试用例

 CppUnit::TextUi::TestRunner runner;

    runner.addTest( suite ); //指定运行TestSuite

 //开始运行, 自动显示测试进度和测试结果

    runner.run( "", true );

下面通过完整的源代码展现cppunit的使用方法。

// file1 : dijkstra.h 该头文件中含有下面代码，现在我们要使用cppunit对构造函数进行测试

#ifndef DIJKSTRA_H

#define DIJKSTRA_H

struct Vertex

{

public:

    char label; // label (e.g. 'A')

    bool wasVisited;

    bool isInTreeVerts;

    

    Vertex( char lab ) // constructor

    {

        label = lab;

    }

}; // end struct Vertex

#endif

// file2 : GraphTest.h

#include "dijkstra.h"

#include "cppunit/TestFixture.h"

class GraphTest : public CppUnit::TestFixture {

protected:

    Vertex * m_vertex;

public:

    GraphTest() {

}

    // 初始化函数

    void setUp ();

    // 清理函数

    void tearDown();

    

    // 测试构造函数的测试函数

    void testConstructor ();

    //还可以添加新的测试函数

};

// file3 : GraphTest.cpp

#include "GraphTest.h"

#include "cppunit/TestAssert.h"

void GraphTest::setUp()

{

    m_vertex = new Vertex( 'V' );

}

void GraphTest::tearDown()

{

    delete m_vertex ;

}

void GraphTest::testConstructor()

{

    CPPUNIT_ASSERT( m_vertex->label == 'V' );

    CPPUNIT_ASSERT( m_vertex->wasVisited == true );

    CPPUNIT_ASSERT( m_vertex->isInTreeVerts == true );

}

// file4: main.cpp

#include "GraphTest.h"

#include "cppunit/ui/text/TestRunner.h"

#include "cppunit/TestCaller.h"

#include "cppunit/TestSuite.h"

int main()

{

    CppUnit::TextUi::TestRunner runner;

    CppUnit::TestSuite *suite= new CppUnit::TestSuite();

    // 添加一个测试用例

    suite->addTest(new CppUnit::TestCaller<GraphTest> ("testConstructor", &GraphTest::testConstructor));

    runner.addTest( suite ); //指定运行TestSuite

 

    //开始运行, 自动显示测试进度和测试结果

    runner.run( "", true ); }

好了。都准备好了，编译：

[root@zieckey cppunit]# g++ GraphTest.cpp main.cpp -lcppunit -I /data/soft/cppunit-1.12/include/ -L /data/soft/cppunit-1.12/lib

/data/soft/cppunit-1.12/lib/libcppunit.so: undefined reference to `dlsym'

/data/soft/cppunit-1.12/lib/libcppunit.so: undefined reference to `dlopen'

/data/soft/cppunit-1.12/lib/libcppunit.so: undefined reference to `dlclose

这个错误是由于没有找到 dlsym 等函数的链接库，制定下他们的连接库：

[root@zieckey cppunit]# g++ GraphTest.cpp main.cpp -lcppunit -I /data/soft/cppunit-1.12/include/ -L /data/soft/cppunit-1.12/lib -ldl

编译成功，运行：

[root@zieckey cppunit]# ./a.out

.F

!!!

Test Results:

Run: 1 Failures: 1 Errors: 0

1) test: testConstructor (F) line: 17 GraphTest.cpp

assertion failed

- Expression: m_vertex->wasVisited == true

<RETURN> to continue

发现一个错误，构造函数没有按照我们想象的对成员变量 wasVisited 初始为 true

从而发现一个错误，修改 Vertex 的构造如下：    

Vertex( char lab ) // constructor

    {

        label = lab;

        wasVisited = true;

        isInTreeVerts = true;

    }

再次编译，运行，通过测试。