华为软件编程规范学习(七)--可测性_华为 软件测试规范-程序员宅基地

技术标签： C/C++  编程规范  

华为软件编程规范学习(七)--可测性

转自：http://blog.csdn.net/ce123_zhouwei/article/details/8887863

7-1：在同一项目组或产品组内，要有一套统一的为集成测试与系统联调准备的调测开关及相应打印函数，并且要有详细的说明

说明：本规则是针对项目组或产品组的。

7-2：在同一项目组或产品组内，调测打印出的信息串的格式要有统一的形式。信息串中至少要有所在模块名（或源文件名）及行号

说明：统一的调测信息格式便于集成测试。

7-3：编程的同时要为单元测试选择恰当的测试点，并仔细构造测试代码、测试用例，同时给出明确的注释说明。测试代码部分应作为（模块中的）一个子模块，以方便测试代码在模块中的安装与拆卸（通过调测开关）

说明：为单元测试而准备。

7-4：在进行集成测试/系统联调之前，要构造好测试环境、测试项目及测试用例，同时仔细分析并优化测试用例，以提高测试效率

说明：好的测试用例应尽可能模拟出程序所遇到的边界值、各种复杂环境及一些极端情况等。

7-5：使用断言来发现软件问题，提高代码可测性

说明：断言是对某种假设条件进行检查（可理解为若条件成立则无动作，否则应报告），它可以快速发现并定位软件问题，同时对系统错误进行自动报警。断言可以对在系统中隐藏很深，用其它手段极难发现的问题进行定位，从而缩短软件问题定位时间，提高系统的可测性。实际应用时，可根据具体情况灵活地设计断言。

示例：下面是C语言中的一个断言，用宏来设计的。（其中NULL为0L）

[plain]  view plain  copy
  1. #ifdef _EXAM_ASSERT_TEST_  // 若使用断言测试  
  2. void exam_assert(char * file_name, unsigned int line_no )  
  3. {  
  4.    printf( "\n[EXAM]Assert failed: %s, line %u\n",  
  5.            file_name, line_no );  
  6.     abort();  
  7. }  
  8. #define EXAM_ASSERT( condition )  
  9.     if(condition) // 若条件成立，则无动作  
  10.        NULL;  
  11.    else  // 否则报告  
  12.        exam_assert( __FILE__, __LINE__ )   
  13. #else  // 若不使用断言测试  
  14. #define EXAM_ASSERT(condition)  NULL  
  15. #endif  /* end of ASSERT */  

7-6：用断言来检查程序正常运行时不应发生但在调测时有可能发生的非法情况

7-7：不能用断言来检查最终产品肯定会出现且必须处理的错误情况

说明：断言是用来处理不应该发生的错误情况的，对于可能会发生的且必须处理的情况要写防错程序，而不是断言。如某模块收到其它模块或链路上的消息后，要对消息的合理性进行检查，此过程为正常的错误检查，不能用断言来实现。

7-8：对较复杂的断言加上明确的注释

说明：为复杂的断言加注释，可澄清断言含义并减少不必要的误用。

7-9：用断言确认函数的参数

示例：假设某函数参数中有一个指针，那么使用指针前可对它检查，如下。

[plain]  view plain  copy
  1. int exam_fun(unsigned char *str )  
  2. {  
  3.    EXAM_ASSERT( str != NULL );  // 用断言检查“假设指针不为空”这个条件  
  4.    ... //other program code  
  5. }  

7-10：用断言保证没有定义的特性或功能不被使用

示例：假设某通信模块在设计时，准备提供“无连接”和“连接”这两种业务。但当前的版本中仅实现了“无连接”业务，且在此版本的正式发行版中，用户（上层模块）不应产生“连接”业务的请求，那么在测试时可用断言检查用户是否使用“连接”业务。如下。

[plain]  view plain  copy
  1. #define EXAM_CONNECTIONLESS 0 // 无连接业务  
  2. #define EXAM_CONNECTION     1 // 连接业务  
  3. int msg_process(EXAM_MESSAGE *msg )  
  4. {  
  5.    unsigned char service; /* message service class */  
  6.    EXAM_ASSERT( msg != NULL );  
  7.    service = get_msg_service_class( msg );  
  8.    EXAM_ASSERT( service != EXAM_CONNECTION ); // 假设不使用连接业务  
  9.    ...  //other program code  
  10. }  

7-11：用断言对程序开发环境（OS/Compiler/Hardware）的假设进行检查

说明：程序运行时所需的软硬件环境及配置要求，不能用断言来检查，而必须由一段专门代码处理。用断言仅可对程序开发环境中的假设及所配置的某版本软硬件是否具有某种功能的假设进行检查。如某网卡是否在系统运行环境中配置了，应由程序中正式代码来检查；而此网卡是否具有某设想的功能，则可由断言来检查。

对编译器提供的功能及特性假设可用断言检查，原因是软件最终产品（即运行代码或机器码）与编译器已没有任何直接关系，即软件运行过程中（注意不是编译过程中）不会也不应该对编译器的功能提出任何需求。

示例：用断言检查编译器的int型数据占用的内存空间是否为2，如下。

[plain]  view plain  copy
  1. EXAM_ASSERT( sizeof(int ) == 2 );  

7-12：正式软件产品中应把断言及其它调测代码去掉（即把有关的调测开关关掉）

说明：加快软件运行速度。

7-13：在软件系统中设置与取消有关测试手段，不能对软件实现的功能等产生影响

说明：即有测试代码的软件和关掉测试代码的软件，在功能行为上应一致。

7-14：用调测开关来切换软件的DEBUG版和正式版，而不要同时存在正式版本和DEBUG版本的不同源文件，以减少维护的难度

7-15：软件的DEBUG版本和发行版本应该统一维护，不允许分家，并且要时刻注意保证两个版本在实现功能上的一致性

其他

7-1：在编写代码之前，应预先设计好程序调试与测试的方法和手段，并设计好各种调测开关及相应测试代码如打印函数等

说明：程序的调试与测试是软件生存周期中很重要的一个阶段，如何对软件进行较全面、高率的测试并尽可能地找出软件中的错误就成为很关键的问题。因此在编写源代码之前，除了要有一套比较完善的测试计划外，还应设计出一系列代码测试手段，为单元测试、集成测试及系统联调提供方便。

7-2：调测开关应分为不同级别和类型

说明：调测开关的设置及分类应从以下几方面考虑：针对模块或系统某部分代码的调测；针对模块或系统某功能的调测；出于某种其它目的，如对性能、容量等的测试。这样做便于软件功能的调测，并且便于模块的单元测试、系统联调等。

7-3：编写防错程序，然后在处理错误之后可用断言宣布发生错误

示例：假如某模块收到通信链路上的消息，则应对消息的合法性进行检查，若消息类别不是通信协议中规定的，则应进行出错处理，之后可用断言报告，如下例。

[plain]  view plain  copy
  1. #ifdef _EXAM_ASSERT_TEST_ // 若使用断言测试  
  2. /* Notice: thisfunction does not call 'abort' to exit program */  
  3. void assert_report(char * file_name, unsigned int line_no )  
  4. {  
  5.    printf( "\n[EXAM]Error Report: %s, line %u\n",  
  6.            file_name, line_no );  
  7. }  
  8. #define ASSERT_REPORT( condition )  
  9.     if( condition ) // 若条件成立，则无动作  
  10.        NULL;  
  11.    else // 否则报告  
  12.        assert_report ( __FILE__, __LINE__ )  
  13. #else // 若不使用断言测试  
  14. #define ASSERT_REPORT( condition )  NULL  
  15. #endif /* end ofASSERT */  
  16. int msg_handle(unsigned char msg_name, unsigned char * msg )  
  17. {  
  18.    switch( msg_name )  
  19.     {  
  20.        case MSG_ONE:  
  21.            ... // 消息MSG_ONE处理  
  22.            return MSG_HANDLE_SUCCESS;  
  23.            ... // 其它合法消息处理  
  24.        default:  
  25.            ... // 消息出错处理  
  26.            ASSERT_REPORT( FALSE );  // “合法”消息不成立，报告  
  27.            return MSG_HANDLE_ERROR;  
  28.     }  
  29. }  
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_35061586/article/details/79077428

智能推荐

远程桌面服务器连接失败,Windows服务器远程桌面连接失败是什么原因-程序员宅基地

文章浏览阅读6.1k次。1、先通过显示器直接连接的方式连接到那台连接出错的服务器上。登陆以后，在桌面上的此电脑图标上面点右键，选择属性。2、然后在属性页面中我们可以看到对应的系统版本是Windows Server 2016。CPU是intel xeon型号，内存是16g。这个时候我们点击它左上角的远程设置。3、在远程设置界面，我们可以看到，它默认的设置是允许远程到这台服务器上，但是它下面勾选了”仅允许运行使用网络级别身份..._远程桌面服务无法加入服务器 win-th0hfpjn9vr 上的连接代理。 错误: 当前异步消息

ApacheCN 翻译活动进度公告 2019.6.15-程序员宅基地

文章浏览阅读109次。Special Sponsors我们组织了一个开源互助平台，方便开源组织和大 V 互相认识，互相帮助，整合资源。请回复这个帖子并注明组织/个人信息来申请加入。请回复这个帖子来推荐希望翻译的内容。如果大家遇到了做得不错的教程或翻译项目，也可以推荐给我们。我们会联系项目的维护者，一起把...

Python培训课程深圳，群年轻人正在追捧Python-程序员宅基地

文章浏览阅读182次。记者 | 伍洋宇 袁伟腾编辑 | 文姝琪1李楠打算年底换份新工作，Python方向的、纯软件岗位，发挥空间更大的全栈开发工程师就很不错，目标月薪一万二。这使得他在今年下半年开始系统学习Python。因为本科是计算机专业，期间也自学过Python这门语言，李楠选择了继续自学。学Python真的有用吗？“当然有用啦，没用谁去学它啊。”今年24岁、刚刚毕业一年的李楠这么说。目前他在一家智能硬件公司做嵌入式开发软件工程师，月薪一万，工作是“往硬件里面写软件”，他觉得太枯燥了。“代码都是写好的，基..

Ubuntu下安装R，升级R版本，安装Rstudio，安装Rstudio Server以及安装Shiny Server_marutter-ubuntu-rrutter-focal.list-程序员宅基地

文章浏览阅读2.9k次。一、安装R只需要一步命令：sudo apt-get install r-base二、升级R版本第一步给Ubuntu指定PPA：sudo add-apt-repository ppa:marutter/rrutter第二步：sudo apt-get update第三步：sudo apt-get upgrade三、安装Rstudio直接去Rstudio官网下载最新版的Rst..._marutter-ubuntu-rrutter-focal.list

Redis5.0集群搭建（Redis Cluster）_rediscluster搭建 5.0-程序员宅基地

文章浏览阅读9.1k次。Redis5.0集群搭建RedisCluster_rediscluster搭建 5.0

题目-java基础_面向过程的程序设计是把计算机程序视为一系列的命令集合-程序员宅基地

文章浏览阅读405次。多线程和单线程线程不是越多越好，假如你的业务逻辑全部是计算型的（CPU密集型）,不涉及到IO，并且只有一个核心。那肯定一个线程最好，多一个线程就多一点线程切换的计算，CPU不能完完全全的把计算能力放在业务计算上面，线程越多就会造成CPU利用率（用在业务计算的时间/总的时间）下降。但是在WEB场景下，业务并不是CPU密集型任务，而是IO密集型的任务，一个线程是不合适，如果一个线程在等待数据时，把CPU的计算能力交给其他线程，这样也能充分的利用CPU资源。但是线程数量也要有个限度，一般线程数有一个公式：最佳启_面向过程的程序设计是把计算机程序视为一系列的命令集合

随便推点

储能8串电池用140W DCDC电路2 USB_A 2个 TYPE-C 2A2C_pl56002-程序员宅基地

文章浏览阅读78次。储能8串电池，输出是2个C口，2个USBA口，功率是C1:140W,C2:100W,A1:18W,A2:18W.A1,A2不降功率，使用IP2736,IP2723T,IP2163,_pl56002

python3.8.1手机版下载-Python官方下载|Python最新版 V3.8.1 -推背图下载站-程序员宅基地

文章浏览阅读2k次。Python最新版是一款功能强大脚本编程软件。Python最新版它可以帮助编程人员更加便捷的进行代码编写，适合完成各种高层任务，兼容所有的操作系统中使用，因为它的便捷性，在程序员中得到广泛的应用，新入门的编程学习者可以使用它快速学习，欢迎前来下载!功能特点1、简单易学Python极其容易上手，因为Python有极其简单的说明文档 。2、免费开源Python是FLOSS(自由/开放源码软件)之一。3..._手机版python官网下载

Unity3D学习之（坦克大战解析）-程序员宅基地

文章浏览阅读3.9k次。欢迎大家光临我的博客！对坦克大战项目的解析：一、游戏模块主要是：注册模块、登录模块、我方模块、和敌方模块。①注册模块：可以跳转到登录界面！②登录模块：可以跳转到游戏界面！③我方模块：可以前后左右移动，可以发射子弹，可以死亡销毁。④敌方模块：可以可以发射子弹，追踪我方的位置，也可以随机出现，可以死亡销毁。 二、所用到的技术①键盘事件 //敌我双方通过键盘上下左右键的移动②位移 ...

【linux】进程和线程的几种状态及状态切换_linux线程状态-程序员宅基地

文章浏览阅读3.6k次，点赞46次，收藏54次。进程和线程的状态_linux线程状态

Java/Mysql数据库+SSM+学生信息管理系统 11578（免费领源码）计算机毕业设计项目推荐上万套实战教程JAVA、PHP，node.js，C++、python、大屏可视化等-程序员宅基地

文章浏览阅读1.1k次，点赞22次，收藏20次。免费领取项目源码，请关注●点赞●收藏并私信博主，谢谢~本系统以实际运用为开发背景，通过系统管理员可以对所有的学生和教师等人员以及学生相关联的一些学生管理、分配任务、完成任务、打卡签到、师生交流等数据信息进行统一的管理，方便资料的保留。教师和学生可以通过注册，然后登录到系统当中，对分配任务、完成任务、打卡签到以及师生交流这些信息进行查询管理。总的来说，系统的前台是通过Java页面展示，后台使用SSM这个框架，数据库采用目前流行的开源关系型数据库MYSQL。

如何在群辉NAS系统下安装cpolar套件,并使用cpolar内网穿透？_在群晖nas安装cpolar套件-程序员宅基地

文章浏览阅读1.2k次，点赞39次，收藏34次。群晖作为大容量存储系统，既可以作为个人的私有存储设备，也可以放在小型企业中作为数据中心使用。其强大的数据存储和管理功能，让其还能够胜任更多任务。但由于群晖的应用场景所限，这些功能通常只能在局域网内实现，想要让群晖NAS存储的数据能在公网访问到，我们可以借助cpolar的辅助，轻松实现在公共互联网访问内网群晖NAS上的数据。在这之前，我们还是需要了解下cpolar的基本操作方式。_在群晖nas安装cpolar套件

推荐文章

热门文章

相关标签