Tomcat 7 源码分析 - 下载 tomcat source code 并导入eclipse

准备好好研究学习一下tomcat 7 的源代码，那么第一步就是下载，导入eclipse并且运行。
[size=small]1. 下载源代码[/size]
tomcat 7 的源代码在svn上，所以你需要svn的安装。创建一个目录tomcat7，并用命令行进入这个目录，之后用下面的命令下载

svn co http://svn.apache.org/repos/asf/tomcat/tc7.0.x/tags/TOMCAT_7_0_27/ ./

这里我下载的是tag里面的，你也可以下载别的branch，比如trunk，但是我觉得tag的是比较稳定的。

[size=small]2. 创建eclipse项目[/size]
tomcat 7 是用ant来构建和管理的，所以你需要安装ant。在tomcat7目录下执行：

ant ide-eclipse

其实，你看一下build.xml就知道它就是copy了两个现成的文件

<target name="ide-eclipse" depends="deploy, extras-webservices-prepare"
          description="Prepares the source tree to be built in Eclipse">

    <!-- Copy the sample project files into the root directory -->
    <copy file="${tomcat.home}/res/ide-support/eclipse/eclipse.project" tofile="${tomcat.home}/.project"/>
    <copy file="${tomcat.home}/res/ide-support/eclipse/eclipse.classpath" tofile="${tomcat.home}/.classpath"/>

    <echo>Eclipse project files created.
Read the Building page on the Apache Tomcat documentation site for details on how to configure your Eclipse workplace.</echo>
  </target>

这样你就可以在eclipse里面导入这个tomcat 项目了
[size=medium]3. 在eclipse里面添加lib变量[/size]
导入项目以后你会发现有几个错误导致不能编译，其实是缺少lib变量：
ANT_HOME， 指向ant的安装目录
TOMCAT_LIBS_BASE，指向依赖库的位置，如果你还没有在tomcat7下执行：

ant

来build和deploy这个项目，就先执行它。
这样它就会下载需要的lib。[img]http://dl.iteye.com/upload/attachment/0066/1289/4ed721f7-c765-3034-9b51-bc7d09db9712.png[/img]
如果你不确定放到哪里了，你可以搜索ecj-3.7.2，把它的上级目录指定给这个变量就好了。
添加好之后，eclipse会提示你重新build项目，当然要。之后就会没有错误了。

[size=medium]4. 运行[/size]
右击这个tomcat-7.0.x项目，选择run as / Java Application，它会自动搜索项目中的所有main函数，你选择org.apache.catalina.startup.Bootstrap的main函数就是。 选择好了之后，你也许会看到有tomcat-start和tomcat-stop两个启动项让你选择，其实这个是tomcat为你准备好的launch文件，在tomcat7\res\ide-support\eclipse下面有两个launch文件。也就是说你直接可以在run configuration里面找到这两个启动配置，从而加以利用。在run configuration的配置里面的Common tab里面你还可以设置选中debug，从而你可以在debug菜单下显示它了。
[color=red]问题：为什么这个函数的注释写仅仅为了测试：[/color]

 /**
     * Main method, used for testing only.
     *
     * @param args Command line arguments to be processed
     */
    public static void main(String args[]) {

[size=medium]5. 启动好以后你可以打开下面的网址：[/size]

http://localhost:8080/

你会看到欢迎页面，大功告成！你可以在main里面设置断点debug了。
[size=medium]
6. 配置更为详细的log[/size]
看更为详细的log有利于我们准确地跟踪tomcat的执行过程。tomcat的日志框架允许我们配置第三方的log系统实现，比如log4j。默认情况下它使用java.util.logging.
需要两步来实现更为详细的log的配置
1）运行参数，加上

 -Djava.util.logging.config.file=${project_loc:/tomcat-7.0.x}/conf/logging.properties

2）修改log level的配置，把FINE，改成FINEST。并加入：

org.apache.catalina.level = FINEST