使用JaCoCo统计java代码覆盖率

代码覆盖率

在白盒测试中，主要使用代码覆盖率来评判白盒测试完成的程度。代码覆盖率是指：在测试中，所执行的源代码占全部源代码的比例。

JaCoCo介绍

JaCoCo是一个开源的覆盖率工具(官网地址：http://www.eclemma.org/jacoco/)，它针对的开发语言是java，其使用 方法很灵活，可以嵌入到Ant、Maven中；可以作为Eclipse插件，可以使用其JavaAgent技术监控Java程序等等。

JaCoCo执行最小的java版本需要Java1.5，支持java1.8；

JaCoCo通过注入来修改和生成java字节码，使用的是ASM库；

很多第三方的工具提供了对JaCoCo的集成，如sonar、Jenkins等。

---

JaCoCo包含了多种尺度的覆盖率计数器,包含：

指令级覆盖(Instructions,C0coverage)，分支 （Branches,C1coverage）、圈复杂度(CyclomaticComplexity)、行覆盖(Lines)、方法覆盖(non- abstract methods)、类覆盖(classes)。

行覆盖率：度量被测程序的每行代码是否被执行，判断标准行中是否至少有一个指令被执行。

类覆盖率：度量计算class类文件是否被执行。

分支覆盖率：度量if和switch语句的分支覆盖情况，计算一个方法里面的总分支数，确定执行和不执行的分支数量。

方法覆盖率：度量被测程序的方法执行情况，是否执行取决于方法中是否有至少一个指令被执行。

指令覆盖：计数单元是单个java二进制代码指令，指令覆盖率提供了代码是否被执行的信息，度量完全独立源码格式。

圈复杂度：在（线性）组合中，计算在一个方法里面所有可能路径的最小数目，缺失的复杂度同样表示测试案例没有完全覆盖到这个模块(圈复杂度可以理解为覆盖所有的可能情况最少使用的测试用例数)。

---

JaCoCo插件下载

Eclipse 的maketetpalce 中搜索eclemma 插件，然后默认安装。

---

和同类产品比较

市面上流行的单元测试覆盖率工具还有 Clover（商用） 和 Cobertura。和它们相比，JaCoCo 有如下优势：

JaCoCo 拥有友好的授权形式。JaCoCo 使用了 Eclipse Public License，方便个人用户和商业用户使用。而 Clover 对于商业用户是收费的。

JaCoCo被良好地集成进各种工具中。在Java 社区里，很多流行的工具都可以集成 JaCoCo，比如 SonarQube、Jenkins、Netbeans、Eclipse、IntelliJ IDEA、Gradle 等。

JaCoCo社区非常活跃，它是目前唯一支持 Java 8 的单元测试覆盖率工具。而且关于JaCoCo的文档相对较多，降低了学习门槛。

在Github上 Jacoco star 为1044 而Cobertura start 为22。

代码覆盖率统计

通用统计内容

主要统计语句覆盖率、分支覆盖率、方法覆盖率和类覆盖率

报告生成

1.运行测试用例，选中用例或者工程，右键Coverage As>JUnit Test

2.用例执行完毕后，点击Export Session，如下图所示

 

选择要查看的用例执行历史记录，保存到磁盘指定位置，如下图所示：

 

报告展示

在磁盘保存的目录中打开生成的index.html，如下图所示

 

看到具体包的代码覆盖率

 

点击包链接，查看包中具体类的代码覆盖率

 

点击类链接，查看类中具体方法的代码覆盖率

 

点击方法链接，查看类中具体方法的执行情况

 

对上图中的颜色标记进行解释

分支覆盖

l  红色钻石：无覆盖，没有分支被执行。

l  黄色钻石：部分覆盖，部分分支被执行。

l  绿色钻石：全覆盖，所有分支被执行。

代码行覆盖

l  红色背景：无覆盖，该行的所有指令均无执行。

l  黄色背景：部分覆盖，该行部分指令被执行。

l  绿色背景：全覆盖，该行所有指令被执行。