關(guān)于SpringBoot單元測(cè)試(cobertura生成覆蓋率報(bào)告)

更新時(shí)間：2021年11月22日 16:33:18 作者：PC_Repair

這篇文章主要介紹了關(guān)于SpringBoot單元測(cè)試(cobertura生成覆蓋率報(bào)告)，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

demo（SpringBoot 項(xiàng)目）

被測(cè)試類：

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

測(cè)試代碼：

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)
@SpringBootTest
public class TestServiceTest {
    @Autowired
    TestService testService;
    @Test
    public void testSayHi() {
        TestService testService = new TestService();
        String result = testService.sayHi();
        assertEquals("hi", result);
    }
    @Test
    public void testDivide() {
        TestService testService = new TestService();
        int result = testService.divide(3, 6);
        assertTrue(result > -1);
    }
}

pom.xml 配置文件

![cobertura](C:\Users\jiaflu\Desktop\cobertura.PNG)<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.5.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.jiaflu</groupId>
    <artifactId>learn_springoot</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>learn_springoot</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
        <jackson.version>2.9.8</jackson.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.5</version>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>cobertura-maven-plugin</artifactId>
                <version>2.5.2</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                    <formats>
                        <format>html</format>
                        <format>xml</format>
                    </formats>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

運(yùn)行mvn cobertura:cobertura 查看截圖：

覆蓋率測(cè)試報(bào)告生成（cobertura）

cobertura 原理

cobertura執(zhí)行過(guò)程大致如下：

使用instrument修改我們編譯后的class文件，位于 target\generated-classes。
執(zhí)行測(cè)試，測(cè)試數(shù)據(jù)輸出到xxx.ser中，位于 target\cobertura\cobertura.ser。
使用report生成覆蓋率報(bào)告。

1.instrument

instrument：cobertura使用instrument修改我們編譯后的class文件，在代碼里面加入cobertura的統(tǒng)計(jì)代碼。并生成一個(gè).ser文件（用于覆蓋率數(shù)據(jù)的輸出）。

使用 instrument 執(zhí)行的過(guò)程中，CoberturaInstrumenter 會(huì)首先調(diào)用分析監(jiān)聽(tīng)器分析給定的編譯好的.class，獲得touchPoint（可以認(rèn)為對(duì)應(yīng)于源代碼中的待覆蓋行）以及需要的其他信息。然后調(diào)用注入監(jiān)聽(tīng)器將信息注入到新的.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"})
@Service
public 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.執(zhí)行測(cè)試

在執(zhí)行測(cè)試用例時(shí)，引用 cobertura 修改過(guò)的.class，測(cè)試信息寫入到cobertura.ser檔案文件。

3.生成報(bào)告

從cobertura.ser獲取覆蓋率數(shù)據(jù)，然后結(jié)合src中提供的源代碼，生成最終的覆蓋率報(bào)告，放到了target\site\cobertura路徑下。若配置了生成 html 格式的報(bào)告，可以通過(guò) index.html 查看覆蓋率測(cè)試報(bào)告。

SpringBoot pom.xml 配置

添加如下依賴：

       <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.5</version>
                <configuration>
                    <!-- 此參數(shù)用于解決一個(gè)坑，下面會(huì)說(shuō)明 -->
                    <argLine>-noverify</argLine>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>cobertura-maven-plugin</artifactId>
                <version>2.5.2</version>
                <configuration>
                    <formats>
                        <format>xml</format>
                        <format>html</format>
                    </formats>
                </configuration>
            </plugin>

采坑：

在使用 mvn cobertura:cobertura 命令生成測(cè)試覆蓋率報(bào)告時(shí)，出現(xiàn)了如下問(wèn)題（截取部分，報(bào)錯(cuò)原因如下）：

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 參數(shù) -noverify，可以在 pom 文件中添加配置，配置見(jiàn)上述 pom.xml

網(wǎng)上查資料 jdk1.7 添加 jvm 參數(shù) -XX:-UseSplitVerifier，（1.8沒(méi)有 -XX:-UseSplitVerifier 這參數(shù)）

命令介紹

cobertura:check

根據(jù)最新的源碼標(biāo)記(生成的class文件)校驗(yàn)測(cè)試用例的覆蓋率,如果沒(méi)有達(dá)到要求,則執(zhí)行失敗.

cobertura:check-integration-test

這個(gè)命令和cobertura:check功能是一樣的,區(qū)別是二者綁定的maven生命周期不一樣.cobertura:check綁定了test, cobertura:check-integration-test綁定了verify.再說(shuō)的明白些,maven生命周期中有一個(gè)是test跑得單元測(cè)試,還有一個(gè)是integration-test跑的集成測(cè)試.而verify前就是integration-test.即cobertura:check-integration-test比cobertura:check涵蓋的測(cè)試用例更多.

cobertura:clean

這個(gè)好理解,就是清理掉目錄/target/cobertura/中得文件.目前發(fā)現(xiàn)里面就一個(gè)文件cobertura.ser.

cobertura:cobertura

這個(gè)插件的關(guān)鍵命令.標(biāo)記被編譯的文件,運(yùn)行單元測(cè)試,生成測(cè)試報(bào)告.

cobertura:cobertura-integration-test

和cobertura:cobertura做了一樣的事情,區(qū)別是包含了集成測(cè)試用例.

cobertura:dump-datafile

在命令行輸出覆蓋率數(shù)據(jù).數(shù)據(jù)依據(jù)是生成的class文件.這個(gè)命令我沒(méi)搞懂他的意義何在.在后面一個(gè)有趣的實(shí)驗(yàn)我們會(huì)用這個(gè)命令來(lái)更好的理解cobertura-maven-plugin.

cobertura:help
cobertura:instrument

標(biāo)記被編譯的class文件.執(zhí)行這個(gè)命令會(huì)在目錄/target/generated-classes/cobertura下生成一套class文件.

maven-surefire-plugin 使用說(shuō)明

Maven本身并不是一個(gè)單元測(cè)試框架，它只是在構(gòu)建執(zhí)行到特定生命周期階段的時(shí)候，通過(guò)插件來(lái)執(zhí)行JUnit或者TestNG的測(cè)試用例。這個(gè)插件就是maven-surefire-plugin，也可以稱為測(cè)試運(yùn)行器(Test Runner)，它能兼容JUnit 3、JUnit 4以及TestNG。

在默認(rèn)情況下，maven-surefire-plugin的test目標(biāo)會(huì)自動(dòng)執(zhí)行測(cè)試源碼路徑（默認(rèn)為src/test/java/）下所有符合一組命名模式的測(cè)試類。這組模式為：

*/Test.java：任何子目錄下所有命名以Test開(kāi)關(guān)的Java類。
*/Test.java：任何子目錄下所有命名以Test結(jié)尾的Java類。
*/TestCase.java：任何子目錄下所有命名以TestCase結(jié)尾的Java類。

maven-surefire-plugin 插件應(yīng)用：

1.跳過(guò)測(cè)試

跳過(guò)測(cè)試運(yùn)行 mvn package -DskipTests

或者通過(guò) pom 提供該屬性：

<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-surefire-plugin</artifactId>  
    <version>2.5</version>  
    <configuration>  
        <skipTests>true</skipTests>  
    </configuration>  
</plugin>

跳過(guò)測(cè)試代碼的編譯 mvn package -Dmaven.test.skip=true

或者通過(guò) pom 提供該屬性：

<plugin>  
    <groupId>org.apache.maven.plugin</groupId>  
    <artifactId>maven-compiler-plugin</artifactId>  
    <version>2.1</version>  
    <configuration>  
        <skip>true</skip>  
    </configuration>  
</plugin>

2.動(dòng)態(tài)指定要運(yùn)行的測(cè)試用例

mvn test -Dtest=RandomGeneratorTest

也可以使用通配符：

mvn test -Dtest=Random*Test

或者也可以使用“，”號(hào)指定多個(gè)測(cè)試類：

mvn test -Dtest=Random*Test,AccountCaptchaServiceTest

如果沒(méi)有指定測(cè)試類，那么會(huì)報(bào)錯(cuò)并導(dǎo)致構(gòu)建失敗:

mvn test -Dtest

這時(shí)候可以添加 -DfailIfNoTests=false 參數(shù)告訴 maven-surefire-plugin 即使沒(méi)有任何測(cè)試也不要報(bào)錯(cuò):

mvn test -Dtest -DfailIfNoTests=false

3.包含與排除測(cè)試用例

<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-surefire-plugin</artifactId>  
    <version>2.5</version>  
    <configuration>  
        <includes>  
            <include>**/*Tests.java</include>  
        </includes>  
        <excludes>  
            <exclude>**/*ServiceTest.java</exclude>  
            <exclude>**/TempDaoTest.java</exclude>  
        </excludes>  
    </configuration>  
</plugin>

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: