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

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

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

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

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

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

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

改进TCK，使其可以与Java容器集成
修改现有示例项目以使用TCK运行JBatch
创建另一个将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 。总之，我向每个TCK测试添加了一行代码，并修改了批处理TCK和JBatch的TCK运行器的pom.xml。

这使我可以创建一个示例项目，以使用远程服务器（如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 : //github.com/OndroMih/batch-tck/pull/2 。更改了TCK，并且JBatch调谐器项目也使用了它，并且运行无测试失败。这解决了我的前两个目标。

最难的事情是将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.5中添加的基本扩展点时花了一些时间，但现在有一个非正式的arquillian-junit5扩展，其中对该fork进行了一些修复。

因此，我尝试将所有已经拥有的东西汇总起来，以尝试是否可以对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扩展，甚至可以根据需要进行修改，因为他们可以真正使用他们想要的任何东西。