Tomcat源码debug环境

概述

开源软件tomcat，目前几乎已经是Java web开发的必备软件了，目前有很多关于tomcat的书籍，但是里面介绍的大多是关于tomcat的配置，已经通过配置对tomcat进行一些跟应用业务功能的调优，作为一个Java开发人员，感觉如果仅仅只是了解一些配置，可能稍微少了一点什么，最好能够深入到源代码中进行学些和了解。
在Google上搜索了很多关于tomcat源码环境搭建的文章，发现按照文章的步骤，几乎都启动不了，于是自己尝试搭建，下面是搭建的方法。

基础环境搭建

1. 下载tomcat源代码，我这里是通过svn的方式下载的，svn下载地址
2. 下载安装maven工具，这里我就不多说了，安装说明太多了
3. IDE，我这里使用idea

生成maven工程

我的代码本地目录是: /Users/helanzhou/Documents/helanzhou/java/Tomcat/tomcat8/tomcat-8.5.5-sourcecode。先在该目录下生成一个pom.xml文件，pom文件的内容为：

    4.0.0
    org.apache.tomcat
    Tomcat8.0
    Tomcat8.0
    8.0

    
        Tomcat8.0
        java
        test
        
            
                java
            
        
        
            
                test
            
        
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                2.3
                
                    UTF-8
                    1.8
                    1.8
                
            
        
    

    
        
            junit
            junit
            4.12
            test
        
        
            org.easymock
            easymock
            3.4
        
        
            ant
            ant
            1.7.0
        
        
            wsdl4j
            wsdl4j
            1.6.2
        
        
            javax.xml
            jaxrpc
            1.1
        
        
            org.eclipse.jdt.core.compiler
            ecj
            4.5.1
        
    

在这里，我把java和test这两个模块到加载到pom工程里，你也可以选择将test工程移除，这样可以省不少事情。

在idea中导入tomcat pom工程

将tomcat的pom工程导入到idea中，这个时候，你可以找到tomcat的启动类org.apache.catalina.startup.Bootstrap, 找到main方法，尝试启动tomcat，这个时候肯定是报错的，因为你还有很多后面的步骤没有完成。

1. 需要设置一个运行时的CATALINA_HOME
   目录，你需要下载一个tomcat软件的压缩包，由于我选择的是tomcat-8.5.5的源代码，下载对应的tomcat版本，tomcat下载地址

2. 和tomcat-8.5.5-sourcecode这个目录的上层目录上，建一个和该目录平行的目录catalina-home，将tomcat软件解压后，在解压的目录下，将以下目录拷贝到catalina-home中：

bin
conf
lib
logs
temp
webapps
work

在本地的目录结构是这样的：

Paste_Image.png

• 在idea的右上角找到run这个按钮，旁边有Edit Configurations...这个选项，点击它。得到一个弹出框。

在Man class:中填入，org.apache.catalina.startup.Bootstrap;
在VM options:中填入，你刚刚设置catalina-home路径，我的是：-Dcatalina.home="/Users/helanzhou/Documents/helanzhou/java/Tomcat/tomcat8/catalina-home";
Working directory是默认的，不用管;
Use class path of module里选择Tomcat8.0，这个和你在pom.xml中的配置有关;
JRE，我选择的是1.8
如下图：

Paste_Image.png

• 保存上面的配置，然后在右上角选择run，这个时候，可以启动起来了，你可以在控制台上看到下图的启动日志：

Paste_Image.png

• 打开chrome浏览器，输入127.0.0.1:8080，这时候，你能够得到下面的页面：

Paste_Image.png

这个时候，说明你的tomcat环境配置已经成功了，接下来，开启你的tomcat源码调试之旅吧！