tms tck_在雅加达EE TCK中使用Arquillian的可能方法

青旅半醒 2023-02-25 03:58 41阅读 0赞

tms tck

最近，我们[讨论了][Link 1]如何创建独立的Jakarta Batch测试套件（TCK）。 对于大多数提交者而言，使用[Arquillian][]将测试从实现中如何执行抽象化是很自然的。 但是[Romain][]提出了一个有趣的想法，即使用纯JUnit5引起了我的思考。 它并没有止于思考。 经过数小时的黑客攻击后，我现在可以提出概念证明，并提出如何将普通的JUnit5用于TCK的建议，以及如何使用良好的旧Arquillian将容器与之集成，以避免重新发明轮子。

当前的独立Batch TCK的问题在于它基于[TestNG，][TestNG]并且仅支持在与测试套件相同的类路径上运行的Batch实现。 因此，它不支持在Java容器（如应用程序服务器）中运行测试。 现在，只有Jakarta测试套件（CTS）支持此类容器，该套件包含一个批处理TCK测试的副本，该测试使用专有技术在容器中运行测试。

还有其他带有独立TCK或计划创建它的Jakarta EE规范：

*  [CDI TCK][] –与Arquillian一起使用TestNG
 *  [Bean验证][Bean] –与Arquillian一起使用TestNG
 *  [JSON-B][] –正在进行中，与Arquillian一起使用JUnit 4
 *  [DI TCK][] – JUnit 4

显然Arquillian在其中很受欢迎。 只有DI TCK不使用它。 但是DI TCK本身也不支持在远程容器中执行，它仅支持设置本地容器，例如，如果实现支持，则使用CDI SE API。

我的概念证明有3个目标：

1.  改进TCK，使其可以与Java容器集成
2.  修改现有示例项目以使用TCK运行JBatch
3.  创建另一个将TCK与典型的Jakarta EE服务器（例如Payara Server）集成的示例

如果可以的话，我更喜欢循序渐进而不是爆炸式发展。 而且我意识到，即使我找到了使用JUnit 5的解决方案，无论如何我都可能需要Arquillian与Payara Server集成以实现我的第三个目标。因此，我首先在当前的Batch TCK中添加了对Arquillian的支持，后来希望重用它。将Payara Server与JUnit 5集成在一起。事实证明，这是一种很好的方法，并且不会浪费任何代码。

## 添加对Arqullian的支持 ##

在批处理TCK中添加对Arquillian的支持非常简单，因为测试已使用TestNG，而Arquillian开箱即用地支持TestNG。 唯一棘手的部分是为Arquillian所需的每个测试创建一个部署程序包。 最后，这非常容易，不需要修改测试源。 Arquillian允许创建扩展以为每个测试定义部署程序包，因此我能够将部署程序包的创建移到单独的扩展程序中。 需要在容器中运行测试的实现可以使用此扩展，但TCK本身不需要此扩展。

TCK中唯一需要的更改是更改每个测试以扩展Arquillian TestNG基类，仅此而已。

在测试套件的顶部，批处理TCK包含一个示例TCK运行器项目，该项目针对[JBatch][]实现运行TCK。 这也需要稍作更改。 我添加了Arquillian Weld SE连接器，该连接器在Weld CDI容器中运行Arquillian TestNG测试。 这意味着测试将在与测试套件相同的类路径上执行，并且不需要Arquillian部署。

您可以在这里在我的叉子上看到最终结果： [https][] : [//github.com/OndroMih/batch-tck/pull/1][https] 。 总之，我向每个TCK测试添加了一行代码，并修改了批处理TCK和JBatch的TCK运行器的pom.xml。

这使我可以创建[一个示例项目][Link 2] ，以使用远程服务器（如Payara Server）运行TCK。 这个示例项目包含我上面提到的Arquillian扩展。 此扩展使用Maven解析器库来解析项目的pom.xml文件中的JAR依赖项，并将其打包到Arquillian的WAR部署中。 它并不复杂，只需要几行代码： [MavenTestDependenciesDeploymentPackager.java][]

## 将TCK转换为JUnit5 ##

将基于TestNG的TCK转换为JUnit 5非常简单。 除了用JUnit 5等效项替换所有TestNG注释外，我还需要用标准Java JUL日志记录替换TestNG报告。

您可以在这里查看我的转换的最终结果： [https][https 1] : [//github.com/OndroMih/batch-tck/pull/2][https 1] 。 更改了TCK，并且JBatch调谐器项目也使用了它，并且运行无测试失败。 这解决了我的前2个目标。

最难的事情是将JUnit 5测试套件与Payara Server连接起来以满足我的第3个目标。 为此，我需要解决以下问题：

*  创建一个部署程序包以将测试部署到Payara Server
 *  创建一个JUnit 5扩展以在Payara Server中运行测试并向后报告结果

在上一步中，我已经使用Arquillian扩展解决了第一个问题。 似乎有一个非正式的JUnit 5扩展可以运行Arquillian测试。 是的，它确实有效，我能够将所有这些合并为最终实现我所有3个目标的解决方案。

## 使用Arquillian运行JUnit 5 TCK ##

幸运的是，Arquillian社区一直在[为JUnit 5][JUnit 5]提供[支持][JUnit 5] 。 尽管在等待仅在JUnit 5.5中添加的基本扩展点时花了一些时间，但是现在有一个非正式的[arquillian-junit5扩展][arquillian-junit5] ， [此分叉中][Link 3]有一些修复程序。

因此，我尝试将所有已经拥有的东西汇总起来，以尝试是否可以对Payara Server运行转换后的JUnit 5 Batch TCK：

*  使用JUnit 5 Batch TCK作为依赖项
 *  添加arquillian-junit5扩展名（从本地本地构建）
 *  添加我之前创建的Arquillian部署扩展
 *  将Arquillian配置为与Payara连接器一起运行，就像我之前所做的那样

因此，我做到了，启动了Payara Server，配置了必要的JDBC资源，并执行了以下操作：

Java

mvn verify

……并祈祷。

几分钟后：

Java

Results:  Tests run: 164 , Failures: 0 , Errors: 0 , Skipped: 3

一切正常！ 这包括所有TCK测试，包括要求具有Jakarta EE功能的测试，并且这些测试无法针对独立的Batch实现（如JBatch）运行。 TCK目前正在跳过这3个被跳过的测试，而不是我的配置正在跳过这些测试。

## 摘要 ##

我能够演示有多种方法可以改进现有的独立Jakarta EE TCK或以现代方式从完整的Jakarta CTS套件中创建新的。

其中之一是将Arquillian添加到JUnit 4或TestNG测试套件中的一种行之有效的方法，并且期望所有实现都提供Arquillian容器来运行它们的测试。 如所示，只需几行代码，这很容易，编写一个简单的Arquillian扩展来定义所有测试的部署。

但是，还有一种有趣的新方法可以使用JUnit 5，它是Java最先进的测试框架之一。 JUnit 5提供了足够的扩展点，并且还允许为所有测试全局启用扩展。 这意味着测试不需要包括启用扩展所需的任何模板代码。 正式发布后，实现者可以使用Arquillian通过现有的JUnit 5 Arquillian扩展来运行测试，也可以创建自己的JUnit 5扩展以将测试与其实现连接。 或者他们可以自由使用现有的非官方JUnit 5 Arquillian扩展，甚至可以根据需要进行修改，因为他们可以真正使用他们想要的任何东西。

> 翻译自: [https://www.javacodegeeks.com/2020/04/possible-ways-to-use-arquillian-in-jakarta-ee-tcks.html][https_www.javacodegeeks.com_2020_04_possible-ways-to-use-arquillian-in-jakarta-ee-tcks.html]

tms tck

[Link 1]: https://www.eclipse.org/lists/jakartabatch-dev/msg00053.html
[Arquillian]: http://arquillian.org/
[Romain]: https://twitter.com/rmannibucau
[TestNG]: https://testng.org/
[CDI TCK]: https://github.com/eclipse-ee4j/cdi-tck
[Bean]: https://github.com/eclipse-ee4j/beanvalidation-tck
[JSON-B]: https://github.com/eclipse-ee4j/jsonb-api/tree/master/tck
[DI TCK]: https://github.com/eclipse-ee4j/injection-tck/
[JBatch]: https://github.com/WASdev/standards.jsr352.jbatch
[https]: https://github.com/OndroMih/batch-tck/pull/1
[Link 2]: https://github.com/OndroMih/Payara-Batch-TCK-Runner/tree/poc-arquillian
[MavenTestDependenciesDeploymentPackager.java]: https://github.com/OndroMih/Payara-Batch-TCK-Runner/blob/poc-arquillian/jbatch-arquillian-extension/src/main/java/jbatch/arquillian/extension/MavenTestDependenciesDeploymentPackager.java
[https 1]: https://github.com/OndroMih/batch-tck/pull/2
[JUnit 5]: https://github.com/arquillian/arquillian-core/issues/137
[arquillian-junit5]: https://github.com/zforgo/arquillian-junit5-extension
[Link 3]: https://github.com/dmatej/arquillian-junit5-extension
[https_www.javacodegeeks.com_2020_04_possible-ways-to-use-arquillian-in-jakarta-ee-tcks.html]: https://www.javacodegeeks.com/2020/04/possible-ways-to-use-arquillian-in-jakarta-ee-tcks.html