jacoco-1-java代码测试覆盖率之本地环境初体验

2020-10-25

前言

jacoco是一个开源的覆盖率工具,它针对的开发语言是java,其使用方法很灵活,可以插桩到Ant、Maven中,可以使用其JavaAgent技术监控Java程序等。

那么本次主要使用对java代码进行覆盖率统计,比如A测试攻城狮在功能测试时/接口测试时,实际覆盖测试了多少java代码,可以作为一个评判。

jacoco官网地址:http://www.eclemma.org(有墙)

一、jacoco基本介绍

1、jacoco是根据控制流Type来采用不同的探针插桩策略的。(植入探针)

2、探针原理是字节码指令集插入到java方法中,程序执行后可以被记录,它不会改变原有代码的行为。

3、jacoco支持on-the-fly和offline的两种插桩模式。本次主要使用在java -jar xx.jar启动的时候加入参数(on-the-fly)

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

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

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

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

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

圈复杂度:在(线性)组合中,计算在一个方法里面所有可能路径的最小数目,缺失的复杂度同样表示测 试案例没有完全覆盖到这个模块。

二、必备环境

本篇基于Windows下使用:

1、ant 环境

所有版本:https://downloads.apache.org/ant/binaries/

本篇直接点击此链接下载:https://downloads.apache.org/ant/binaries/apache-ant-1.9.15-bin.zip   下载后直接解压:

注意Windows后缀为.zip,如:apache-ant-1.9.15-bin.zip

设置环境变量:

①将bin、lib目录添加至环境变量中的系统变量path即可,如下图我的解压路径:

D:\apache-ant-1.9.15\bin
D:\apache-ant-1.9.15\lib

 ②cmd验证环境:

cmd输入:ant -v

如下图即可显示ant的版本为:1.9.15

2、jacoco

全部版本下载地址:https://repo1.maven.org/maven2/org/jacoco/jacoco/

可在我网盘中下载链接:https://pan.baidu.com/s/19evt3K1eo1y7GeeyggD5Hg 提取码:gsxl 

强烈推荐clone git:https://github.com/git-gsxl/jacoco-demo.git

随你自己解压到哪个目录,

3、java.jar 与 build.xml 文件 

文件在网盘中下载链接:https://pan.baidu.com/s/19evt3K1eo1y7GeeyggD5Hg 提取码:gsxl 

强烈推荐clone git:https://github.com/git-gsxl/jacoco-demo.git

4、配置build.xml文件

①配置 jacocoant.jar 文件路径;

②配置源码路径

③配置server_ip

④其它自行根据所需配置

三、启动 jar 服务

1、在 jar 包cmd下输入启动命令:java -javaagent:F:/jacoco-0.8.6/lib/jacocoagent.jar=includes=*,output=tcpserver,port=9999,address=127.0.0.1,append=true -jar demo-V1024.jar

通过javaagentJavaAgent会监听服务器端设置的TCP port,然后把收集到的信息(jacoco.exec)写入TCP connection,所以服务不需要关闭。

C:\Users\Administrator\Desktop\jacoco-demo>java -javaagent:F:/jacoco-0.8.6/lib/jacocoagent.jar=includes=*,output=tcpserver,port=9999,address=127.0.0.1,append=true -jar demo-V1024.jar

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.3.4.RELEASE)

2020-10-24 18:08:50.125  INFO 13264 --- [           main] c.s.j.jacocodemo.JacocodemoApplication   : Starting JacocodemoApplication vV1024 on WIN-Q3LSDAOKUJ1 with PID 13264 (C:\Users\Administrator\Desktop\jacoco-demo\demo-V1024.jar started by Administrator in C:\Users\Administrator\Desktop\jacoco-demo)
2020-10-24 18:08:50.133  INFO 13264 --- [           main] c.s.j.jacocodemo.JacocodemoApplication   : No active profile set, falling back to default profiles: default
2020-10-24 18:08:53.933  INFO 13264 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
2020-10-24 18:08:53.989  INFO 13264 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2020-10-24 18:08:53.989  INFO 13264 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.38]
2020-10-24 18:08:54.195  INFO 13264 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2020-10-24 18:08:54.222  INFO 13264 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 3949 ms
2020-10-24 18:08:54.748  INFO 13264 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Initializing ExecutorService 'applicationTaskExecutor'
2020-10-24 18:08:55.272  INFO 13264 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2020-10-24 18:08:55.301  INFO 13264 --- [           main] c.s.j.jacocodemo.JacocodemoApplication   : Started JacocodemoApplication in 6.268 seconds (JVM running for 7.3)

2、运行 ant 命令

在此之前我们在浏览器上访问我们的服务,ip+prot (既我已经访问了hello的方法,业务测试覆盖了hello方法)

①ant dump

C:\Users\Administrator\Desktop\jacoco-demo>ant dump
Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre1.8.0_151\lib\tools.jar
Buildfile: C:\Users\Administrator\Desktop\jacoco-demo\build.xml

dump:
[jacoco:dump] Connecting to /127.0.0.1:9999
[jacoco:dump] Dumping execution data to C:\Users\Administrator\Desktop\jacoco-report\jacoco-integation.exec

BUILD SUCCESSFUL
Total time: 0 seconds

C:\Users\Administrator\Desktop\jacoco-demo>

②ant report

C:\Users\Administrator\Desktop\jacoco-demo>ant report
Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre1.8.0_151\lib\tools.jar
Buildfile: C:\Users\Administrator\Desktop\jacoco-demo\build.xml

report:
    [mkdir] Created dir: C:\Users\Administrator\Desktop\jacoco-demo\jacoco-report
[jacoco:report] Loading execution data file G:\5-ppl-study-java\jacoco-demo\target\coverage\jacoco-integation.exec
[jacoco:report] Writing bundle 'Check Order related' with 2 classes

BUILD SUCCESSFUL
Total time: 0 seconds

四、查看覆盖率报告

 1、在jacoco-report目录下打开,index.html即可

 2、点击进入 controller 查看详情

 可以发现与我们上述所示的一致,只覆盖hello方法。剩下看你们了,去试试运行其它方法,再执行ant,再查看报告。

 欢迎来大家QQ交流群一起学习:482713805