单元测试覆盖率

什么是单元测试覆盖率

关于其定义,先来看一下维基百科上的一段描述:

代码覆盖(Code coverage)是软件测试中的一种度量,描述程序中源代码被测试的比例和程度,所得比例称为代码覆盖率

简单来理解,就是单元测试中代码执行量与代码总量之间的比率。

以一个最简单的例子来直观感受一下:

Service服务类:

public class NumToStringServiceImpl implements NumToStringService {
    @Override
    public String num2Str(Integer i) {
        String str = "";
        switch (i) {
            case 1:
                str = "one";
                break;
            case 2:
                str = "two";
                break;
            default:
                str = "none";
        }
        return str;
    }
}

单元测试类:

public class NumToStringServiceTest {
 
    @Autowired
    NumToStringService numToStringService;
 
    @Test
    void testNum2Str() {
        String str1 = numToStringService.num2Str(1);
        assertThat(str1, is("one"));
        String str2 = numToStringService.num2Str(2);
        assertThat(str2, is("two"));
    }
}

从上面的代码中能看出,单元测试方法testNum2Str能够覆盖到服务类num2Str方法的case 1case 2两个分支,覆盖不到default分支。那么覆盖率就是num2Str方法case 1case 2分支的代码量除以方法的总代码量。

单元测试覆盖率框架

单元测试覆盖率常用的框架有**JaCoCo** 、EMMA 和**Cobertura**。我们目前(在Jenkins中)使用的是JaCoCo。

JaCoCo可以统计的指标有:

  1. 指令(C0 Coverage):JaCoCo计数的最小单元是单一的Java字节码指令。指令覆盖率提供了关于字节码执行数量、未执行数量的信息。
  2. 分支(C1 Coverage) :对所有的ifswitch语句计算分支覆盖率。统计在方法中分支执行数量、未执行数量的信息。但要注意,异常处理不在此计算范围内。
  3. 圈复杂度(Cyclomatic Complexity):对非抽象方法计算圈复杂度,并汇总类、包和组的(圈)复杂度。这个值可以做为单元测试用例是否完全覆盖的参考。
  4. 行(Lines):一行可能包含一条或多条指令,如果至少有一条指令被执行了,那么该行就算作是被执行了。
  5. 方法(Methods):每个非抽象方法至少包含一条指令。如果至少有一条指令被执行了,那么该方法就算作是被执行了。
  6. 类(Classes):如果类中至少有一个方法被执行了,那么该类就算作是被执行了。

注:个人认为,最需要关注的指标是 (Lines)和分支 (C1 Coverage),其次是方法 (Methods)和 (Classes),指令 (C0 Coverage)和圈复杂度 (Cyclomatic Complexity)可以不用关注,因为跟 (Lines)和分支(C1 Coverage)其实是差不多的,只不过多了一种参考维度。

查看单元测试覆盖率

在IntelliJ IDEA中已经内置了JaCoCo插件,因此研发可以在本机运行单元测试来查看覆盖率:

1、点击IDE右上侧的"Edit Configurations...":

2、在"Choose coverage runner"中选择JaCoCo:

3、点击"Run ... with Coverage"运行:

4、运行完成后会展示分支 (C1 Coverage)、 (Lines)、方法 (Methods)、(Classes)这四个指标:

5、点击"Generate Coverage Report"可以生成一份html版的所有指标的报告:

JaCoCo与持续集成

1、需要在项目的<plugins>中加入JaCoCo插件:

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.5</version>
    <executions>
        <execution>
            <id>default-prepare-agent</id>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
        </execution>
        <execution>
            <id>default-report</id>
            <goals>
                <goal>report</goal>
            </goals>
        </execution>
    </executions>
</plugin>

目前发现如果项目中不加以上配置,而是在Jenkinsfile中

以命令的方式去应用JaCoCo,会导致不能生成jacoco.exec,进而无法运行覆盖率测试。

2、在Jenkinsfile中加入

exclusionPattern: '**/controller/*.class', sourceExclusionPattern: '**/controller/*.java'

可以过滤掉controller层的检测。因为目前我们的单元测试主要是针对service层的,如果把controller层的类引入进来,会使单元测试覆盖率的值变低。

3、可以在Jenkins(http://${ip}:{port}/job/{your_project}/lastBuild/jacoco/)中查看生成的单元测试覆盖率报告:

该报告与IntelliJ IDEA中的报告都是JaCoCo原生的,是准确的。

目前发现SonarQube中的报告一是不准,二是指标不全,建议不要查看SonarQube的报告。

题外话

覆盖率作为衡量单元测试质量的唯一标准是不合理的。比如下面这个例子:

public double cal(double a, double b) {
  if (b != 0) {
    return a / b;
  }
}

仅一个测试用例就可以做到100%的覆盖率,比如cal(10.0, 2.0),但并不代表测试足够全面了,还需要考虑当除数等于0的情况下,代码执行是否符合预期。


作者:谷隐凡二

来源:CSDN

原文:https://blog.csdn.net/m0_37570494/article/details/125440949

版权声明:本文为作者原创文章,转载请附上博文链接!

内容解析By:CSDN,CNBLOG博客文章一键转载插件

相关推荐
Devil枫23 分钟前
Vue 3 单元测试与E2E测试
前端·vue.js·单元测试
小袁在上班7 小时前
Python 单元测试中的 Mocking 与 Stubbing:提高测试效率的关键技术
python·单元测试·log4j
测试19987 小时前
外包干了2年,快要废了。。。
自动化测试·软件测试·python·面试·职场和发展·单元测试·压力测试
安冬的码畜日常10 小时前
【The Art of Unit Testing 3_自学笔记06】3.4 + 3.5 单元测试核心技能之:函数式注入与模块化注入的解决方案简介
笔记·学习·单元测试·jest
王解11 小时前
Jest项目实战(2): 项目开发与测试
前端·javascript·react.js·arcgis·typescript·单元测试
程序员小雷1 天前
软件测试基础:单元测试与集成测试
python·功能测试·selenium·测试工具·单元测试·集成测试·压力测试
王解1 天前
Jest进阶知识:深入测试 React Hooks-确保自定义逻辑的可靠性
前端·javascript·react.js·typescript·单元测试·前端框架
程序员雷叔1 天前
外包功能测试就干了4周,技术退步太明显了。。。。。
功能测试·测试工具·面试·职场和发展·单元测试·测试用例·postman
安冬的码畜日常1 天前
【玩转 Postman 接口测试与开发2_005】第六章:Postman 测试脚本的创建(上)
javascript·测试工具·单元测试·postman·bdd·chai
程序员小雷1 天前
应对自动化测试中的异步操作:策略与实践
功能测试·selenium·测试工具·jmeter·单元测试·测试用例·postman