前言
整理这个官方翻译的系列,原因是网上大部分的 tomcat 版本比较旧,此版本为 v11 最新的版本。
开源项目
从零手写实现 tomcat minicat 别称【嗅虎】心有猛虎,轻嗅蔷薇。
系列文章
web server apache tomcat11-01-官方文档入门介绍
web server apache tomcat11-02-setup 启动
web server apache tomcat11-03-deploy 如何部署
web server apache tomcat11-04-manager 如何管理?
web server apache tomcat11-06-Host Manager App — Text Interface
web server apache tomcat11-07-Realm Configuration
web server apache tomcat11-08-JNDI Resources
web server apache tomcat11-09-JNDI Datasource
web server apache tomcat11-10-Class Loader
web server apache tomcat11-11-Jasper 2 JSP Engine
web server apache tomcat11-12-SSL/TLS Configuration
web server apache tomcat11-13-SSI
web server apache tomcat11-14-CGI
web server apache tomcat11-15-proxy
web server apache tomcat11-16-mbean
web server apache tomcat11-17-default-servlet
web server apache tomcat11-18-clusting 集群
web server apache tomcat11-19-load balance 负载均衡
web server apache tomcat11-20-connectors 连接器
web server apache tomcat11-21-monitor and management 监控与管理
web server apache tomcat11-22-logging 日志
web server apache tomcat11-23-APR
web server apache tomcat11-24-Virtual Hosting and Tomcat
web server apache tomcat11-25-Advanced IO and Tomcat
web server apache tomcat11-26-maven jars
web server apache tomcat11-27-Security Considerations
web server apache tomcat11-28-Windows Service
web server apache tomcat11-29-Windows Authentication
web server apache tomcat11-30-The Tomcat JDBC Connection Pool
web server apache tomcat11-31-websocket
web server apache tomcat11-32-rewrite
web server apache tomcat11-33-CDI
web server apache tomcat11-34-Ahead of Time compilation support
使用 GraalVM/Mandrel Native Image 工具构建 Tomcat 本机二进制文件
设置
本机图像工具更容易与单个 JAR 一起使用,因此该过程将使用 Maven shade 插件 JAR 打包。
其思想是生成一个包含来自 Tomcat、Web 应用程序和所有附加依赖项的所有必要类的单个 JAR。
尽管 Tomcat 已经接收了兼容性修复以支持本机图像,但其他库可能不兼容,可能需要替换代码(GraalVM 文档有更多详细信息)。
- 下载并安装 GraalVM 或 Mandrel。
- 从 https://github.com/apache/tomcat/tree/main/modules/stuffed 下载 Tomcat Stuffed 模块。为了方便起见,可以设置一个环境变量:
export TOMCAT_STUFFED=/绝对路径到/stuffed
构建过程现在需要 Apache Ant 和 Maven。
打包和构建
在 $TOMCAT_STUFFED 文件夹内,目录结构与常规 Tomcat 相同。主要配置文件放置在 conf 文件夹中,如果使用默认的 server.xml,则 Web 应用程序放置在 webapps 文件夹中。
所有 Web 应用程序类都需要在 Maven shade 插件和编译器在 JSP 预编译步骤期间使用。任何存在于 /WEB-INF/lib 中的 JAR 都需要作为 Maven 依赖项提供。webapp-jspc.ant.xml 脚本将从 Web 应用程序的 /WEB-INF/classes 文件夹复制类到 Maven 用作编译目标的 target/classes 路径,但如果任何 JSP 源使用它们,则它们需要打包为 JAR。
首先是使用所有依赖项构建带阴影的 Tomcat JAR。假设 Web 应用程序包含一个 $WEBAPPNAME Web 应用程序,所有 Web 应用程序中的 JSP 都必须预先编译并打包:
cd $TOMCAT_STUFFED
mvn package
ant -Dwebapp.name=$WEBAPPNAME -f webapp-jspc.ant.xml
现在应将 Web 应用程序的依赖项添加到主要的 $TOMCAT_STUFFED/pom.xml,然后构建带阴影的 JAR:
mvn package
最好尽可能避免在 Ahead of Time 编译中使用反射,因此最好将主 server.xml 配置以及用于配置上下文的 context.xml 文件生成并编译为 Tomcat 嵌入式代码。
$JAVA_HOME/bin/java
-Dcatalina.base=. -Djava.util.logging.config.file=conf/logging.properties
-jar target/tomcat-stuffed-1.0.jar --catalina -generateCode src/main/java
然后停止 Tomcat 并使用以下命令包含生成的嵌入式代码:
mvn package
这里描述的进程的其余部分将假定此步骤已完成,并且在命令行中添加了 –catalina -useGeneratedCode 参数。如果不是这种情况,则应将其删除。
本机图像配置
本机图像不支持任何形式的动态类加载或反射,除非在描述符中显式定义。生成它们使用 GraalVM 的跟踪代理,并且在某些情况下需要进行额外的手动配置。
使用 GraalVM substrate VM 及其跟踪代理运行 Tomcat:
$JAVA_HOME/bin/java
-agentlib:native-image-agent=config-output-dir=$TOMCAT_STUFFED/target/
-Dorg.graalvm.nativeimage.imagecode=agent
-Dcatalina.base=. -Djava.util.logging.config.file=conf/logging.properties
-jar target/tomcat-stuffed-1.0.jar --catalina -useGeneratedCode
现在,Web 应用程序中通往动态类加载的所有路径(例如:Servlet 访问、WebSockets 等)都需要使用将练习 Web 应用程序的脚本访问。Servlet 可能在启动时加载,而无需实际访问。监听器也可以在启动时用于加载其他类。完成后,可以停止 Tomcat。
描述符现已在代理输出目录中生成。此时必须进行进一步的配置,以添加未跟踪的项目,包括:基本接口、资源包、基于 BeanInfo 的反射等。有关此过程的更多信息,请参阅 Graal 文档。
尽管必须将所有使用的类 AOT 编译到本机图像中,但是 Web 应用程序仍必须保持不变,并且继续在 WEB-INF 文件夹中包含所有所需的类和 JAR。尽管这些类实际上不会运行或加载,但需要访问它们。
构建本机图像
如果一切都做得正确,现在可以使用 native-image 工具构建本机图像。
$JAVA_HOME/bin/native-image --report-unsupported-elements-at-runtime
--enable-http --enable-https --enable-url-protocols=http,https,jar,jrt
--initialize-at-build-time=org.eclipse.jdt,org.apache.el.parser.SimpleNode,jakarta.servlet.jsp.JspFactory,org.apache.jasper.servlet.JasperInitializer,org.apache.jasper.runtime.JspFactoryImpl
-H:+UnlockExperimentalVMOptions
-H:+JNI -H:+ReportExceptionStackTraces
-H:ConfigurationFileDirectories=$TOMCAT_STUFFED/target/
-H:ReflectionConfigurationFiles=$TOMCAT_STUFFED/tomcat-reflection.json
-H:ResourceConfigurationFiles=$TOMCAT_STUFFED/tomcat-resource.json
-H:JNIConfigurationFiles=$TOMCAT_STUFFED/tomcat-jni.json
-jar $TOMCAT_STUFFED/target/tomcat-stuffed-1.0.jar
附加的 –static 参数启用了在生成的二进制文件中
的 glibc、zlib 和 libstd++ 的静态链接。
然后运行本机图像:
./tomcat-stuffed-1.0 -Dcatalina.base=. -Djava.util.logging.config.file=conf/logging.properties --catalina -useGeneratedCode
兼容性
Servlet、JSP、EL、WebSockets、Tomcat 容器、tomcat-native、HTTP/2 在本机图像中都支持开箱即用。
在撰写本文档时,由于 Graal 不支持日志管理器配置属性,因此不支持 JULI,除了一些静态初始化器问题外,常规的 java.util.logging 记录器和实现应该使用。
如果使用默认的 server.xml 文件,则必须从配置中删除一些 Server 监听器,因为它们与本机图像不兼容,例如 JMX 监听器(不支持 JMX)和泄漏预防监听器(使用不存在于 Graal 中的内部代码)。
更好的 Tomcat 功能缺失项目:
- java.util.logging LogManager:未实现通过系统属性进行配置,因此必须使用标准 java.util.logging 而不是 JULI
- 静态链接配置:tomcat-native 不能进行静态链接
参考资料
https://tomcat.apache.org/tomcat-11.0-doc/cdi.html