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

前言

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