一 使用
现在要给它写一个unittest ,你只要做如下工作就可以了:
- 包含头文件: #include "FAssert.h"
- 定义一个测试类,在这个类中使用下列宏来申明test case:
DECLARE_AS_TESTER //申明一个类为tester,需要放在开头[必有]
DECLARE_SETUP //申明一个setup方法[可选]
DECLARE_TEARDOWN //申明一个teardown方法用于清理工作[可选]
DECLARE_TEST(testName) //申明一个test[至少有一个,否则没意义]
3. 实现定义的setup,teardown,和test方法;
4. 调用宏CALL_TEST注册这个unit test:
5. 在主程序中定义一个TestMain,然后调用它的run方法:
using namespace FTest;
TestMain myTest(std::cout);
myTest.run();
对IntWraper的完整的test 代码如下:
运行后你会得到输出结果:
从这个结果你可以看到一共运行了多少个test,成功多少,失败多少,如果失败了,还会给出失败的具体位置.
二 框架
下面这个结构图是从xunit的结构图演变而来的,只不过在这里的testcase是由一系列的IFuncObject组成。对上面给出的例子来 说,setup,teardown,testValue和testAdd都对应一个IFuncObject.这些IFuncObject只是对保存了 setup,teardown,和test函数这些成员函数指针而已。在TestCase的run方法被调用的时候,按照下列顺序调用这些 IFuncObject的Do方法:
setup
test1
...
teardown
最后在内存中会形成如下图所示的一棵树。
这棵树有点特殊,因为它只有三层,最顶层的是一个suite,第二层是一些testcase,它们与程序员写的tester是一一对应的。最底层的是一些 IFuncObject对象,它们对应与tester中的setup,teardown和具体的测试函数。由于对IFuncObject应用了 NullObject模式,所以无论是否定义setup和teardown,每一个testcase,都有一个setup和一个teardown的 IFuncObject。
调用的过程基本上是一个广度优先的过程。
三.实现
实现其实是很简单地,这里只说一下注册原理
3.1 注册
注册是通过TestObject来完成的,TestObject的申明如下:
它从IFuncObject继承下来的,接收两个模板参数,一个是tester,另一个是一个成员函数指针。一句
DECLARE_TEST(testValue)
会定义一个TestObject对象,这样在tester被创建的时候,就会自动将这个函数指针注册到tester的对应的TestCase之中。
3.2 跟踪测试用例
本来是想用异常来跟踪测试用例的运行状态的,可是发现这样就变得复杂啦。所以这个实现没有用,用了最简单地方式,调用类的全局函数来实现。
3.3 源码
源码只包含两个头文件FTest.h和FAssert.h