最近慢慢闲了，打算圆了以前留下的愿望。就是把tomcat的源码都走一边。可以帮助我更深层次的理解一个web服务器的工作原理。

这个周末，我便埋出了第一步。将基于eclipse的整个tomcat的源码开发环境创建成功，并成功的调试tomcat源码。下面记录我所做的事情。

JDK 1.6

下载oracle或者IBM JDK 1.6版本。1.6是必须的，因为tomcat7的明确要求JDK1.6来build。

准备eclipse

1. 到http://www.eclipse.org/downloads/下载一个eclipse。我下载的是最新的Indigo版本。选择的是IDE for Java EE developers。

2. 给eclipse安装SVN插件，tomcat的源代码使用的版本控制工具是SVN。我们需要用SVN来同步源码。http://www.eclipse.org/subversive/downloads.php提供了SVN插件的安装步骤。

准备ANT

http://ant.apache.org/选择1.8.3的版本下载。

设置环境变量

添加环境变量JAVA_HOME和ANT_HOME。将%ANT_HOME%\bin添加到PATH中。

创建目录管理你的文件

为了更好的管理你的文件，你最好组织一下自己的文件结构，我的文件结构如下。后面所有的工作都基于我下面的文件结构。

job - 工作的根目录。

apache-ant-1.8.3是ant的home。

downloads - 刚才网上下载的所有原始文件都在这里面。此文件对于tomcat运行没有影响。

eclipse - eclipse indigo for java ee developers

jad - 反编译工具。此文件对于tomcat运行也没有影响。

screen - 用于保存我屏幕截图的。对于tomcat运行没影响。

tomcat-build-download - 重要文件，在build tomcat的时候，build会自动下载一下tomcat所依赖的包。所有的依赖会自动下载都这个文件下。

tomcat-compile-dependence - tomcat源码导入eclipse之后编译的时候所依赖的包都存放在这个文件下面。

workspace - eclipse的工作目录。

workspace\tc7.0.x - 从svn同步下来的tomcat源码。

workspace\tomcat - 为tomcat源码创建的java项目。

下载源码

1，打开eclipse，转到SVN Repository exploring。

2，创建一个新的repository。URL为tomcat的repository地址http://svn.apache.org/repos/asf/tomcat。可以从tomcat官网找到。

3. 结束以后，将看到eclipse左边栏中创建好的repository。展开repository,找到最近版本的tomcat 7.0.x. 展开， 选择trunk.右键点击，在菜单中选择"check out".

4， 文件tc7.0.x将会被下载到workspace目录，于是产生了目录 workspace\tc7.0.x 。

Build源码

在下载好的tc7.0.x目录下面，可以找到BUILDING.txt。这个文件里面给出了详细的Build方法。也列出了所有的build命令。如果大家只是想快速进行下去，可以按照我下面写的步骤快速搭建你的环境。

1，在下载好的文件下面，找到build.properties.default. 复制这个文件，到同级目录并重命名为build.properties.

2，打开build.properties, 找到base.path，替换此行，改为base.path=C:/job/tomcat-build-download.   Base path声明了tomcat build所依赖的外部资源的目录。Build过程中所有的网络依赖资源，都下载到此目录下面。

3，在tc7.0.x目录下运行命令ant.

ant成功后，外部依赖会下载到base.path下面。Source code会被build成可运行文件，输出到\job\workspace\tc7.0.x\output中。

导入eclipse

1，创建一个空的eclipse java project。起名为tomcat.

2，点击项目->右键菜单->import... -> File System->

3, 点击Finish，将会完成导入。

4，源代码成功的导入到eclipse中，但是存在编译错误。这是因为缺失了一些编译所依赖的包。下面我们找出所有的依赖包，将他们放入目录tomcat-compile-dependence中。

5，在build的时候，ant会下载一些依赖包，当完成编译以后，ant会把一些依赖包删除掉。为了把所有的依赖包重新下载一边，需要在tc7.0.x目录下运行命令ant extras

6,找到下面的jar，把他们copy到tomcat-compile-dependence中。

C:\job\apache-ant-1.8.3\lib\ant.jar

C:\job\tomcat-build-download\ecj-3.7.2\ecj-3.7.2.jar

C:\job\tomcat-build-download\jaxrpc-1.1-rc4\geronimo-spec-jaxrpc-1.1-rc4.jar

C:\job\tomcat-build-download\wsdl4j-1.6.2\wsdl4j-1.6.2.jar

7，将tomcat-compile-dependence中所有的包导入project的build path中。tomcat编译通过。

在eclipse中运行源码

打开run as configuration...

点击run，就能跑起来了。

能在eclipse中运行，自然就能debug。

2013年1月29日,更新

更新原因: 因为tomcat的源码是运行在eclipse中,并直接运行的java类启动tomcat的. 突然有一天,我写了一个application, 并放在tomcat的webApps下面. 我想remote debug我的application. 这需要开启tomcat的remote debug模式. 其实,就是开启jvm的debug模式, 开启方法如下图:

如过想开启tomcat的log，还需要在VM arguments中添加：

-Djava.util.logging.config.file=d:\servers\tomcatSrc\src\output\build\conf\logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager