36. JUnit 报表自定义

自定义! 谁不喜欢自己作品中的某些独特之处? 让我们在Apache ANT 生成的 JUnit 报告上添加一些糖霜,通过引入一些优点使其看起来更漂亮。

作为自定义自动生成报告的第一步,让我们了解其背后的代码(来自Build.xml),

<junitreport todir="junit">
    <fileset dir="junit">
        <include name="TEST-*.xml"/>
    </fileset>
    <report format="frames" todir="junit/report"/>
</junitreport>

Apache ANT 的JunitReport任务通过执行以下步骤来生成报告,

  • JUnit 任务生成的所有单个 XML 文件都被合并并命名为TESTS-TestSuites.xml
  • CSS 样式应用于合并后的文档
  • 最终的可浏览报告以 HTML 格式提供

`` 属性“todir”指定了将合并的 XML 文件保存到的目录。 如果未指定任何内容,则默认为当前目录。

<fileset dir="junit">
    <include name="TEST-*.xml"/>
</fileset>

注意所有单独的 JUnit 测试都是通过“junit” ANT 任务执行的,生成的 XML 文件的名称使用“outfile”属性指定。 如果未提及名称,则默认值为“TEST-name”(其中name是在 junit 任务的name属性中指定的测试名称)。

使用fileset元素,junitreport会从“dir”中提到的给定目录中收集所有单个 XML 文件,并根据上述代码段考虑所有以“TEST-”开头的文件。

`` 这是从合并文件生成可浏览报告的确切任务。

属性“格式”指定可用于生成报告的两种可用格式之一。 它们必须是“frames”或“noframes”。 如果未指定任何内容,则默认为“帧”格式。 “todir”属性指定生成的报告必须保存到的目录。

  • frames”格式将生成一个报告,该报告将包含具有重定向功能的多个文件,并使用样式表来实现此效果。 这是一种更具可读性的格式。
  • noframes”格式会生成一个名为“junit-noframes.html”的文件,没有任何框架,并且不使用任何类型的重定向。 这种类型更适合作为电子邮件附件发送或生成 pdf 文件。

既然您已经了解了事物的内在运作方式,那么让我们进入有趣的部分(可能比拥有圣代冰淇淋更有趣)!

与那些无聊的自动生成的报告说再见,并欢迎自定义 ! 这意味着,我们将要编写或编辑某些内容。 那就是一个 XSL 文件,它位于下载的apache-ant-1.10.2-bin.zip的“etc”目录中。 让我们走简单的路线,就是编辑!

还记得吗,我们有两种格式? 因此,要自定义:

  • 框架 – 编辑junit-frames.xsl
  • 无框架 – 编辑junit-noframes.xsl

就我而言,这两个 XSL 文件都位于“E:\apache-ant-1.10.2\etc”路径中。 作为本文的一部分,让我们研究“框架”格式。 这意味着我们将编辑“junit-frames.xsl”文件。 复制此文件并将其粘贴到项目路径中。 不要重命名文件。 为了使所有更改都能正常进行,请向报告任务添加属性styledir,如下所示。 这指定了定义的样式表junit-frames.xsl的位置。 .指定此样式表位于当前目录中(与构建文件的目录相同)。``

今天我们将深入探讨以下内容,

  • 更改标题和描述
  • 增加栈跟踪字体大小

在下面的文章中,我们还将介绍

  • 添加或删除列
  • 改变风格
  • 在标题部分添加徽标
  • 修改静态文字

注意 :因此,所有更改都是对放置在项目目录“E:\Selenium\”(其中 Selenium 中的“junit-frames.xsl”)进行的,在我的情况下是项目名称)。

更改报告标题和描述

在项目位置的“junit-frames.xsl”样式表中,

  • 将参数名称的文本(标题为TITLE)更改为“JUnit Report”。
    • 之前
      <xsl:param name="TITLE">Unit Test Results.</xsl:param>
      
    • 之后
      <!-- <xsl:param name="TITLE">Unit Test Results.</xsl:param> -->
      <xsl:param name="TITLE">JUnit Report</xsl:param>
      
  • “页眉”部分负责显示标题和右侧显示的说明。 将它们分别更改为“自定义 JUnit 报告”和“由忍者设计!”。
  • 之前
    <!-- Page HEADER -->
    <xsl:template name="pageHeader">
        <h1><xsl:value-of select="$TITLE"/></h1>
        <table width="100%">
        <tr>
            <td align="left"></td>
            <td align="right">Designed for use with <a href="http://www.junit.org/">JUnit</a> and <a href="http://ant.apache.org/">Ant</a>.</td>
        </tr>
        </table>
        <hr size="1"/>
    </xsl:template>
    
  • Before Title Customization
  • 之后
    <xsl:template name="pageHeader">
       <!-- <h1><xsl:value-of select="$TITLE"/></h1>  -->
       <h1>Custom JUnit Report<h1>
        <table width="100%">
        <tr>
            <td align="left"></td>
            <!-- <td align="right">Designed for use with <a href="http://www.junit.org/">JUnit</a> and <a href="http://ant.apache.org/">Ant</a>.</td> -->
            <td align="right">Designed by ninjas!</td>
        </tr>
        </table>
        <hr size="1"/>
    </xsl:template>
    
  • 保存更改并从 eclipse 生成 JUnit 报告。
  • Title after customization

增加栈跟踪字体大小

我们在发生故障时看到的栈跟踪信息非常小,很难读取。 为了增加其字体大小,只需在模板中添加几行名称为stylesheet.css的行即可。

<xsl:template name="stylesheet.css">
.StackTrace {
    font-size: 100%;
}

然后将该类添加到“display-failures”模板的“code”标签中,该模板负责显示栈跟踪信息。

  • 之前
    <code
        <xsl:call-template name="br-replace">
            <xsl:with-param name="word" select="."/>
        </xsl:call-template>
    </code>
    
  • Stack trace before customization
  • 之后
    <code class="StackTrace">
        <xsl:call-template name="br-replace">
            <xsl:with-param name="word" select="."/>
        </xsl:call-template>
    </code>
    
  • Stack trace after customization

现在是时候戴上帽子了。 愿 ANT 的力量与您同在。

下一节:嗨冠军! 如果您没有让之前的文章发挥您的想象力,那么我今天将帮助您做到这一点。

添加或删除列
改变风格
在标题部分添加徽标
修改静态文字