【Tomcat9源码分析】源码下载、编译与调试

一、环境

以下是我编译Tomcat所采用的环境

• OS X Yosemite Version 10.10.5
• Intellij IDEA 2017.1
• Java version 1.8.0_65
• Apache Maven 3.3.9
• Tomcat 9.0.0.M21

（1）JDK1.8

Tomcat9至少需要jdk1.8版本，网上有很多java安装的教程。

（2）Tomcat源码

访问Tomcat下载地址，最底部的tar包或zip包源码

（3）Maven3.0+

Tomcat默认是采用ant来编译的，若你想用官方的方法编译tomcat，可访问官网how to build tomcat。笔者之前一直用maven作为管理工具，所以上网找了些资料，自己整理了用maven编译tomcat的方法。

二、准备pom.xml文件

解压tomcat源码到/yourpath/tomcat9，如下图

在/yourpath/tomcat9目录下添加pom.xml文件，内容如下

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0modelVersion>
    <groupId>cn.linxdcngroupId>
    <artifactId>Tomcat9.0artifactId>
    <name>Tomcat9name>
    <version>9.0version>

    <build>
        <finalName>Tomcat9finalName>
        <sourceDirectory>javasourceDirectory>
        <resources>
            <resource>
                <directory>javadirectory>
            resource>
        resources>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.pluginsgroupId>
                <artifactId>maven-compiler-pluginartifactId>
                <version>2.3version>
                <configuration>
                    <encoding>UTF-8encoding>
                    <source>1.8source>
                    <target>1.8target>
                configuration>
            plugin>
        plugins>
    build>

    <dependencies>
        <dependency>
            <groupId>org.apache.antgroupId>
            <artifactId>antartifactId>
            <version>1.9.5version>
        dependency>
        <dependency>
            <groupId>org.apache.antgroupId>
            <artifactId>ant-apache-log4jartifactId>
            <version>1.9.5version>
        dependency>
        <dependency>
            <groupId>org.apache.antgroupId>
            <artifactId>ant-commons-loggingartifactId>
            <version>1.9.5version>
        dependency>
        <dependency>
            <groupId>javax.xml.rpcgroupId>
            <artifactId>javax.xml.rpc-apiartifactId>
            <version>1.1version>
        dependency>
        <dependency>
            <groupId>wsdl4jgroupId>
            <artifactId>wsdl4jartifactId>
            <version>1.6.2version>
        dependency>
        <dependency>
            <groupId>org.eclipse.jdt.core.compilergroupId>
            <artifactId>ecjartifactId>
            <version>4.4version>
        dependency>
    dependencies>
project>

三、导入Intellij IDEA

（1）导入maven工程

打开Intellij IDEA，选择Import Project，在弹出框中选择/yourpath/tomcat9/pom.xml，一直next直到finish

（2）修改JDK版本

菜单栏file->Project Strucuture->Project->Project SDK，确实是否为JDK 1.8

（3）设置启动项

菜单栏run->Edit Configurations，左上角的+号，然后选择Application

• Name：可随意起，如tomcat_9_run
• Main Class：选择org.apache.catalina.startup.Bootstrap
• VM options：填写-Dcatalina.home="/yourpath/tomcat9"

（4）删除webapps内容

把/yourpath/tomcat9/webapps文件夹下的内容情况，新建一个demo文件夹，以及在demo文件夹下新建index.html文件，如下，作为测试例子

<p>Hello! This is my tomcat 9p>

ps：这里解释下为什么把webapps里的内容全部删除掉，因为我用maven构建有一些类的依赖还没解决，所以tomcat自带的例子一些配置类加载不了，后面会导致出错。作为学习这影响不大，后续有空再解决这个问题。

四、更改源代码

Tomcat9中有部分代码使用CompilerOptions.VERSION_1_9来判断java虚拟机版本，里面涉及1.9版本的jvm，我机器上识别不了。

在java/org/apache/jasper/compiler/JDTCompiler.java类中把上述代码找出，删除即可，总共有3处。

五、编译

在Intellij IDEA中，右边Maven Project->Lifecycle->compile进行编译。

看见如下输出信息，即表示编译成功。

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building Tomcat9 9.0
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ Tomcat9.0 ---
[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
[INFO] Copying 1851 resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.3:compile (default-compile) @ Tomcat9.0 ---
[INFO] Compiling 1589 source files to /Users/linxiaodong/LXD/source-code-analysis/tomcat9/target/classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 17.299 s
[INFO] Finished at: 2017-05-30T22:02:39+08:00
[INFO] Final Memory: 24M/666M
[INFO] ------------------------------------------------------------------------

Process finished with exit code 0

六、运行

在Intellij IDEA中运行Tomat程序，在浏览器中输入

localhost:8080/demo

即可看见你新建的index.html网页。