IntelliJ IDEA配置调试Tomcat8源码流程

  • 调试环境

  JDK版本:java version "1.8.0_131"

  IDEA版本:Ultimate 2018.3.4

  Tomcat源码版本:8.5.38


  • Tomcat下载与目录配置

Apache Tomcat网址:https://tomcat.apache.org/download-80.cgi

Tomcat8.5.38源码直接下载链接:http://mirrors.tuna.tsinghua.edu.cn/apache/tomcat/tomcat-8/v8.5.38/src/apache-tomcat-8.5.38-src.zip(ps:直接复制粘贴到迅雷即可下载)

创建一个catalina_home目录,并把apache-tomcat-8.5.38-src源码目录中的conf和webapps两个目录复制过去:

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

在apache-tomcat-8.5.38-src源码目录中创建一个pom.xml文件,以便后面使用maven构建项目:

pom.xml文件依赖代码如下:

<?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.5.38</artifactId>
    <name>Tomcat8.5.38</name>
    <version>8.5</version>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <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.5.1</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>ant</groupId>
            <artifactId>ant</artifactId>
            <version>1.7.0</version>
        </dependency>
        <dependency>
            <groupId>ant</groupId>
            <artifactId>ant-apache-log4j</artifactId>
            <version>1.6.5</version>
        </dependency>
        <dependency>
            <groupId>ant</groupId>
            <artifactId>ant-commons-logging</artifactId>
            <version>1.6.5</version>
        </dependency>
        <dependency>
            <groupId>wsdl4j</groupId>
            <artifactId>wsdl4j</artifactId>
            <version>1.6.2</version>
        </dependency>
        <dependency>
            <groupId>javax.xml.rpc</groupId>
            <artifactId>javax.xml.rpc-api</artifactId>
            <version>1.1</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.jdt.core.compiler</groupId>
            <artifactId>ecj</artifactId>
            <version>4.6.1</version>
        </dependency>
    </dependencies>

    <build>
        <finalName>Tomcat8.5</finalName>
        <sourceDirectory>java</sourceDirectory>
        <resources>
            <resource>
                <directory>java</directory>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.5</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

 


  • IDEA导入Tomcat源码并配置运行

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程

VM配置参数:

-Dcatalina.home=D:/Eclipse4.2/workspaceforidea/tomcat/catalina_home
-Dcatalina.base=D:/Eclipse4.2/workspaceforidea/tomcat/catalina_home
-Djava.endorsed.dirs=D:/Eclipse4.2/workspaceforidea/tomcat/catalina_home/endorsed
-Djava.io.tmpdir=D:/Eclipse4.2/workspaceforidea/tomcat/catalina_home/temp
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-Djava.util.logging.config.file=D:/Eclipse4.2/workspaceforidea/tomcat/catalina_home/conf/logging.properties

配置完成后直接启动运行

输出如下信息表示我们自己的Tomcat已经启动起来了:

IntelliJ IDEA配置调试Tomcat8源码流程

千辛万苦把Tomcat配置的启动起来了,却发现默认的页面无法打开:

IntelliJ IDEA配置调试Tomcat8源码流程

经过重重排查,原因竟然是jsp的编译器没有初始化,我们只需要在apache-tomcat-8.5.38-src\java\org\apache\catalina\startup\ContextConfig.java类中只需添加一句代码即可手动初始化:

IntelliJ IDEA配置调试Tomcat8源码流程

 

最后再次访问我们的localhost:8080,熟悉的猫猫终于出现了,????

IntelliJ IDEA配置调试Tomcat8源码流程



ps:之前在编译Tomcat8.5.30的源码的时候在apache-tomcat-8.5.30-src\webapps\examples\WEB-INF\web.xml文件中碰到了一些Listener和servlet找不到的问题,其实这些实际的java文件在源码目录的webapps/examples/WEB-INF/classes目录中都可以找到,我们只需要在java目录下创建对应的目录和java类即可,然后修改web.xml文件中class节点的引用

IntelliJ IDEA配置调试Tomcat8源码流程

IntelliJ IDEA配置调试Tomcat8源码流程