tomcat源码环境构建

前言

tomcat作为Java项目运行的容器，基本上算是目前使用最多的容器了吧，因此对tomcat的容器的研究很有必要，不仅是学习容器本身的设计思想，更能通过源码的调试和阅读对于其深层的原理进行较好的研究，对再学习其他框架很有帮助，因此构建起tomcat的源码阅读环境很有必要，下面小编就来演示下如何基于tomcat8版本构建源码的阅读环境吧

1、官网下载tomcat的源码包

进入官网：https://tomcat.apache.org/download-80.cgi，点击这里下载到本地

下载之后直接解压就好

2、再在解压后的同级目录创建catalina-home目录

进入解压后的tomcat文件内，将相关的目录，比如,bin，conf，webapps等目录全部拷贝到catalina-home文件夹中，参照tomcat本身的目录结构，如果发现源码包下的文件夹缺失，手动创建一下，catalina-home中完整的目录结构如下图

3、在apache-tomcat-8.5.38-src文件夹创建pom文件

因为下载下来的源码包没有pom文件，为了编译并以maven项目运行，需要手动构建一下pom文件，完整的pom文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<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.0</modelVersion>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>Tomcat8.0</artifactId>
    <name>Tomcat8.0</name>
    <version>8.0</version>

    <build>
        <finalName>Tomcat8.0</finalName>
        <sourceDirectory>java</sourceDirectory>
        <testSourceDirectory>test</testSourceDirectory>
        <resources>
            <resource>
                <directory>java</directory>
            </resource>
        </resources>
        <testResources>
            <testResource>
                <directory>test</directory>
            </testResource>
        </testResources>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.easymock</groupId>
            <artifactId>easymock</artifactId>
            <version>3.4</version>
        </dependency>
        <dependency>
            <groupId>ant</groupId>
            <artifactId>ant</artifactId>
            <version>1.7.0</version>
        </dependency>
        <dependency>
            <groupId>wsdl4j</groupId>
            <artifactId>wsdl4j</artifactId>
            <version>1.6.2</version>
        </dependency>
        <dependency>
            <groupId>javax.xml</groupId>
            <artifactId>jaxrpc</artifactId>
            <version>1.1</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.jdt.core.compiler</groupId>
            <artifactId>ecj</artifactId>
            <version>4.5.1</version>
        </dependency>

    </dependencies>
</project>

4、idea以maven的形式导入上面的项目

导入成功后，配置一下本地的maven环境

5、配置导入的tomcat项目启动参数

点击edit-configuration，在启动参数里面填写2行主要配置，与图中的对应，最好为自己的启动应用起一个名字，便于标识

org.apache.catalina.startup.Bootstrap
-Dcatalina.home="D:\dev-tools\tomcat\catalina-home"

6、启动项目

启动之后，一般来说会报两个错误，第一个是TestCookieFilter这个类，简单的解决办法就是，注释掉里面的测试方法即可

第二个错误是，启动之后，访问 : localhost:8080时，页面出现下面的错误

这个问题的解决也不难，找到ContextConfig这个类中的configureStart()方法，在方法中添加下面这段代码即可：

context.addServletContainerInitializer(new JasperInitializer(), null);

这样修改了之后，再次启动就可以成功启动应用了，访问:localhost:8080，如下图所示：

到这里，我们就完成了基于idea对tomcat8.X源码环境的构建，然后就可以愉快的阅读源码了，本篇到此结束，最后感谢观看！