cppunit使用详解

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;
    }

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