关于SpringBoot单元测试(cobertura生成覆盖率报告) 关于SpringBoot单元测试(cobertur

demo（SpringBoot 项目）
覆盖率测试报告生成（cobertura）

cobertura 原理
1.instrument
2.执行测试
3.生成报告

SpringBoot pom.xml 配置

命令介绍

maven-surefire-plugin 使用说明

1.跳过测试
2.动态指定要运行的测试用例
3.包含与排除测试用例

demo（SpringBoot 项目）被测试类：

import org.springframework.stereotype.Service; @Servicepublic class TestService {public String sayHi() {return "hi"; }public int divide(int a, int b) {return a / b; }}

测试代码：

import static org.junit.Assert.*; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.test.context.junit4.SpringRunner; @RunWith(SpringRunner.class)@SpringBootTestpublic class TestServiceTest {@AutowiredTestService testService; @Testpublic void testSayHi() {TestService testService = new TestService(); String result = testService.sayHi(); assertEquals("hi", result); }@Testpublic void testDivide() {TestService testService = new TestService(); int result = testService.divide(3, 6); assertTrue(result > -1); }}

pom.xml 配置文件

![cobertura](C:\Users\jiaflu\Desktop\cobertura.PNG)4.0.0org.springframework.bootspring-boot-starter-parent2.1.5.RELEASE com.jiaflulearn_springoot0.0.1-SNAPSHOTlearn_springootDemo project for Spring Boot1.82.9.8org.springframework.bootspring-boot-starterorg.springframework.bootspring-boot-starter-testtestorg.springframework.bootspring-boot-starter-weborg.springframework.bootspring-boot-maven-pluginorg.apache.maven.pluginsmaven-compiler-plugin1.81.8org.apache.maven.pluginsmaven-surefire-plugin2.5org.codehaus.mojocobertura-maven-plugin2.5.2UTF-8htmlxml

运行mvn cobertura:cobertura 查看截图：

文章图片

覆盖率测试报告生成（cobertura）
cobertura 原理
cobertura执行过程大致如下：

使用instrument修改我们编译后的class文件，位于 target\generated-classes。
执行测试，测试数据输出到xxx.ser中，位于 target\cobertura\cobertura.ser。
使用report生成覆盖率报告。

1.instrument
instrument：cobertura使用instrument修改我们编译后的class文件，在代码里面加入cobertura的统计代码。并生成一个.ser文件（用于覆盖率数据的输出）。
使用 instrument 执行的过程中，CoberturaInstrumenter 会首先调用分析监听器分析给定的编译好的.class，获得touchPoint（可以认为对应于源代码中的待覆盖行）以及需要的其他信息。然后调用注入监听器将信息注入到新的.class中，保存到 \target\generated-classes 目录下。
示例：

//// Source code recreated from a .class file by IntelliJ IDEA// (powered by Fernflower decompiler)//package com.cisco.webex.cmse.soa.soaservice.service; import net.sourceforge.cobertura.coveragedata.HasBeenInstrumented; import net.sourceforge.cobertura.coveragedata.TouchCollector; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.PropertySource; import org.springframework.stereotype.Service; @PropertySource({"classpath:application.properties"})@Servicepublic class PropertyService implements HasBeenInstrumented {private static final Logger logger; @Value("${cdp.instance.url}")private String cdpInstanUrl; @Value("${soa.instance.url}")private String soaInstanceUrl; @Value("${github.api.token}")public String gitApiToken; @Value("${github.instance.url}")private String githubInstance; @Value("${github.repo.template.owner}")private String tplRepoOwner; @Value("${github.repo.consul.owner}")private String consulRepoOwner; @Value("${slm.listen.queue.name}")private String slmListenQueue; public PropertyService() {boolean var1 = false; int __cobertura__branch__number__ = true; TouchCollector.touch("com.cisco.webex.cmse.soa.soaservice.service.PropertyService", 12); super(); }public String getCdpInstanUrl() {boolean var1 = false; int __cobertura__branch__number__ = true; TouchCollector.touch("com.cisco.webex.cmse.soa.soaservice.service.PropertyService", 33); return this.cdpInstanUrl; }...public void setSlmListenQueue(String ()V) {boolean var2 = false; int __cobertura__branch__number__ = true; TouchCollector.touch("com.cisco.webex.cmse.soa.soaservice.service.PropertyService", 85); this.slmListenQueue = slmListenQueue; TouchCollector.touch("com.cisco.webex.cmse.soa.soaservice.service.PropertyService", 86); }static {boolean var0 = false; boolean var1 = true; TouchCollector.touch("com.cisco.webex.cmse.soa.soaservice.service.PropertyService", 13); logger = LoggerFactory.getLogger(PropertyService.class); }}

2.执行测试
在执行测试用例时，引用 cobertura 修改过的.class，测试信息写入到cobertura.ser档案文件。

3.生成报告
从cobertura.ser获取覆盖率数据，然后结合src中提供的源代码，生成最终的覆盖率报告，放到了target\site\cobertura路径下。若配置了生成 html 格式的报告，可以通过 index.html 查看覆盖率测试报告。

SpringBoot pom.xml 配置添加如下依赖：

org.springframework.bootspring-boot-maven-pluginorg.apache.maven.pluginsmaven-compiler-plugin1.81.8org.apache.maven.pluginsmaven-surefire-plugin2.5-noverifyorg.codehaus.mojocobertura-maven-plugin2.5.2xmlhtml

采坑：
在使用 mvn cobertura:cobertura 命令生成测试覆盖率报告时，出现了如下问题（截取部分，报错原因如下）：

Reason:
Expected stackmap frame at this location.
Bytecode:
0x0000000: 2ab4 001b 2bb9 002e 0200 c600 2f2a b400
0x0000010: 1b2b b900 2e02 00c0 0030 b600 34c6 001c

解决方法：
本人使用的是 jdk1.8，添加 jvm 参数 -noverify，可以在 pom 文件中添加配置，配置见上述 pom.xml
网上查资料 jdk1.7 添加 jvm 参数 -XX:-UseSplitVerifier，（1.8没有 -XX:-UseSplitVerifier 这参数）

命令介绍

cobertura:check

根据最新的源码标记(生成的class文件)校验测试用例的覆盖率,如果没有达到要求,则执行失败.

cobertura:check-integration-test

这个命令和cobertura:check功能是一样的,区别是二者绑定的maven生命周期不一样.cobertura:check绑定了test, cobertura:check-integration-test绑定了verify.再说的明白些,maven生命周期中有一个是test跑得单元测试,还有一个是integration-test跑的集成测试.而verify前就是integration-test.即cobertura:check-integration-test比cobertura:check涵盖的测试用例更多.

cobertura:clean

这个好理解,就是清理掉目录/target/cobertura/中得文件.目前发现里面就一个文件cobertura.ser.

cobertura:cobertura

这个插件的关键命令.标记被编译的文件,运行单元测试,生成测试报告.

cobertura:cobertura-integration-test

和cobertura:cobertura做了一样的事情,区别是包含了集成测试用例.

cobertura:dump-datafile

在命令行输出覆盖率数据.数据依据是生成的class文件.这个命令我没搞懂他的意义何在.在后面一个有趣的实验我们会用这个命令来更好的理解cobertura-maven-plugin.

cobertura:help
cobertura:instrument

标记被编译的class文件.执行这个命令会在目录/target/generated-classes/cobertura下生成一套class文件.
【关于SpringBoot单元测试(cobertura生成覆盖率报告)】
maven-surefire-plugin 使用说明 Maven本身并不是一个单元测试框架，它只是在构建执行到特定生命周期阶段的时候，通过插件来执行JUnit或者TestNG的测试用例。这个插件就是maven-surefire-plugin，也可以称为测试运行器(Test Runner)，它能兼容JUnit 3、JUnit 4以及TestNG。
在默认情况下，maven-surefire-plugin的test目标会自动执行测试源码路径（默认为src/test/java/）下所有符合一组命名模式的测试类。这组模式为：