Jetty项目从9.4.x迁移到10.0.x的技术指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00060/article/details/148551703

Jetty项目从9.4.x迁移到10.0.x的技术指南

jetty.project Eclipse Jetty® - Web Container & Clients - supports HTTP/2, HTTP/1.1, HTTP/1.0, websocket, servlets, and more 项目地址: https://gitcode.com/gh_mirrors/je/jetty.project

前言

Jetty作为一款轻量级的Java Web服务器和Servlet容器，在10.0.x版本中进行了多项重大更新。本文将详细介绍从Jetty 9.4.x迁移到10.0.x版本时需要注意的关键变化，帮助开发者顺利完成升级工作。

Java版本要求变化

Jetty 10.0.x对运行环境的要求有了显著提升：

| Jetty版本 | 最低Java版本要求 | |-----------|----------------| | 9.4.x | Java 8 | | 10.0.x | Java 11 |

这一变化意味着：

必须确保生产环境已安装Java 11或更高版本
构建工具(如Maven/Gradle)需要配置Java 11兼容性
所有依赖Jetty的项目都需要调整编译目标版本

WebSocket模块的重大变更

WebSocket是Jetty 10.0.x中变化最大的模块之一，主要涉及三个方面：

1. Maven依赖坐标变更

Jetty 10.0.x对WebSocket相关组件的Maven坐标进行了重构，使命名更加清晰和一致。以下是主要变更对照表：

| 9.4.x依赖坐标 | 10.0.x依赖坐标 | |--------------|---------------| | websocket-api | websocket-jetty-api | | websocket-server | websocket-jetty-server | | websocket-client | websocket-jetty-client | | javax-websocket-server-impl | websocket-javax-server | | javax-websocket-client-impl | websocket-javax-client |

变更特点：

所有核心组件都增加了"jetty"标识
JSR-356(Javax)实现组件命名更加规范
更清晰地分离了API和实现

2. 类名和包结构重构

Jetty 10.0.x对WebSocket相关的核心类进行了重新组织和重命名，主要变化包括：

| 9.4.x类名 | 10.0.x类名 | |----------|-----------| | NativeWebSocketServletContainerInitializer | JettyWebSocketServletContainerInitializer | | WebSocketServerContainerInitializer | JavaxWebSocketServletContainerInitializer | | WebSocketCreator | JettyWebSocketCreator | | ServletUpgradeRequest | JettyServerUpgradeRequest | | ServletUpgradeResponse | JettyServerUpgradeResponse | | WebSocketServlet | JettyWebSocketServlet | | WebSocketServletFactory | JettyWebSocketServletFactory |

重构特点：

所有核心类都增加了"Jetty"前缀
更清晰地表明了类的用途和归属
包结构更加合理，便于维护和扩展

3. 代码示例对比

以下是一个WebSocket Servlet实现的迁移示例，展示了新旧版本的主要差异：

Jetty 9.4.x实现:

public class ExampleWebSocketServlet extends WebSocketServlet {
    @Override
    public void configure(WebSocketServletFactory factory) {
        factory.setCreator(new WebSocketCreator() {
            @Override
            public Object createWebSocket(ServletUpgradeRequest req, ServletUpgradeResponse resp) {
                return new ExampleEndpoint();
            }
        });
    }
}

Jetty 10.0.x实现:

public class ExampleWebSocketServlet extends JettyWebSocketServlet {
    @Override
    public void configure(JettyWebSocketServletFactory factory) {
        factory.setCreator(new JettyWebSocketCreator() {
            @Override
            public Object createWebSocket(JettyServerUpgradeRequest req, JettyServerUpgradeResponse resp) {
                return new ExampleEndpoint();
            }
        });
    }
}

主要变化点：