CppUnit与单元测试

CppUnit与单元测试

许式伟
2004年6月

cppunit是什么？

cppunit是一个测试程序框架。cpp指的是该测试程序用c++写的，unit取“单元”测试的意思。
最初出现该测试框架是java版本的，名为junit。

为什么要用cppunit？

cppunit规范了单元测试的一些思想。这些思想朴素但非常重要。cppunit的测试观念主要有：

• 测试的结果是程序直接监测的，而不是“通过人眼对屏幕上的输出结果的观测”。
  因此，cppunit并不推荐屏幕输出，或者写可视化的测试单元。
   
• 测试的过程是自动化的，不需要人工的干预。
  cppunit推荐用大量典型测试数据进行回归的方式。
   
• 测试案例是安全可控的。
  如果一个测试案例错误或者发生了异常，那么应该记录这个错误，并且去执行下一个案例，而不应该停下来。cppunit测试框架保证了这一点。
   
• 单元测试是频繁发生的，每天都进行。
  由于测试案例的自动化，故此，在你的模块发生了重要改变时（特别是设计上的重大变化/重构时），你都应该马上运行一遍所有的测试程序，以确认你的代码没有引入预期（或曾经出现过）的bug。你可以在准备吃饭的时候，启动单元测试程序进行回归。
   
• 单元测试的目的是产生高质量的单元（模块）。从而减少系统集成（包括系统集成测试）的代价。
  

cppunit使用样例

class  TestBSTR :  public  TestCase
{
public :
    CPPUNIT_TEST_SUITE(TestBSTR);
        CPPUNIT_TEST(test_allocString);
        CPPUNIT_TEST(test_allocStringWithLen);
        CPPUNIT_TEST(test_allocChinese);
    CPPUNIT_TEST_SUITE_END();

public :
     void  test_allocString()
    {
        BSTR p;
        WCHAR szHello[]  =  L " Hello, world! " ;

        p  =  SysAllocString(szHello);
        CPPUNIT_ASSERT( wcscmp(p, szHello)  ==   0  );
        CPPUNIT_ASSERT( SysStringLen(p)  ==  wcslen(szHello) );

        SysReAllocString( & p, szHello);
        CPPUNIT_ASSERT( wcscmp(p, szHello)  ==   0  );

        SysFreeString(p);
    }

     void  test_allocStringWithLen()
    {
        BSTR p;

        p  =  SysAllocStringLen(L " ABCDEFGH " ,  4 );
        CPPUNIT_ASSERT( wcscmp(p, L " ABCD " )  ==   0  );

        SysReAllocStringLen( & p, L " XYZ " ,  2 );
        CPPUNIT_ASSERT( wcscmp(p, L " XY " )  ==   0  );
        CPPUNIT_ASSERT( SysStringLen(p)  ==   2  );

        SysFreeString(p);

        SysAllocString(L " Memory leak checker " );
    }

     void  test_allocChinese()
    {
        BSTR p  =  SysAllocString(L " 中文! " );
        CPPUNIT_ASSERT( SysStringLen(p)  ==   3  );
        CPPUNIT_ASSERT( wcscmp(p, L " 中文! " )  ==   0  );
        SysFreeString(p);
    }
};

CPPUNIT_TEST_SUITE_REGISTRATION(TestBSTR);
//  使用CPPUNIT_TEST_SUITE_REGISTRATION辅助宏注册测试类 　

int  main()
{
    TestApp app;
     return   0 ;
}

这里TestApp是我自己写的辅助类。CppUnit标准的main函数大概如下：

int  main()
{
    CPPUNIT_NS::Test  * suite  =  CPPUNIT_NS::TestFactoryRegistry::getRegistry().makeTest();
    CPPUNIT_NS::TextUi::TestRunner runner;
    runner.addTest( suite );
    
    CPPUNIT_NS::Outputter *  outputter;
    outputter  =   new  CPPUNIT_NS::CompilerOutputter( & runner.result(), std::cerr);
    runner.setOutputter(outputter);
    
     return  runner.run();
}

 

补充

如果你已经使用CppUnit，并在使用中遇到问题，那么你的体验有可能与我类似。这方面的内容，参考《CppUnit的缺陷与改进》。