Jetty 12 版本中 HandlerCollection 的替代方案及迁移指南

核心变更概述

Jetty 12 作为新一代的 Java Web 服务器和 Servlet 容器，在架构上进行了重大调整，其中一个显著变化是移除了传统的 HandlerCollection 类。对于从 Jetty 11 迁移到 Jetty 12 的开发者而言，理解这一变更及其替代方案至关重要。

HandlerCollection 的替代方案

在 Jetty 12 中，HandlerCollection 类已被 Handler.Sequence 所取代。这一变更不仅仅是简单的类名替换，而是反映了 Jetty 内部架构的优化：

• Handler.Sequence 提供了更清晰、更类型安全的处理器链管理方式
• 新的实现更好地支持现代 Java 特性
• 简化了处理器组合的API设计

迁移实践示例

对于原有的 XML 配置方式，迁移后的配置应调整为：

<bean id="Handler" class="org.eclipse.jetty.server.Handler.Sequence">
    <property name="handlers">
        <list>
            <ref bean="Example1"/>
            <ref bean="Example2"/>
            <ref bean="Example3"/>
            <ref bean="Example4"/>
            <ref bean="Example5"/>
        </list>
    </property>
</bean>

请求日志处理的变更

Jetty 12 中另一个重要变化是移除了 RequestLogHandler 类。这是有意为之的设计决策，旨在解决之前版本中存在的日志丢失问题。新的推荐做法是：

1. 直接将 RequestLog 设置到 Server 实例上
2. 使用 Server.setRequestLog() 方法配置日志
3. 避免将日志处理器作为普通处理器链的一部分

其他相关类的迁移路径

在从 Jetty 11 迁移到 12 的过程中，开发者还需要注意以下类的变化：

1. WebAppContext 现在有多个环境特定版本，需要根据目标环境选择
2. ClassMatcher 的功能现在通过 WebAppContext 的方法提供
3. WebAppProvider 已被环境特定的实现替代

最佳实践建议

1. 优先使用编程式配置而非XML配置
2. 仔细评估日志需求，采用新的 RequestLog 设置方式
3. 充分利用 Jetty 12 的模块化设计
4. 参考官方迁移指南了解完整的API变化

总结

Jetty 12 的架构改进带来了更清晰、更可靠的组件设计。虽然迁移过程需要开发者适应一些API变化，但这些变更最终会带来更稳定的运行环境和更简洁的代码结构。理解 Handler.Sequence 的设计理念和 RequestLog 的新配置方式，是成功迁移的关键所在。