JCoverage使用简明手册

原创 2004年06月03日 16:58:00
    不论TestCase写的多么的好和完善,要想确保被测试的代码每一行都被执行,仍然是非常困难的。为了获取关于这方面的信息,我们可以使用JCoverage<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

使用目的

JCoverage正如其名,主要用于代码的覆盖测试。通过在被测试类的二进制文件中添加相应的指令,再配合junitjcoverage可以给出被测试类的代码覆盖率,并给出测试过程中哪些语句被执行,哪些没有。通过这些信息,我们可以了解测试代码的测试质量,以及被测试类中哪些语句需要特别的关注(即那些未被覆盖的语句)。

当前的版本是1.0.5,可以从www.jcoverage.com/downloads.html下载。在实际使用时,需要将jcoverage用到的类放到对应的classpath中。在这个版本中它所依赖的外部类以及版本:

- bcel    5.1     http://jakarta.apache.org/bcel/

- log4j   1.2.8    http://jakarta.apache.org/log4j/

- getopt  1.0.9    http://gnu.org/

- oro     2.0.7   http://jakarta.apache.org/oro/

 

用法

1.       jcoverage可以和ant配合使用,使这一过程自动化。基本用法:

-          编译被测试类和相应的被测试类的junit代码。

-          使用<instrument>,将jcoverage的指令加入到被测试类的二进制文件中。为了保证这一过程能够有效,请在编译被测试类时,设置<javac>debug属性设为yes

-          执行junit代码进行代码覆盖测试。这一步需要注意的是,需要将被注入指令的测试类要早于单元测试所需的测试类装入。为了确保这一点,需要使用<classpath>,使注入指令的测试类位于测试类之前

-          使用<report>产生覆盖测试的报告。

2.       使用例子:

<!-- 采用debug模式编译被测试类 -->

<javac destdir="${dist.coverage.classes}" deprecation="on" debug="yes">

<src path="${src.code}"/>

    <classpath refid="classpath"/>

</javac>

<!-- 编译被测试类的junit代码 -->

<javac destdir="${dist.coverage.junit}" deprecation="on">

    <src path="${src.junit}"/>

    <classpath refid="classpath"/>

</javac>

<!-- 定义jcoverage任务 -->

<path id="jcoverage">

        <fileset dir="junit_lib">

               <include name="jcoverage.jar"/>

        </fileset>

    </path>

<taskdef classpathref="jcoverage" resource="tasks.properties"/>

<!-- 给被测试类二进制代码中注入jcoverage的指令 -->

<instrument todir="${dist.coverage.instrument}">

        <classpath refid="classpath"/>

    <!-- 忽略org.apache.common的应用 -->

    <ignore regex="org.apache.common.*"/>

 

    <fileset dir="${dist.coverage.classes} ">

        <include name="**/*.class"/>

    </fileset>

</instrument>

<!-- 启动junit,进行代码覆盖测试 -->

<junit printsummary="yes" haltonfailure="no" fork="yes">

    <classpath>

        <!-- 注意:被注入指令的类,位置在测试类之前。

这样确保它们早于测试类备加载,使指令起作用。 -->

        <pathelement location="${dist.coverage.instrument}"/>

        <path refid="classpath"/>

        <pathelement location="${dist. coverage.junit}"/>

    </classpath>

 

    <formatter type="xml"/>

 

        <batchtest todir="${doc.jcoverageReport}">

         <fileset dir="${src.junit}" includes="**/*Test.java" />

     </batchtest>

</junit>

<!-- 产生代码覆盖测试报告 -->

<report srcdir="${src.code}" destdir="${doc.jcoverageReport}">

3.       jcoverage提供的ant任务标签有:

-          <instrument>,在类的二进制文件中注入jcoverage指令。注意:一定是debug模式下编译的类。

-          <report>,产生jcoverage报告,默认格式是HTML。也可以产生XML格式方便应用客户自定义的xslt产生其他格式的报告。产生XML格式的报告:

<report srcdir="${src.code}" destdir="${doc.jcoverageReport}" format="xml">

-          <merge>,整合多个由jcoverage产生的输出文件。整个jcoverage实际的运作过程是:首先,jcoverage给测试类注入指令产生新类,被注入指令的类在junit运行过程中产生输出文件(后缀为ser),最后根据输出文件产生报告。如果有多个输出文件,jcoverage提供了<merge>来整合这些文件,最后,从整合文件中产生整体报告。用法:

<merge>

<fileset dir="${basedir}">

<include name="**/jcoverage.ser"/>

</fileset>

</merge>

-          <check>,检查测试是否达到设定的标准,它可以和<report>配合使用。使用例子:

例1 

<check branch="95" line="95"/>,意思是分支覆盖率需要达到95%,行覆盖率达到95%

例2 

 

<check branch="95" line="95">

    <regex pattern="xptoolkit.jcoverage.*" branch="85" line="95"/>

</check>

包名符合xptoolkit.jcoverage.*模式的分支覆盖率达到85%,行覆盖率达到95%其余的分支覆盖率需要达到95%,行覆盖率达到95%

检查表

       在使用jcoverage时需要注意的问题:

-          jcoverage注入指令的类必须是在debug模式下编译的类。建议将那些使用debug模式编译的类的存放与最终的产品的目录分开。

-          使用了<instrument>的类,与源类的目录也最好分开。

-          对于那些使用了AOP(如AspectJ)技术的项目,jcoverage不能很好的应用到那些已经添加了Aspect信息的类。

-          代码覆盖工具只是给出了指导性的意见,不要过分依赖和相信它的结果。

Org-mode简明手册

csdn Table of Contents 1. 简介 1.1. 序 #+title Org-mode 简明手册 1 简介1 1.1 序 Org是一个用文本方式来快速高效地做笔...
  • diyoosjtu
  • diyoosjtu
  • 2015年04月10日 16:43
  • 1085

基于STM32的Doxygen使用简明手册

基于STM32的Doxygen使用简明手册 为了能使代码能够被Doxygen识别,必须遵循Doxygen的书写规则。注释必须以/**打头,以*/结束。 一、添加类型 1、  添加首页(mainp...
  • zhenghangming
  • zhenghangming
  • 2012年05月21日 09:44
  • 1196

Git超级简明手册

Git超级简明手册,是一篇完整覆盖从git服务器搭建到使用的完整实战参考手册。一册在手,git无忧!...
  • shendl
  • shendl
  • 2015年12月10日 12:46
  • 4475

Greenplum使用简明手册

GP服务启停 su - gpadmin gpstart #正常启动 gpstop #正常关闭 gpstop -M fast #快速关闭 gpstop –r #重启 gpstop –u #重...
  • echollee
  • echollee
  • 2011年10月09日 13:11
  • 2014

EasyMock使用简明手册

    在实际编写unit test的过程中,很多情况下我们会需要使用其他的组件(如和数据库相关的测试)。当我们是使用第三方提供的组件时,这并不是太大的问题,因为我们可以假设他们是无错的。但是一旦这些...
  • foxgemm
  • foxgemm
  • 2004年06月03日 16:57
  • 1728

cppcheck使用简明手册

1.       安装cppcheck  http://cppcheck.sf.net/2.       安装Pygments (http://pypi.python.org/pypi/Pygment...
  • linkyou
  • linkyou
  • 2010年11月23日 20:28
  • 3517

StrutsTest使用简明手册

      Struts是目前在web开发中广泛使用的几个框架之一,而StrutsTest正是专门负责测试strut应用程序的Mock测试框架。使用目的       StrtusTest是junit的...
  • foxgemm
  • foxgemm
  • 2004年06月03日 16:57
  • 1007

Junit 使用简明手册

在使用XP进行开发的过程,unit test是必不可少的环节。作为unit test,junit是首选的工具。本文从使用目的、如何使用、以及使用中需要考虑的问题,简略描述了junit的基本用法。使用目...
  • kauu
  • kauu
  • 2006年08月14日 14:12
  • 685

JunitPerf使用简明手册

    代码效率对于许多开发者而言是一个非常关心的指标。而且,代码执行效率的高低对于应用的使用者来说是感觉最直观的。它往往也是一个应用是否成功的关键性指标之一。那么是否存在那些能够反映代码执行效率的工...
  • foxgemm
  • foxgemm
  • 2004年06月03日 16:57
  • 1137

JunitPerf使用简明手册

代码效率对于许多开发者而言是一个非常关心的指标。而且,代码执行效率的高低对于应用的使用者来说是感觉最直观的。它往往也是一个应用是否成功的关键性指标之一。那么是否存在那些能够反映代码执行效率的工具呢?我...
  • haydenwang8287
  • haydenwang8287
  • 2007年12月17日 18:10
  • 542
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:JCoverage使用简明手册
举报原因:
原因补充:

(最多只允许输入30个字)