Jacoco统计项目单元测试覆盖率

1.JaCoCo介绍：

JaCoCo，即 Java Code Coverage，是EclEmma团队基于多年覆盖率库使用经验总结而研发的一个开源的Java代码覆盖率库。 代码覆盖（英语：Code coverage）是软件测试中的一种度量，描述程序中源代码被测试的比例和程度，所得比例称为代码覆盖率。 目前Java常用覆盖率工具Jacoco、Emma和Cobertura、Clover(商用).但是Emma和Cobertura已经停止维护。

2. JaCoCo覆盖率计数器:

JaCoCo 包含了多种尺度的覆盖率计数器（Coverage Counters），包含指令级（Instructions,C0 coverage)、分支（Branches,C1 coverage）、圈复杂度（Cyclomatic Complexity）、行（Lines）、方法（Methods）、类（Classes）。

Instructions：Jacoco 计算的最小单位就是字节码指令。指令覆盖率表明了在所有的指令中，哪些被执行过以及哪些没有被执行。这项指数完全独立于源码格式并且在任何情况下有效，不需要类文件的调试信息。 Branches：Jacoco 对所有的 if 和 switch 指令计算了分支覆盖率。这项指标会统计所有的分支数量，并同时支出哪些分支被执行，哪些分支没有被执行。这项指标也在任何情况都有效。异常处理不考虑在分支范围内。 Cyclomatic Complexity：Jacoco 为每个非抽象方法计算圈复杂度，并也会计算每个类、包、组的复杂度。根据 McCabe 1996 的定义，圈复杂度可以理解为覆盖所有的可能情况最少使用的测试用例数。这项参数也在任何情况下有效。 Lines：该项指数在有调试信息的情况下计算。 Methods：每一个非抽象方法都至少有一条指令。若一个方法至少被执行了一条指令，就认为它被执行过。因为 Jacoco 直接对字节码进行操作，所以有些方法没有在源码显示（比如某些构造方法和由编译器自动生成的方法）也会被计入在内。 Classes：每个类中只要有一个方法被执行，这个类就被认定为被执行。同 Methods一样，有些没有在源码声明的方法被执行，也认定该类被执行。

对 JaCoCo 可以与现有构建脚本和工具进行集成这里做进一步说明： 官方提供了 Java API、Java Agent 、CLI、Ant 、Maven、Eclipse 这几种集成方式； 第三方提供了诸如与 Gradle、IDEA、Jenkins 等其它工具的集成方式。

3.引入依赖：

<!-- 进行单元测试-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.0.0-M5</version>
                <configuration>
                    <testFailureIgnore>true</testFailureIgnore>
                </configuration>
            </plugin>
            
            <plugin>
                <groupId>org.jacoco</groupId>
                <artifactId>jacoco-maven-plugin</artifactId>
                <version>0.8.4</version>
                <executions>
                    <execution>
                        <id>jacoco-initialize</id>
                        <goals>
                            <goal>prepare-agent</goal>
                        </goals>
                    </execution>
                    <execution>
                        <id>jacoco-site</id>
                        <!--执行阶段-->
                        <phase>test</phase>
                        <goals>
                            <goal>report</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

4.点击test执行，生成报告：

5.注意事项：

maven-surefire-plugin中一定要添加属性testFailureIgnore>true</testFailureIgnore 不然如果存在不通过的单元测试，jacoco报告将无法生成。