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

技术标签： 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
 #ifdef _EXAM_ASSERT_TEST_  // 若使用断言测试  
 void exam_assert(char * file_name, unsigned int line_no )  
 {  
    printf( "\n[EXAM]Assert failed: %s, line %u\n",  
            file_name, line_no );  
     abort();  
 }  
 #define EXAM_ASSERT( condition )  
     if(condition) // 若条件成立，则无动作  
        NULL;  
    else  // 否则报告  
        exam_assert( __FILE__, __LINE__ )   
 #else  // 若不使用断言测试  
 #define EXAM_ASSERT(condition)  NULL  
 #endif  /* end of ASSERT */  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[plain]view plain copy
 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
 #ifdef _EXAM_ASSERT_TEST_ // 若使用断言测试  
 /* Notice: thisfunction does not call 'abort' to exit program */  
 void assert_report(char * file_name, unsigned int line_no )  
 {  
    printf( "\n[EXAM]Error Report: %s, line %u\n",  
            file_name, line_no );  
 }  
 #define ASSERT_REPORT( condition )  
     if( condition ) // 若条件成立，则无动作  
        NULL;  
    else // 否则报告  
        assert_report ( __FILE__, __LINE__ )  
 #else // 若不使用断言测试  
 #define ASSERT_REPORT( condition )  NULL  
 #endif /* end ofASSERT */  
 int msg_handle(unsigned char msg_name, unsigned char * msg )  
 {  
    switch( msg_name )  
     {  
        case MSG_ONE:  
            ... // 消息MSG_ONE处理  
            return MSG_HANDLE_SUCCESS;  
            ... // 其它合法消息处理  
        default:  
            ... // 消息出错处理  
            ASSERT_REPORT( FALSE );  // “合法”消息不成立，报告  
            return MSG_HANDLE_ERROR;  
     }  
 }  

本文链接：https://blog.csdn.net/qq_35061586/article/details/79077428

原作者删帖不实内容删帖广告或垃圾文章投诉

智能推荐

获取大于等于一个整数的最小2次幂算法（HashMap#tableSizeFor）_整数最小的2的几次方-程序员宅基地

文章浏览阅读2w次，点赞51次，收藏33次。一、需求给定一个整数，返回大于等于该整数的最小2次幂（2的乘方）。例：输入输出 -1 1 1 1 3 4 9 16 15 16二、分析当遇到这个需求的时候，我们可能会很容易想到一个"笨"办法：..._整数最小的2的几次方

Linux 中 ss 命令的使用实例_ss@,,x,, 0-程序员宅基地

文章浏览阅读865次。选项，以防止命令将 IP 地址解析为主机名。如果只想在命令的输出中显示 unix套接字连接，可以使用。不带任何选项，用来显示已建立连接的所有套接字的列表。如果只想在命令的输出中显示 tcp 连接，可以使用。如果只想在命令的输出中显示 udp 连接，可以使用。如果不想将ip地址解析为主机名称，可以使用。如果要取消命令输出中的标题行，可以使用。如果只想显示被侦听的套接字，可以使用。如果只想显示ipv4侦听的，可以使用。如果只想显示ipv6侦听的，可以使用。_ss@,,x,, 0

conda activate qiuqiu出现不存在activate_commandnotfounderror: 'activate-程序员宅基地

文章浏览阅读568次。CommandNotFoundError: 'activate'_commandnotfounderror: 'activate

Kafka 实战 - Windows10安装Kafka_win10安装部署kafka-程序员宅基地

文章浏览阅读426次，点赞10次，收藏19次。完成以上步骤后，您已在 Windows 10 上成功安装并验证了 Apache Kafka。在生产环境中，通常会将 Kafka 与外部 ZooKeeper 集群配合使用，并考虑配置安全、监控、持久化存储等高级特性。在生产者窗口中输入一些文本消息，然后按 Enter 发送。ZooKeeper 会在新窗口中运行。在另一个命令提示符窗口中，同样切换到 Kafka 的。Kafka 服务器将在新窗口中运行。在新的命令提示符窗口中，切换到 Kafka 的。，应显示已安装的 Java 版本信息。_win10安装部署kafka

【愚公系列】2023年12月 WEBGL专题-缓冲区对象_js 缓冲数据 new float32array-程序员宅基地

文章浏览阅读1.4w次。缓冲区对象（Buffer Object）是在OpenGL中用于存储和管理数据的一种机制。缓冲区对象可以存储各种类型的数据，例如顶点、纹理坐标、颜色等。在渲染过程中，缓冲区对象中存储的数据可以被复制到渲染管线的不同阶段中，例如顶点着色器、几何着色器和片段着色器等，以完成渲染操作。相比传统的CPU访问内存，缓冲区对象的数据存储和管理更加高效，能够提高OpenGL应用的性能表现。_js 缓冲数据 new float32array

四、数学建模之图与网络模型_图论与网络优化数学建模-程序员宅基地

文章浏览阅读912次。（1）图（Graph）：图是数学和计算机科学中的一个抽象概念，它由一组节点（顶点）和连接这些节点的边组成。图可以是有向的（有方向的，边有箭头表示方向）或无向的（没有方向的，边没有箭头表示方向）。图用于表示各种关系，如社交网络、电路、地图、组织结构等。（2）网络（Network）：网络是一个更广泛的概念，可以包括各种不同类型的连接元素，不仅仅是图中的节点和边。网络可以包括节点、边、连接线、路由器、服务器、通信协议等多种组成部分。网络的概念在各个领域都有应用，包括计算机网络、社交网络、电力网络、交通网络等。_图论与网络优化数学建模

随便推点

android 加载布局状态封装_adnroid加载数据转圈封装全屏转圈封装-程序员宅基地

文章浏览阅读1.5k次。我们经常会碰见正在加载中，加载出错， “暂无商品”等一系列的相似的布局，因为我们有很多请求网络数据的页面，我们不可能每一个页面都写几个“正在加载中”等布局吧，这时候将这些状态的布局封装在一起就很有必要了。我们可以将这些封装为一个自定布局，然后每次操作该自定义类的方法就行了。首先一般来说，从服务器拉去数据之前都是“正在加载”页面，加载成功之后“正在加载”页面消失，展示数据；如果加载失败，就展示_adnroid加载数据转圈封装全屏转圈封装

阿里云服务器（Alibaba Cloud Linux 3）安装部署Mysql8-程序员宅基地

文章浏览阅读1.6k次，点赞23次，收藏29次。PS: 如果执行sudo grep 'temporary password' /var/log/mysqld.log 后没有报错，也没有任何结果显示，说明默认密码为空，可以直接进行下一步（后面设置密码时直接填写新密码就行）。3.（可选）当操作系统为Alibaba Cloud Linux 3时，执行如下命令，安装MySQL所需的库文件。下面示例中，将创建新的MySQL账号，用于远程访问MySQL。2.依次运行以下命令，创建远程登录MySQL的账号，并允许远程主机使用该账号访问MySQL。_alibaba cloud linux 3