从 Quarkus RESTEasy 迁移到 RESTEasy Reactive：使用 ThreadLocal 应用程序的指南

从 Quarkus RESTEasy 迁移到 Quarkus RESTEasy Reactive：使用 ThreadLocal 的应用程序迁移指南

简介

对于使用 ThreadLocal 的应用程序，从 Quarkus RESTEasy 迁移到 Quarkus RESTEasy Reactive 可能会带来一些挑战。本文将探讨这些挑战，并提供解决方法，帮助您顺利完成迁移。

问题和解决方案

问题 1：阻塞方法中丢失会话信息

在 @PreMatching 过滤器中，会话信息存储在 ThreadLocal 中。在阻塞方法中，这些信息将丢失，因为执行被委托给工作线程。

解决方案： 避免在 @PreMatching 过滤器中使用阻塞方法。考虑使用非阻塞 I/O 库或将方法转换为异步。

问题 2：非阻塞方法中的随机会话信息丢失

对于并行请求，会话信息可能会随机丢失。这是因为事件循环线程使用不同的上下文（Vert.x 线程上下文），而 ThreadLocal 无法跨上下文传播。

解决方案： 使用 Vert.x ThreadLocal 来管理会话信息。您可以使用 VertxContext.currentContext().put 和 get 方法来设置和检索会话信息。

问题 3：异步方法中 ThreadLocal 信息传播

将方法转换为返回 Uni 可以传播 ThreadLocal 信息。然而，在负载下测试时，可能会出现问题。

解决方案： 考虑使用 ReactiveStreams 扩展或 RxJava 之类的库来管理异步流。这些库提供了 ThreadLocal 传播的机制。

问题 4：在 Vert.x 线程中运行集成测试

Quarkus 提供了 @QuarkusTestResource 注解，用于在集成测试中启动 Vert.x 应用程序。

解决方案： 使用 @QuarkusTestResource 注解来启动应用程序，然后使用 VertxTestContext 访问 Vert.x 上下文。

结论

从 Quarkus RESTEasy 迁移到 Quarkus RESTEasy Reactive 是一项需要仔细考虑的复杂任务。通过解决本文概述的问题，您可以确保您的应用程序在迁移后平稳运行。

常见问题解答

1. 为什么从 ThreadLocal 迁移到 Vert.x ThreadLocal 很重要？

因为事件循环线程使用不同的上下文，而 ThreadLocal 无法跨上下文传播。

2. 我应该在何时使用阻塞方法？

应尽量避免在 @PreMatching 过滤器中使用阻塞方法，因为这可能会导致会话信息丢失。

3. 我如何处理非阻塞方法中的会话信息丢失？

使用 Vert.x ThreadLocal 来管理会话信息。

4. 我如何使用 ReactiveStreams 扩展或 RxJava 来传播 ThreadLocal 信息？

这些库提供了 ThreadLocal 传播的机制。

5. 我如何让集成测试在 Vert.x 线程中运行？

使用 @QuarkusTestResource 注解来启动应用程序，然后使用 VertxTestContext 访问 Vert.x 上下文。