这篇博客文章描述了我们如何使用 JaCoCo Maven 插件为单元和集成测试创建代码覆盖率报告。

我们的构建要求如下：

运行测试时，我们的构建必须为单元测试和集成测试创建代码覆盖率报告。
代码覆盖率报告必须在单独的目录中创建。换句话说，必须将用于单元测试的代码覆盖率报告创建到与用于集成测试的代码覆盖率报告不同的目录中。
让我们开始吧。

配置 JaCoCo Maven 插件

我们使用 JaCoCo Maven 插件有两个目的：

• 它使我们可以访问 JaCoCo 运行时代理，该代理记录了执行覆盖率数据。
• 它根据 JaCo​​Co 运行时代理记录的执行数据创建代码覆盖率报告。
• 我们可以按照以下步骤配置 JaCoCo Maven 插件：

将 JaCoCo Maven 插件添加到我们的 POM 文件的插件部分。

• 为单元测试配置代码覆盖率报告。
• 配置代码覆盖率报告以进行集成测试。 下面将更详细地描述这些步骤。

将 JaCoCo Maven 插件添加到 POM 文件

通过将以下插件声明添加到其 “ 插件” 部分，我们可以将 JaCoCo Maven 插件添加到我们的 POM 文件中：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
</plugin>

配置单元测试的代码覆盖率报告

我们可以通过将两个执行添加到插件声明中来为单元测试配置代码覆盖率报告。这些执行方式如下所述：

• 第一次执行将创建一个指向 JaCoCo 运行时代理的属性。确保执行数据已写入文件 target / coverage-reports / jacoco-ut.exec。将该属性的名称设置为 surefireArgLine。运行单元测试时，此属性的值作为 VM 参数传递。
• 运行单元测试后，第二次执行将为单元测试创建代码覆盖率报告。确保从文件 target / coverage-reports / jacoco-ut.exec 中读取执行数据，并将代码覆盖率报告写入目录 target / site / jacoco-ut 中。

我们的插件配置的相关部分如下所示：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
    <executions>
        <!--
           Prepares the property pointing to the JaCoCo runtime agent which
           is passed as VM argument when Maven the Surefire plugin is executed.
       -->
        <execution>
            <id>pre-unit-test</id>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <destFile>${project.build.directory}/coverage-reports/jacoco-ut.exec</destFile>
                <!--
                   Sets the name of the property containing the settings
                   for JaCoCo runtime agent.
               -->
                <propertyName>surefireArgLine</propertyName>
            </configuration>
        </execution>
        <!--
           Ensures that the code coverage report for unit tests is created after
           unit tests have been run.
       -->
        <execution>
            <id>post-unit-test</id>
            <phase>test</phase>
            <goals>
                <goal>report</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <dataFile>${project.build.directory}/coverage-reports/jacoco-ut.exec</dataFile>
                <!-- Sets the output directory for the code coverage report. -->
                <outputDirectory>${project.reporting.outputDirectory}/jacoco-ut</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

让我们找出如何为集成测试配置代码覆盖率报告。

配置集成测试的代码覆盖率报告

我们可以通过在插件声明中添加两个执行来为集成测试配置代码覆盖率报告。这些执行方式如下所述：

• 第一次执行将创建一个指向 JaCoCo 运行时代理的属性。确保将执行数据写入文件 target / coverage-reports / jacoco-it.exec。将该属性的名称设置为 failsafeArgLine。运行我们的集成测试时，此属性的值作为 VM 参数传递。
• 创建一个执行，该执行在集成测试运行后为集成测试创建代码覆盖率报告。确保从文件 target / coverage-reports / jacoco-it.exec 中读取执行数据，并将代码覆盖率报告写入目录 target / site / jacoco-it。

我们的插件配置的相关部分如下所示：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.6.3.201306030806</version>
    <executions>
        <!-- The Executions required by unit tests are omitted. -->
        <!--
           Prepares the property pointing to the JaCoCo runtime agent which
           is passed as VM argument when Maven the Failsafe plugin is executed.
       -->
        <execution>
            <id>pre-integration-test</id>
            <phase>pre-integration-test</phase>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <destFile>${project.build.directory}/coverage-reports/jacoco-it.exec</destFile>
                <!--
                   Sets the name of the property containing the settings
                   for JaCoCo runtime agent.
               -->
                <propertyName>failsafeArgLine</propertyName>
            </configuration>
        </execution>
        <!--
           Ensures that the code coverage report for integration tests after
           integration tests have been run.
       -->
        <execution>
            <id>post-integration-test</id>
            <phase>post-integration-test</phase>
            <goals>
                <goal>report</goal>
            </goals>
            <configuration>
                <!-- Sets the path to the file which contains the execution data. -->
                <dataFile>${project.build.directory}/coverage-reports/jacoco-it.exec</dataFile>
                <!-- Sets the output directory for the code coverage report. -->
                <outputDirectory>${project.reporting.outputDirectory}/jacoco-it</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

现在，我们已经配置了 JaCoCo Maven 插件。下一步是配置 Maven Surefire 插件。让我们找出如何做到这一点。

配置 Maven Surefire 插件

我们使用 Maven Surefire 插件运行示例应用程序的单元测试。因为我们要为单元测试创​​建代码覆盖率报告，所以我们必须确保在运行单元测试时 JaCoCo 代理正在运行。我们可以通过添加的价值保证本 surefireArgLine 财产作为价值 argLine 配置参数。

Maven Surefire 插件的配置如下所示（突出显示了所需的更改）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.15</version>
    <configuration>
        <!-- Sets the VM argument line used when unit tests are run. -->
        <argLine>${surefireArgLine}</argLine>
        <!-- Skips unit tests if the value of skip.unit.tests property is true -->
        <skipTests>${skip.unit.tests}</skipTests>
        <!-- Excludes integration tests when unit tests are run. -->
        <excludes>
            <exclude>**/IT*.java</exclude>
        </excludes>
    </configuration>
</plugin>

我们快完成了。剩下要做的就是配置 Maven Failsafe 插件。让我们找出如何做到这一点。

配置 Maven 故障安全插件

我们的示例应用程序的集成测试由 Maven Failsafe 插件运行。因为我们要为集成测试创建代码覆盖率报告，所以我们必须确保在运行集成测试时 JaCoCo 代理正在运行。我们可以通过将 failsafeArgLine 属性的值添加为 argLine 配置参数的值来实现。

Maven Failsafe 插件的配置如下所示（突出显示了所需的更改）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>2.15</version>
    <executions>
        <!--
            Ensures that both integration-test and verify goals of the Failsafe Maven
            plugin are executed.
        -->
        <execution>
            <id>integration-tests</id>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
            <configuration>
                <!-- Sets the VM argument line used when integration tests are run. -->
                <argLine>${failsafeArgLine}</argLine>
                <!--
                    Skips integration tests if the value of skip.integration.tests property
                    is true
                -->
                <skipTests>${skip.integration.tests}</skipTests>
            </configuration>
        </execution>
    </executions>
</plugin>

创建代码覆盖率报告

现在，我们已成功完成所需的配置。让我们看看如何为单元测试和集成测试创建代码覆盖率报告。

此博客文章的示例应用程序具有三个构建配置文件，下面对此进行了描述：

• 在开发配置文件开发过程中使用，这是我们构建的默认配置文件。当此配置文件处于活动状态时，仅运行单元测试。
• 在集成测试配置文件用于运行集成测试。

• 在所有的测试配置文件用于为运行单元测试和集成测试。
  我们可以通过在命令提示符处运行以下命令来创建不同的代码覆盖率报告：

• 命令 mvn clean test 运行单元测试，并为目录 target / site / jacoco-ut 创建单元测试的代码覆盖率报告。

• 命令 mvn clean verify -P integration-test 运行集成测试，并为目录 target / site / jacoco-it 创建用于集成测试的代码覆盖率报告。

• 命令 mvn clean verify -P all-tests 运行单元测试和集成测试，并为单元测试和集成测试创建代码覆盖率报告。

技术类文章精选

• java 一行代码打印心形
• Linux 性能监控软件 netdata 中文汉化版
• 接口测试代码覆盖率（jacoco）方案分享
• 性能测试框架
• 如何在 Linux 命令行界面愉快进行性能测试
• 图解 HTTP 脑图
• 将 swagger 文档自动变成测试代码
• 五行代码构建静态博客
• 基于 java 的直线型接口测试框架初探
• JUnit 中用于 Selenium 测试的中实践

非技术文章精选

• 为什么选择软件测试作为职业道路?
• 写给所有人的编程思维
• 成为优秀自动化测试工程师的 7 个步骤
• 手动测试存在的重要原因
• 成为自动化测试的 7 种技能
• 自动化和手动测试，保持平衡！
• 自动化测试生命周期
• 如何在 DevOps 引入自动化测试