当前位置: 首页 > 工具软件 > CDI TCK > 使用案例 >

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

邵飞宇
2023-12-01

最近,我们讨论了如何创建独立的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个目标:

  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 。 总之,我向每个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扩展,甚至可以根据需要进行修改,因为他们可以真正使用他们想要的任何东西。

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

 类似资料: