Tomcat9源代码浅析-环境搭建

1.概要

Apache Tomcat是一个非常受欢迎的开源Web容器，使用Java语言开发。

近期公司开始推行开源技术的应用，目前正在将Weblogic替换为Tomcat，我们称之为W2T。本系列为项目过程中对Tomcat 9源代码分析的记录，过程中主要参考了官方文档以及网络上的博客。
本篇为源代码分析的第一步，源代码环境的构建。

2.构建步骤

完整的构建步骤说明为源代码中的BUILDING.txt文件，本过程大部分内容为该文件的翻译，本文构建平台为Windows操作系统。

2.1基础环境准备

JDK的下载和安装

• 版本要求：version 8 of Java Development Kit (JDK) release

• 载地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html

• 设置环境变量：

  JAVA_HOME:计算机中JDK安装的绝对路径
  CLASSPATH:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
  PATH:%JAVA_HOME%\bin
  

ANT的下载和安装

• 版本要求：version 1.9.8 or later
• 下载地址： https://ant.apache.org/bindownload.cgi
• 设置环境变量：

  ANT_HOME:计算机中ANT安装的绝对路径
  PATH: %ANT_HOME%\bin
  

2.2 构建Tomcat

Tomcat9源代码下载

Tomcat9源代码可通过Git仓库checkout也可以在官网下载代码压缩包。

• Tomcat GitHub repository URL: https://github.com/apache/tomcat

• Source packages can be downloaded from: https://tomcat.apache.org/download-@[email protected]

Ant构建

• 首先在项目根目录创建文件==build.properties==，其内容可直接复制==build.properties.default==
• Ant构建时会下载Tomcat所依赖的lib文件，下载路径由属性==base.path==指定，默认为${user.home}/tomcat-build-libs
• 进入到项目目录，运行ant命令开始构建

cd ${tomcat.source}
ant

构建成功后，在目录${tomcat.source}/output/build下就是一个我们平时下载的Tomcat容器，可以使用startup.bat、startup.sh、shutdown.bat、shutdown.sh等命令进行操作。

2.3 编译运行源代码

编译源代码

本文为使用IntelliJ IDEA编译运行源代码，因Tomcat是使用Ant构建的，所以并没有依据项目工程结构添加依赖，导入IDEA中会提示编译错误，需要先将源代码改造为Maven结构，通过Maven进行编译。
当然也可以将项目视为简单Java项目进行构建，需要为项目添加base.path指定的tomcat-build-libs中jar包依赖，但IDEA在编译Java项目时不会复制非java文件，例如properties、xml等，如果以此方式运行源代码，则不能使用IDEA，可以改用eclipse。

在项目根目录添加pom.xml文件，并在添加为maven项目，之后可以通过可视化操作或者命令进行编译。

   4.0.0
   org.apache.tomcat
   Tomcat9
   Tomcat9
   9

   
       D:/tomcat9/tomcat-build-libs
       D:/software/apache-ant-1.9.13
   
   
       Tomcat9
       java
       test
       
           
               java
           
       
       
          
               test
          
       
       
           
               org.apache.maven.plugins
               maven-compiler-plugin
               2.3
               
                   UTF-8
                   1.8
                   1.8
               
           
       
   

   
       
           junit
           junit
           4.12
           test
       
       
           ecj
           ecj
           4.12
           system
           ${base.path}/ecj-4.12/ecj-4.12.jar
       
       
           saaj-api
           saaj-api
           1.3.5
           system
           ${base.path}/saaj-api-1.3.5/saaj-api-1.3.5.jar
       
       
           jaxrpc
           jaxrpc
           1.1
           system
           ${base.path}/jaxrpc-1.1-rc4/geronimo-spec-jaxrpc-1.1-rc4.jar
       
       
           wsdl4j
           wsdl4j
           1.6.3
           system
           ${base.path}/wsdl4j-1.6.3/wsdl4j-1.6.3.jar
       
       
           ant
           ant
           1.9.3
           system
           ${ant.home}/lib/ant.jar
       
       
           org.easymock
           easymock
           3.4
       

   

操作完成后，项目结构如下图：

此时在Test目录中仍然存在编译错误，原因是Test对tomcat/webapps/examples 进行了引用，在File->Project Structure中添加依赖

运行源代码

Tomcat的入口为org.apache.catalina.startup.Bootstrap的main方法，但在运行前需要设定环境变量==catalina.home==，用于指定Tomcat的根目录，否则运行时会提示某些配置文件不存在。以我本地为例，设置了构建后的目录路径。

-Dcatalina.home=D:\apache-tomcat-9.0.24-src\output\build

至此，Tomcat9的环境搭建完毕，运行Bootstrap的main方法，启动Tomcat。

[ 在运行时控制台出现了中文乱码的问题，经查看为国际化的问题，此处没有进行深入研究，直接将语言环境设置为英文，设置了JVM参数：-Duser.language=en]