代码覆盖率系列（一）：jacoco使用

jacoco工具主要包含：

jacocoagent.jar，jacocoant.jar，jacococli.jar

jacocoagent.jar是一个代理程序，用来搜集执行信息，在请求或者JVM退出的时候生成代码覆盖率数据

jacocoant.jar是在ant项目任务中加入jacoco，在启动Java程序，记录数据并能创建覆盖率报告，通过coverage， agent， dump和 merge。report等任务会创建不同格式的报告

jacococli.jar提供了一些命令行接口，生成exec文件、合并或生成html报告等

jacoco使用的方法有三种：

1：ant任务方式不常用，且需要配置环境，所以未考虑这种方法。
2：maven插件
  这种方式主要是在maven 生命周期中统计代码覆盖率，主要用于单元测试。
3：jacoco agent
这种方式可以在程序运行时，进行统计代码覆盖率。接口测试、自动化测试等都可使用。目前我的需求是统计某个服务的代码覆盖率，测试是通过接口测试完成，服务与测试代码是分离的，所以主要使用这种方式。

我们主要讲第三种方式：

第一步：下载jacoco，包含jacocoagent.jar和jacococli.jar

第二步：在java程序启动的时候，带上参数，例如：
java -javaagent:jacocoagent.jar=includes=com.*,classdumpdir=classes,output=tcpserver,port=6300,address=localhost,append=true -jar SpringBootBase.jar
解释：
includes：包含com开头的类名
classdumpdir：类文件存储的目录
output：tcpserver方式，通过address和端口获取数据
append：true是执行数据文件已经存在，则覆盖数据将附加到现有文件

我的java应用程序是：SpringBootBase.jar
jacocoagent 命令参数参考：https://www.jacoco.org/jacoco/trunk/doc/agent.html

第三步：生成exec文件，命令如下：
java -jar jacococli.jar dump --address localhost --port 6300 --destfile /app/SpringBootBase/bin/jacoco/jacoco.exec
destfile是指生成exec文件保存的目录

第四步：生成HTML报告，命令如下：
java -jar jacococli.jar report /app/SpringBootBase/bin/jacoco/jacoco.exec --classfiles /var/lib/jenkins/workspace/SpringBootBase/target/classes --sourcefiles /var/lib/jenkins/workspace/SpringBootBase/src/main/java --html /app/SpringBootBase/bin/jacoco/report_html
classfiles 编译文件存放目录，maven 项目是target下
sourcefiles 原文件存放目录，maven项目是 src\main\java
sourcefiles 可以不传,不传的话 覆盖率报告到文件级的展示,再细，需要具体代码和行数就需要传sourcefiles
生成报告后，点击进入index.html可查看