Jacoco覆盖率工具使用(已测试)

笔者踩了很多坑,然后总结以下的研究结果。转载请注明出处,谢谢啦!

1两种方式

1.1 eclipse直接安装插件测试

install new soft 安装插件 eclemma java code coverage

运行

结果

插件导出单元测试报告

1.2 通过maven加入插件,打印单元测试报告

pom.xml文件中加入对应的部分,plugin部分

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0modelVersion>
    <groupId>cn.whxgroupId>
    <artifactId>jacoco-testartifactId>
    <version>0.0.1-SNAPSHOTversion>

    <dependencies>
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>4.11version>
            <scope>compilescope>
        dependency>
    dependencies>
    <build>
          <plugins>
            <plugin>
                <groupId>org.jacocogroupId>
                <artifactId>jacoco-maven-pluginartifactId>
                <version>0.7.1.201405082137version>
                <executions>
                    <execution>
                        <goals>
                            <goal>prepare-agentgoal>
                        goals>
                    execution>
                    <execution>
                        <id>reportid>
                        <phase>prepare-packagephase>
                        <goals>
                            <goal>reportgoal>
                        goals>
                    execution>
                executions>
            plugin>
        plugins>
    build>
project>

maven clean package 即可有报告 在target文件中 site index.html

结果

注:有时候你会发现会爆出这个问题Skipping JaCoCo execution due to missing execution data file,大多数原因是因为没有编译测试类,可以使用 clean package -Dmaven.test.skip=false

2.关于检测指标

(可大概理解其意思,英文网址附上)
http://www.eclemma.org/jacoco/trunk/doc/counters.html

Instructions (C0 Coverage)

  • 主要是计算字节码文件的覆盖率。

Branches (C1 Coverage)

  • JaCoCo也计算分支覆盖所有if和 switch语句。主要是计算分支的。
  • 没有覆盖:在该行没有分支机构已执行(红钻)
  • 部分覆盖:只有在该行分支机构的一部分已经被执行(黄钻)
  • 全覆盖:在该行各分支机构已执行(绿钻)

Cyclomatic Complexity

  • 圈复杂度(Cyclomatic Complexity)是一种代码复杂度的衡量标准。它可以用来衡量一个模块判定结构的复杂程度,数量上表现为独立现行路径条数,也可理解为覆盖所有的可能情况最少使用的测试用例数。圈复杂度大说明程序代码的判断逻辑复杂,可能质量低且难于测试和维护。程序的可能错误和高的圈复杂度有着很大关系。请注意,JaCoCo不考虑异常处理的分支机构try-catch块也不会增加复杂性。总体和分支正相关。实际上,过去几年的各种研究已经确定:一个方法的圈复杂度(或 CC)大于 10 的方法存在很大的出错风险。
  • 关于圈复杂度的理解,可以看以下链接。

  • http://blog.csdn.net/lg707415323/article/details/7790660

  • http://www.ibm.com/developerworks/cn/java/j-cq03316/

  • 以及一个图

Lines

  • 主要计算基于覆盖的实际源代码行类和源文件行覆盖。通常会标识三种状态。
  • 没有覆盖:在该行任何指令执行(红色背景)
  • 部分覆盖:只有在该行的指示的一部分已经被执行(黄色背景)
  • 全覆盖:在该行的所有指令已执行(绿色背景)

Methods

  • 每个非抽象方法包含至少一个指令。构造函数和静态初始化都算作方法。

4.完整例子

**先贴上代码
被测试类:**

package utils;

import java.math.BigDecimal;

/**
 * 安全转换钱的单位
 * 
 * @author rutine
 * @time Apr 28, 2015 3:52:18 PM
 */
public class MoneyUtil {


    /**
     * 
     * 功能说明 : 安全转换double类型, 将单位元的钱转为分
     *     如: 19.9(元), 最终结果: 1990(分)
     * 
* * @param money 金额(元) * @return */
public static int getFenMoney(String money) { BigDecimal hundred = new BigDecimal(100); BigDecimal decimalMoney = new BigDecimal(money); return decimalMoney.multiply(hundred).intValue(); } /** * 功能说明 : 获取单价, 保留小数点两位数 * * @param money 总金额(元) * @param quantity 数量 * @return */ public static double getUnitMoney(String money, int quantity) { if ("50".equals(money)) { System.out.println("branch1"); }else if ("60".equals(money)) { System.out.println("branch2"); }else if ("70".equals(money)) { System.out.println("branch3"); }else { System.out.println("other branch"); } BigDecimal decimalMoney = new BigDecimal(money); BigDecimal unitMoney = decimalMoney.divide(new BigDecimal(quantity), 2, BigDecimal.ROUND_HALF_UP); return unitMoney.doubleValue(); } }

测试类:

package test;

import org.junit.Test;

import utils.MoneyUtil;

public class TestMoney {

    @Test
    public void testGetUnitMoney(){
        MoneyUtil.getUnitMoney("50", 2);
        MoneyUtil.getUnitMoney("60", 2);
        MoneyUtil.getUnitMoney("70", 2);
        MoneyUtil.getUnitMoney("75", 2);
    }
}

测试结果,指标分析

这一项指标instructions,指的是字节码文件的行数。18/62的意思是 18为未执行的指令行数,62为总指令行数。

这一项指标branches,指的是分支的覆盖情况。0/6中0为未执行的分支行数,6为总分支行数。这里else不会计入到分支行数中。但是如果你不写else,则覆盖率不会为100%。

这一项指标,为圈复杂度。missed 为未测试的数量,cxty为总数。

我们来看看这个圈复杂度为啥是4

简单的画个控制流图

v=e-n+2 8条边 - 6个节点 + 2 = 4

这一项指标,为行的覆盖情况。missed 为未测试的数量,lines为总数。

同样的,看看这个例子

正好是10行。未检测的是0行。

这一项指标,为方法的覆盖情况。missed 为未测试的数量,methods为总数。

最后,请注意,覆盖率达到100%,不代表你的程序就ok了!

你可能感兴趣的:(java)