3.4. 关于验证报告
验证报告提供有关测试规则和失败的详细信息,并包含以下部分:
概述
本节包含测试运行总数并报告错误和失败的数量。它显示总成功率以及生成报告的时间(以秒为单位)。
软件包列表
本节包含为每个软件包执行的测试数量,并报告错误和失败的数量。它显示成功率以及要分析的每个软件包的时间(以秒为单位)。
此时会显示一个名为
org.jboss.windup.rules.tests
的软件包,除非定义了额外的测试案例。测试问题单
本节描述了测试问题单。每个失败都包含一个 Details 部分,可用于显示断言堆栈 trace,包括可表示错误源的人类可读行。
3.4.1. 创建验证报告
您可以为自定义规则创建验证报告。
先决条件
- 您必须分叉并克隆 MTA XML 规则。
- 您必须具有一个或多个测试 XML 规则才能进行验证。
流程
-
进入到本地
windup-rulesets
存储库。 -
为您的自定义规则和测试创建一个目录:
windup-rulesets/rules-reviewed/myTests
。 -
将自定义规则和测试复制到
windup-rulesets/rules-reviewed/<myTests>
目录中。 从
windup-rulesets
存储库的根目录中运行以下命令:$ mvn -Dtest=WindupRulesMultipleTests -DrunTestsMatching=<myTests> clean <myReport>:report 1 2
验证报告在
windup-rulesets/target/site/
仓库中创建。
3.4.2. 验证报告错误消息
验证报告包含运行规则和测试时遇到的错误。
下表包含错误消息以及如何解决错误。
错误消息 | 描述 | 解决方案 |
---|---|---|
没有与规则匹配的测试文件 | 当规则文件没有对应的测试文件时,会发生此错误。 | 为现有规则创建测试文件。 |
测试规则 Ids <RULE_NAME> 没有找到! | 当规则存在但没有对应的 ruletest 时,会抛出此错误。 | 为现有规则创建测试。 |
XML 解析在文件 <FILE_NAME> 上失败 | XML 文件中的语法无效,无法通过规则验证器成功解析。 | 更正无效的语法。 |
未找到来自 |
测试规则中 |
创建 |
未执行带有 id="<RULE_ID>" 的规则。 | 在此验证过程中没有执行具有提供的 id 的规则。 | 确保存在与指定规则中定义的条件匹配的测试数据文件。 |