目录

jacoco简单介绍

idea使用jacoco简单步骤

ANT构建

TOMCAT构建

准备工作

Tomcat配置

jacoco简单介绍

Jacoco是一个开源的覆盖率工具。Jacoco可以嵌入到Ant 、Maven中，并提供了EclEmma Eclipse插件,也可以使用JavaAgent技术监控Java程序。很多第三方的工具提供了对Jacoco的集成，如sonar、Jenkins等。

官网地址：EclEmma - JaCoCo Java Code Coverage Library

Jacoco包含了多种尺度的覆盖率计数器,包含指令级(Instructions,C0coverage)，分支（Branches,C1coverage）、圈复杂度(CyclomaticComplexity)、行(Lines)、方法(non-abstract methods)、类(classes)。

  1. 行覆盖率：度量被测程序的每行代码是否被执行，判断标准行中是否至少有一个指令被执行。
  2. 类覆盖率：度量计算class类文件是否被执行。
  3. 分支覆盖率：度量if和switch语句的分支覆盖情况，计算一个方法里面的总分支数，确定执行和不执行的分支数量。
  4. 方法覆盖率：度量被测程序的方法执行情况，是否执行取决于方法中是否有至少一个指令被执行。
  5. 指令覆盖：计数单元是单个java二进制代码指令，指令覆盖率提供了代码是否被执行的信息，度量完全 独立源码格式。
  6. 圈复杂度：在（线性）组合中，计算在一个方法里面所有可能路径的最小数目，缺失的复杂度同样表示测 试案例没有完全覆盖到这个模块。

目前支持的启动类型：

  • Local Java application java程序(有main)
  • Eclipse/RCP application 桌面应用程序
  • Equinox OSGi framework
  • JUnit test 单元测试
  • TestNG test
  • JUnit plug-in test
  • JUnit RAP test
  • SWTBot test
  • Scala application

idea使用jacoco简单步骤

  1. 选择edit configuration -> code coverage->choose coveragerunner -> jacoco
  2. 引入jacoco的依赖jar包 
<dependency>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.7.8</version>
</dependency>

配置jacoco插件以及相关goal

<plugin>
        <groupId>org.jacoco</groupId>
        <artifactId>jacoco-maven-plugin</artifactId>
        <version>0.7.8</version>　　　　<!--这里的execution ,每一个执行的goal,对应的id必须是唯一的-->
        <executions>
            <execution>
                <id>prepare-agent</id>
                 <goals>
                     <goal>prepare-agent</goal>
                 </goals>
            </execution>　　　　　　　　<!--这个check:对代码进行检测，控制项目构建成功还是失败-->
             <execution>
                 <id>check</id>
                  <goals>
                      <goal>check</goal>
                   </goals>
            </execution>　　　　　　　　<!--这个report:对代码进行检测，然后生成index.html在 target/site/index.html中可以查看检测的详细结果-->
            <execution>
                 <id>report</id>
                 <phase>prepare-package</phase>
                 <goals>
                     <goal>report</goal>
                 </goals>
            </execution>
         </executions>
 </plugin>

           配置 代码检查的约束rules

<!-- Configuration 里面写配置信息 -->
 <configuration>
     <!-- rules里面指定覆盖规则 -->
     <rules>
       <rule implementation="org.jacoco.maven.RuleConfiguration">
         <element>BUNDLE</element>
         <limits>
        　　<!-- 指定方法覆盖到80% -->
           <limit implementation="org.jacoco.report.check.Limit">
              <counter>METHOD</counter>
              <value>COVEREDRATIO</value>
              <minimum>0.80</minimum>
           </limit>
           <!-- 指定指令覆盖到80% -->
           <limit implementation="org.jacoco.report.check.Limit">
              <counter>INSTRUCTION</counter>
              <value>COVEREDRATIO</value>
              <minimum>0.80</minimum>
           </limit>
           <!-- 指定行覆盖到80% -->
           <limit implementation="org.jacoco.report.check.Limit">
             <counter>LINE</counter>
             <value>COVEREDRATIO</value>
             <minimum>0.80</minimum>
           </limit>
           <!-- 指定类覆盖到100%，不能遗失任何类 -->
           <limit implementation="org.jacoco.report.check.Limit">
             <counter>CLASS</counter>
             <value>MISSEDCOUNT</value>
             <maximum>0</maximum>
           </limit>
         </limits>
      </rule>
   </rules></configuration>

3.在右栏maven中选择lifecycle -> test，这一步可以生成exec文件，但是不能打开，故不能直观看     到报告

   然后plugins -> jacoco -> jacoco:report  生成报告

  

操作完成后会在左侧文件结构中看到target中多出一个site文件夹，打开就可以看到html报告

ANT构建


TOMCAT构建

准备工作

下载jacoco，进入jacoco官网:http://www.eclemma.org/jacoco/ 

保证当前JDK在1.5以上

获取到jacoco包jacoco-0.8.2.zip：

Tomcat配置

  1. 关闭Tomcat, window是shutdown.bat扩展名、Linux是shutdown.sh扩展名
  2. 1 修改Windows下catalina.bat，在第二行添加如下脚本： 
set JAVA_OPTS=-javaagent:D:\JAR\jacoco-0.8.2\lib\jacocoagent.jar=includes=*,output=tcpserver,port=9527,address=127.0.0.1,append=true -Xverify:none

  2 Linux修改catalina.sh，在第二行添加如下脚本：

JAVA_OPTS="-javaagent:/home/systemtools/jacoco-0.8.2/lib/jacocoagent.jar=includes=*,output=tcpserver,port=9527,address=192.168.43.100,append=true -Xverify:none"

3 启动Tomcat，Windows下使用startup.bat，Linux下使用startup.sh

  1. 验证JAVA_OPTS是否有修改正确

         Windows下在cmd窗口使用WMIC命令，回车
         回显：wmic:root\cli>
         在>后面输入：process where name="java.exe"  命令
         查看回显信息
  2. Linux下载终端窗口中输入ps -ef | grep tomcat
  3. 以Tomcat为例进行使用指令：
java -jar jacococli.jar dump --address 192.168.43.100 --port 9527 --destfile ./jacoco.exec

即可生成exec文件