随笔-341  评论-2670  文章-0  trackbacks-0
    复杂的东西写多了,如今写点简单的好了。由于功能上的需要,Vczh Library++3.0被我搞得很离谱。为了开发维护的遍历、减少粗心犯下的错误以及增强单元测试、回归测试和测试工具,因此记录下一些开发上的小技巧,以便抛砖引玉,造福他人。欢迎高手来喷,菜鸟膜拜。

    之前的文章讲了指针和内存的一些问题,今天说一下单元测试的问题。如果在团队里面没有对单元测试的框架有要求的话,其实我们可以使用一个最简单的方法来搭建在IDE里面运行的单元测试框架,整个框架只需十几行代码。我们先来考虑一下功能最少的单元测试框架需要完成什么样的内容。首先我们要运行一个一个的测试用例,其次在一个测试用例里面我们要检查一些条件是否成立。举个例子,我们写一个函数将两个字符串连接起来,一般来说要进行下面的测试:
 1 #include "MyUnitTestFramework.h"//等一下我们会展示一下如何用最少的代码完成这个头文件的内容
 2 #include ""
 3 
 4 TEST_CASE(StringConcat)
 5 {
 6   TEST_ASSERT(concat("a""b")=="ab");
 7   TEST_ASSERT(concat("a""")=="a");
 8   TEST_ASSERT(concat("""b")=="b");
 9   TEST_ASSERT(concat("""")=="");
10   .
11 }
12 
13 int wmain()
14 {
15   return 0;
16 }

    如果我们的单元测试框架可以这么写,那显然做起什么事情来都会方便很多,而且不需要向一些其他的测试框架一样注册一大堆东西,或者是写一大堆配置函数。当然这次我们只做功能最少的测试框架,这个框架除了运行测试以外,不会有其他功能,譬如选择哪些测试可以运行啦,还是在出错的时候log一些什么啦之类。之所以要在IDE里面运行,是因为我们如果做到TEST_ASSERT中出现false的话,立刻在该行崩溃,那么IDE就会帮你定位到出错的TEST_ASSERT中去,然后给你显示所有的上下文信息,譬如说callstack啦什么的。友好的工具不用简直对不起自己啊,干吗非得把单元测试做得那么复杂捏,凡是单元测试,总是要全部运行通过才能提交代码的。

    那么我们来看看上面的单元测试的代码。首先写了TEST_CASE的那个地方,大括号里面的代码会自动运行。其次TEST_ASSERT会在表达式是false的时候崩溃。先从简单的入手吧。如何制造崩溃呢?最简单的办法就是抛异常:
1 #define TEST_ASSERT(e) do(if(!(e))throw "今晚没饭吃。";}while(0)

    这里面有两个要注意的地方。首先e要加上小括号,不然取反操作符就有可能做出错误的行为。譬如说当e是a+b==c的时候,加了小括号就变成if(!(a+b==c))...,没有加小括号就变成if(!a+b==c)...,意思就完全变了。第二个主意的地方是我使用do{...}while(0)把语句包围起来了。这样做的好处是可以在任何时候TEST_ASSERT(e)都像一个语句。譬如我们可能这么写:
1 if(a)
2   TEST_ASSERT(x1);
3 else if(b)
4 {
5   TEST_ASSERT(x2);
6   TEST_ASSERT(x3);
7 }

    如果没有do{...}while(0)包围起来,这个else就会被绑定到宏里面的那个if,你的代码就被偷偷改掉了。

    那么现在剩下TEST_CASE(x){y}了。什么东西可以在main函数外面自动运行呢?这个我想熟悉C++的人都会知道,就是全局变量的构造函数啦。所以TEST_CASE(x){y}那个大括号里面的y只能在全局变量的构造函数里面调用。但是我们知道写一个类的时候,构造函数的大括号写完了,后面还有类的大括号,全局变量的名称,和最终的一个分号。为了把这些去掉,那么显然{y}应该属于一个普通的函数。那么全局变量如何能够使用这个函数呢?方法很简单,把函数前置声明一下就行了:
 1 #define TEST_CASE(NAME)                                            \
 2         extern void TESTCASE_##NAME();                             \
 3         namespace vl_unittest_executors                            \
 4         {                                                          \
 5             class TESTCASE_RUNNER_##NAME                           \
 6             {                                                      \
 7             public:                                                \
 8                 TESTCASE_RUNNER_##NAME()                           \
 9                 {                                                  \
10                     TESTCASE_##NAME();                             \
11                 }                                                  \
12             } TESTCASE_RUNNER_##NAME##_INSTANCE;                   \
13         }                                                          \
14         void TESTCASE_##NAME()

    那我们来看看TEST_CASE(x){y}究竟会被翻译成什么代码:
 1 extern void TESTCASE_x();
 2 namespace vl_unittest_executors
 3 {
 4     class TESTCASE_RUNNER_x
 5     {
 6     public:
 7         TESTCASE_RUNNER_x()
 8         {
 9             TESTCASE_x();
10         }
11     } TESTCASE_RUNNER_x_INSTANCE;
12 }
13 void TESTCASE_x(){y}

    到了这里是不是很清楚了捏,首先在main函数运行之前TESTCASE_RUNNER_x_INSTANCE变量会初始化,然后调用TESTCASE_RUNNER_x的构造函数,最后运行函数TESTCASE_x,该函数的内容显然就是{y}了。这里还能学到宏是如何连接两个名字成为一个名字,和如何写多行的宏的。

    于是MyUnittestFramework.h就包含这两个宏,其他啥都没有,是不是很方便呢?打开Visual C++,建立一个工程,引用这个头文件,然后写你的单元测试,最后F5就运行了,多方便啊,啊哈哈哈。

    这里需要注意一点,那些单元测试的顺序是不受到保证的,特别是你使用了多个cpp文件的情况下。于是你在使用这个测试框架的同时,会被迫保证执行一次单元测试不会对你的全局状态带来什么副作用,以便两个测试用例交换顺序执行的时候仍然能稳定地产生相同的结果。这对你写单元测试有帮助,而且为了让你的代码能够被这么测试,你的代码也会写的有条理,不会依赖全局状态,真是一举两得也。而且说不定单元测试用例比你的全局变量的初始化还先执行呢,因此为了使用这个测试框架,你将会不得不把你的全局变量隐藏在一个cpp里面,而暴露出随时可以被调用的一组函数出来。这样也可以让你的代码在使用全局状态的时候更加安全。

    今天就讲到这里了。下一篇要写什么我还没想好,到时候再说吧。
posted on 2010-06-27 04:19 陈梓瀚(vczh) 阅读(10053) 评论(16)  编辑 收藏 引用 所属分类: C++实用技巧

评论:
# re: C++实用技巧(四) 2010-06-27 04:29 | chaogu
Think in C++(第二本)有一章是讲防御性编程的。比这个详细,主要vc这篇没有讲到__FILE__和__LINE__宏,这点希望vc补充。  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-27 04:33 | 陈梓瀚(vczh)
@chaogu
IDE会告诉你位置的,我文章里面有说这个框架只能在IDE里面用。  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-27 04:33 | 溪流
撒花没了  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-27 07:00 | 王广
泪奔,来晚了,苍天啊,我就晚来一会,沙发没了  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-27 08:18 | DJ
这个技巧的确有用,之前听说过单元测试但是一直不知道在c++里面怎么搞,受教了.  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-28 08:32 | flyinghearts

觉得没必要写TEST_ASSERT宏,可以直接用assert宏。
一定要用异常的话,可以用内联函数。
inline void TEST_ASSERT(bool e) { if (!e) throw "今晚没饭吃。"; }



将TESTCASE_##NAME()放在名字空间vl_unittest_executors中会更好。

#define execute_code(x) \
namespace Test_unit{ \
static void x##_func(); \
struct Test_##x{ \
Test_##x() { x##_func(); } \
} x##_object; \
} \
void Test_unit::x##_func()

或者使用函数指针:

namespace Test_unit {
struct Test{
Test(void func()) { func();}
};
}

#define execute_code(x) \
namespace Test_unit { \
static void x##_func(); \
Test_unit::Test x##_object(x##_func); \
} \
void Test_unit::x##_func()
  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-28 19:15 | 陈梓瀚(vczh)
@flyinghearts
TESTCASE_##NAME()放进namespace你就没办法避免函数最后还有一个大括号从而打破了代码的美观,你应该选择用一个更大的namespace来包含他们。静态函数是完全等价的另一个选择。

assert宏不能用,因为即使他在VC++下运行,也会弹个框直接退出,而不是停止在发生错误的地方。所以要自己throw。  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-30 07:48 | flyinghearts
@陈梓瀚(vczh)
“TESTCASE_##NAME()放进namespace你就没办法避免函数最后还有一个大括号从而打破了代码的美观,” ??
不会有这个问题呀。所有测试代码的变量名都放在同一个名字空间和只用static相比,各有利弊吧。尽管在C++中推荐使用匿名名字空间替代static,但在这个宏替换中,无法使用匿名名字空间(因为函数不能在外部定义)。

另外,也可用__COUNTER__(如果编译器支持的话)或__LINE__生成唯一的变量名。
  回复  更多评论
  
# re: C++实用技巧(四) 2010-06-30 10:02 | 陈梓瀚(vczh)
@flyinghearts
当然无论如何,满足语法形式
TEST_CASE(X){y}
才是最重要的。而且在里面定义的那么破的函数名你要是真的在你的代码中使用了……那还真是你的错啊……当然,你愿意的话可以把所有的TEST_CASE都放在一个你自己的命名空间里面,于是就避免了这个问题。TEST_CASE也不一定非得放在最外面的。所以就不用搞那么复杂啦。  回复  更多评论
  
# re: C++实用技巧(四) 2010-07-01 00:43 |
boost的单元测试已经很好了,cppUnit也不错,有些东西真的没必要自己写......  回复  更多评论
  
# re: C++实用技巧(四) 2010-07-01 01:06 | 陈梓瀚(vczh)
@酿
不写你人怎么进步呢?我又不是写来卖,我是写来爽的。学习显然是十分重要的。话说回来,只要你有IDE,那我的这套绝对是deploy代价最小,几秒钟就可以部署完的架构,我才不需要那么多功能呢。  回复  更多评论
  
# re: C++实用技巧(四) 2010-07-01 01:37 | chaogu
确实简单就好,如果没有需要那么多功能情愿自己写个简单的。如果需要很多功能,自己写个简单的了解一下机制也好。  回复  更多评论
  
# re: C++实用技巧(四) 2010-08-05 20:56 | 溪流
今天再来复习一遍,路过  回复  更多评论
  
# re: C++实用技巧(四) 2010-08-07 22:23 | 溪流
想到一个想差一点点的变形:
#define TEST_CASE(name) \
class TestCase_##name \
{ \
public: \
TestCase_##name(); \
} TestCase_##name##_obj; \
TestCase_##name::TestCase_##name()

也就是省去了构造函数里调用的那个函数,不知道有什么问题没,请lz鉴定下^_^  回复  更多评论
  
# re: C++实用技巧(四) 2010-08-08 03:01 | 陈梓瀚(vczh)
@溪流
没有问题,我那么做是为了将这个类放进vl_...的命名空间里,所以才写了一个中间函数的。  回复  更多评论
  
# re: C++实用技巧(四) 2010-08-08 06:40 | 溪流
@陈梓瀚(vczh)
好的。了解了。谢谢~。  回复  更多评论
  

只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理