目录

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 coverage runner -> 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构建

可以阅读jacoco统计自动化代码覆盖率这篇博客学习

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

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

        Windows下在cmd窗口使用WMIC命令，回车

        回显：wmic:root\cli>

        在>后面输入：process where name="java.exe"  命令

        查看回显信息

4. Linux下载终端窗口中输入ps -ef | grep tomcat

5. 以Tomcat为例进行使用指令：

   java -jar jacococli.jar dump --address 192.168.43.100 --port 9527 --destfile ./jacoco.exec

   即可生成exec文件