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

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