【转载收藏】使用Jacoco远程统计tomcat服务的代码覆盖率

在做软件开发的时候经常会遇到做各种测试，这里介绍一种本人遇到的：代码覆盖率测试，

这个测试非常实用，能发现许多无效的模块和代码。强烈推荐！！！！！

网上好多资料都不全，而且没有详细的配置流程

本文将简单介绍如何使用Jacoco生成远程tomcat服务的覆盖率报告。

(注：使用jacoco打开远程服务端口，有一定安全风险。)

软件安装

Ant

Jacoco

远程Tomcat服务配置

1:sh shutdown.sh先关闭tomcat服务。

2:修改bin/catalina.sh中JAVA_OPTS的配置。

# -javaagent: 的后面跟jacoco的安装路径
# includes= 选项，选择你要覆盖率的服务
# port= 选项，选择你要打开的端口
# address= 选项，tomcat服务所在机器的ip地址（如果想在跟tomcat服务同一台机器上执行ant任务的话，需要改为127.0.0.1）
JAVA_OPTS="-javaagent:/path/to/your/jacoco_0.6.4/lib/jacocoagent.jar=includes=com.baidu.*,output=tcpserver,port=8893,address=10.81.14.77"

3: sh startup.sh重新启动tomcat服务。

如果发现启动主程序异常，那么在JAVA_OPTS 配置中国再加一项-Xverify:none

JAVA_OPTS="-javaagent:/path/to/your/jacoco_0.6.4/lib/jacocoagent.jar=includes=com.baidu.*,output=tcpserver,port=8893,address=10.81.14.77 -Xverify:none"

本地Ant任务配置

配置build.xml。

<?xml version="1.0" ?>
<project name="Lengyu" xmlns:jacoco="antlib:org.jacoco.ant" default="jacoco">
    <!--Jacoco的安装路径-->
  <property name="jacocoantPath" value="/home/work/software/jacoco_0.6.4/lib/jacocoant.jar"/>
  <!--最终生成.exec文件的路径，Jacoco就是根据这个文件生成最终的报告的-->
  <property name="jacocoexecPath" value="/home/work/local/hudson_home/workspace/wg_merchant_oc_regression/jacoco.exec"/>
    <!--生成覆盖率报告的路径-->
  <property name="reportfolderPath" value="E:/Libs/coverage_ant_task/report/"/>
  <!--远程tomcat服务的ip地址-->
  <property name="server_ip" value="10.81.14.77"/>
  <!--前面配置的远程tomcat服务打开的端口，要跟上面配置的一样-->
  <property name="server_port" value="8893"/>
  <!--源代码路径-->
  <property name="checkOrderSrcpath" value="E:/Src/ordercenter/ordercenter-biz/src/main/java/" />
  <!--.class文件路径-->
  <property name="checkOrderClasspath" value="E:/Src/ordercenter/ordercenter-biz/target/classes/com/baidu/ordercenter/service/Impl" />

  <!--让ant知道去哪儿找Jacoco-->
  <taskdef uri="antlib:org.jacoco.ant" resource="org/jacoco/ant/antlib.xml">
      <classpath path="${jacocoantPath}" />
  </taskdef>

  <!--dump任务:
      根据前面配置的ip地址，和端口号，
      访问目标tomcat服务，并生成.exec文件。-->
  <target name="dump">
      <jacoco:dump address="${server_ip}" reset="false" destfile="${jacocoexecPath}" port="${server_port}" append="true"/>
  </target>
  
  <!--jacoco任务:
      根据前面配置的源代码路径和.class文件路径，
      根据dump后，生成的.exec文件，生成最终的html覆盖率报告。-->
  <target name="report">
      <delete dir="${reportfolderPath}" />
      <mkdir dir="${reportfolderPath}" />
      
      <jacoco:report>
          <executiondata>
              <file file="${jacocoexecPath}" />
          </executiondata>
              
          <structure name="JaCoCo Report">
              <group name="Check Order related">           
                  <classfiles>
                      <fileset dir="${checkOrderClasspath}" />
                  </classfiles>
                  <sourcefiles encoding="gbk">
                      <fileset dir="${checkOrderSrcpath}" />
                  </sourcefiles>
              </group>
          </structure>

          <html destdir="${reportfolderPath}" encoding="utf-8" />         
      </jacoco:report>
  </target>
</project>

生成覆盖率报告

执行ant dump。成功的话，应会有如下输出。

[work@st01-ecom-jn2.st01.baidu.com ant]$ ant dump
Buildfile: /home/work/local/hudson_home/workspace/wg_merchant_oc_regression/ant/build.xml

dump:
[jacoco:dump] Connecting to /10.81.14.77:8893
[jacoco:dump] Dumping execution data to /home/work/local/hudson_home/workspace/wg_merchant_oc_regression/jacoco.exec

BUILD SUCCESSFUL
Total time: 0 seconds

最后执行ant report。jacoco就会在你指定的路径生成覆盖率报告了。

附录

更多关于Jacocoagent以及各种task可以参考官方文档

Jenkins的Jacoco plugin可以根据.exec文件直接生成覆盖率报告，并在Jenkins中生成图表等等。那样的话，ant report这个任务就没用了。

原文链接：https://my.oschina.net/91jason/blog/491171?p=totalPage%7D%7D%EF%BC%89JaCoCo%E8%BF%98%E6%9C%89maven%E4%BB%A5%E5%8F%8Asonar%E7%9A%84%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95%EF%BC%8C%E8%BF%99%E8%BE%B9%E4%B8%8D%E4%BB%8B%E7%BB%8D%EF%BC%8C%E5%9B%A0%E4%B8%BA%E8%87%AA%E5%B7%B1%E4%B9%9F%E6%B2%A1%E7%A0%94%E7%A9%B6%E9%80%8F%EF%BC%8C%E5%8F%AF%E4%BB%A5%E7%99%BE%E5%BA%A6%E6%88%96%E8%80%85google%E4%B8%8B%E3%80%82%E5%8F%8B%E6%83%85%E6%8F%90%E9%86%92%EF%BC%9AJaCoCo%E5%8F%AA%E9%80%82%E7%94%A8%E4%BA%8EJava