Jetty项目Web应用部署完全指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00420/article/details/148551674

Jetty项目Web应用部署完全指南

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

作为一款轻量级、高性能的Java Web服务器和Servlet容器，Jetty提供了灵活多样的Web应用部署方式。本文将深入解析Jetty的部署机制，帮助开发者掌握各种部署场景下的最佳实践。

部署环境选择

Jetty支持多种部署环境，允许同时运行不同技术栈的Web应用：

Java EE 8环境：支持Servlet 4.0规范（javax.*包）
Jakarta EE 9环境：支持Servlet 5.0规范（jakarta.*包）
Jakarta EE 10环境：支持Servlet 6.0规范（jakarta.*包）
Jetty Core环境：仅使用Jetty Handler API，不依赖Servlet规范

这种多环境支持使得企业可以平滑过渡旧系统，同时运行不同技术标准的应用。

部署方式详解

热部署与静态部署

Jetty提供两种部署模式：

静态部署（默认）：

扫描间隔设为0秒
需要重启Jetty才能使部署变更生效
适合生产环境的稳定部署

热部署：

通过设置jetty.deploy.scanInterval参数启用（建议1秒以上）
自动检测webapps目录变更并实时部署
适合开发环境快速迭代

启用热部署的命令示例：

java -jar start.jar jetty.deploy.scanInterval=1

部署规则解析

Jetty通过DeploymentManager组件管理webapps目录下的应用部署：

文件类型处理：
- .war文件：标准Web应用归档
- 目录：包含WEB-INF的视为Web应用，否则视为静态资源
- .xml文件：Jetty上下文配置文件
上下文路径规则：
- /myapp目录 → 上下文路径/myapp
- ROOT目录 → 根路径/
- myapp.war → 上下文路径/myapp
- ROOT.war → 根路径/
优先级规则：
- XML文件 > WAR文件 > 目录
- 同名文件只部署优先级高的那个

高级部署配置

上下文XML文件部署

通过XML文件可以精细控制Web应用的部署参数：

<?xml version="1.0" encoding="UTF-8"?>
<Configure class="org.eclipse.jetty.ee10.webapp.WebAppContext">
  <Set name="contextPath">/wiki</Set>
  <Set name="war"><SystemProperty name="app.dir"/>/wiki.war</Set>
</Configure>

关键优势：

解耦部署配置与WAR包
支持系统属性动态配置
可集中管理多个应用的部署参数

多环境部署策略

当启用多个部署环境时，建议通过.properties文件明确指定目标环境：

# myapp-ee9.properties
environment=ee9

环境解析规则：

显式指定的环境优先
默认选择最新的Jakarta EE环境
其次选择Core环境

环境级XML配置

通过ee10.properties等环境配置文件，可以为特定环境的所有应用添加公共配置：

# ee10.properties
jetty.deploy.environmentXml=etc/ee10-defaults.xml

这种配置会应用于所有部署到EE10环境的Web应用，适合设置环境级的公共参数。

特殊部署场景

WEB-INF配置

可以在WAR包内添加WEB-INF/jetty-web.xml进行应用级配置：

特点：

配置随应用打包
在类路径建立后执行
适合应用特定的初始化

JNDI资源配置

通过上下文XML配置JNDI资源示例：

<New class="org.eclipse.jetty.plus.jndi.Resource">
  <Arg>jdbc/myds</Arg>
  <Arg>
    <New class="com.mysql.cj.jdbc.MysqlConnectionPoolDataSource">
      <Set name="url">jdbc:mysql://localhost:3306/db</Set>
      <!-- 其他配置 -->
    </New>
  </Arg>
</New>

注意事项：