一、概述
Jacoco是一个开源覆盖率工具,支持分支覆盖,基于JAVA,可嵌入到Ant、Maven,引入了Agent模式,可以使用其JavaAgent技术监控Java程序等;
参考文档:https://blog.csdn.net/qq_26392615/article/details/82228972
参考文档:https://www.aliyun.com/jiaocheng/839260.html
二、环境准备
1.Jacoco 安装(官网下载,unzip jacoco-0.8.2.zip)
2.Ant 安装 (官网下载,unzip apache-ant-1.10.5-bin)
3.JDK安装(已安装1.8)
4.配置环境变量 vim ~/.bash_profile并source;
5.export ANT_HOME=/usr/local/src/apache-ant-1.10.5
6.PATH=$PATH:$ANT_HOME/bin
三、上传源码并启动项目服务
1.上传源码到服务器(10.1.132.187)
将本地classroom-api 项目的源码以及编译后的.class文件和项目的jar包上传到服务器;
scp -r /Users/susan/classroom-api root@10.1.132.187:/home/jacocodata/jacocoSrc
scp classroom-api.jar root@10.1.132.187:/data0/webroot/classroom-api/
2.启动服务
检查端口占用情况: netstat -tunlp | grep 8091
nohup java -javaagent:/opt/jacoco/lib/jacocoagent.jar=includes=com.dadaabc.classroom.api.*,output=tcpserver,port=8091,address=127.0.0.1 -jar /data0/webroot/classroom-api/classroom-api.jar > /data0/logs/classroom-api/20181210.log 2>&1 &
四、编辑jacocoant.xml
jacocoant.xml 展开源码
五、调用接口并生成报告
测试用例执行完毕后,执行 ant -f jacocoant.xml 命令生成报告,执行完毕后出现BUILD SUCCESSFUL 即执行成功;报告在jacocoant.xml中所配置的路径中{jacocoReportPath};
cd {jacocoReportPath}
python -m SimpleHTTPServer 9999
即可在浏览器中通过访问10.1.132.187:9999在线查看报告结果;
六、报告解读
注:一般绿色为充分覆盖,红色为未覆盖,黄色为部分覆盖,菱形指分支;
行覆盖率:度量被测程序的每行代码是否被执行,判断标准行中是否至少有一个指令被执行。
类覆盖率:度量计算class类文件是否被执行。
分支覆盖率:度量if和switch语句的分支覆盖情况,计算一个方法里面的总分支数,确定执行和不执行的 分支数量。
方法覆盖率:度量被测程序的方法执行情况,是否执行取决于方法中是否有至少一个指令被执行。
指令覆盖:计数单元是单个java二进制代码指令,指令覆盖率提供了代码是否被执行的信息,度量完全 独立源码格式。
圈复杂度:在(线性)组合中,计算在一个方法里面所有可能路径的最小数目,缺失的复杂度同样表示测 试案例没有完全覆盖到这个模块。
七、采坑池
1.安装ant后,执行ant version报类似异常:Unable to locate tools.jar.Expected to find it in /usr/lib/jvm/java-6-openjdk/lib/tools.jar
找不到tools.jar,重装jdk或者复制别的服务器上的tools.jar到异常提示下的Expected的路径;
2.nohup java -javaagent ... 执行后,Java项目服务启动报错,读取不到${ip.email.template}"
可能由于项目的环境变量DADA_ENV未读取到,检查服务器上环境变量是否配置,如已配置还报错,尝试执行下面命令指定后启动成功;
export DADA_ENV=test && nohup java -javaagent ...