构建Apache Tomcat 6.0 Servlet/JSP 容器

这个子项目包含了Tomcat 6.0的源代码，一个实现了Java Community Process http://www.jcp.org/ 的Servlet2.5和JSP2.1标准的容器。

注意：如果你只需要运行Tomcat，没有必要去构建它，你可以非常方便的下载一个二进制发布包。它是跨平台的。阅读RUNNING.txt文件，它介绍了怎样去运行它。

请按以下步骤来从源代码构建一个Tomcat的二进制发布版本：

1. 下载并安装JDK

   • 如果JDK已经安装了，跳到步骤2
   • 从下面的地址下载一个Java开发套件(JDK)，使用Java SE 5版本。http://www.oracle.com/technetwork/java/javase/downloads/index.html
     高于Java SE 5的版本注意：
     由于另外的文档表明，Apache Tomcat的其中一个组件包括一个私有的Apache Commons DBCP类库的副本，这个库的源代码已已下载，由构建脚本(renaming the packages)处理并编译。
     由于各版本Java SE规范对JDBC接口实现的不同，这个库不得不指向特定版本的Java和使用这个版本的JDK的实现规范来编译。
     更多此库的可用版本和所需要条件的详细信息请查看Apache Commons DBCP项目的web站点
     http://commons.apache.org/dbcp/
     可以使用更新版本的JDK来构建Tomcat 6.0，但是tomcat-dbcp.jar组件的构建将会跳过并会打印一些警告。
   • 根据包含在发布包中的介绍安装JDK。
   • 设置一个名为JAVA_HOME的环境变量，指向你安装JDK发布包的目录。

2. 在你的电脑上安装Apache Ant 1.8.x

   • 如果电脑上已安装Apache Ant 1.8.x，跳到步骤3
   • 下载Apache Ant 1.8.x的二进制发布包，地址：
     http://ant.apache.org/bindownload.cgi
   • 解压二进制发布包到一个合适的位置，让Ant发布程序可以拥有自己的目录，(约定名为”apache-ant-[version]”)。Ant发布包全目录路径名在本文档以下使用符号”${ant.home}”替代。
   • 创建一个ANT_HOME的环境变量指向目录${ant.home}
   • 修改PATH环境变量包含${ant.home}/bin目录的路径到列表中。这会使用ant脚本命令可用，在构建过程中会起到它的作用。

3. 构建Tomcat 6.0

   1. 检出或以其它方式获得Tomcat 6.0的源代码

      • Tomcat 6.0SVN仓库地址：http://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk/
      • 下载源代码包
        http://tomcat.apache.org/download-60.cgi
      • 使用SVN检出源代码，选择一个已发布的tag版本或者主线版本为当前的开发代码，或者解压一个源代码包，源代码存放目录以${tomcat.source}作为引用名。

   2. 构建

      • 切换到源代码目录，执行以下命令：

        cd ${tomcat.source}
        ant download
        ant

      • 警告：运行”ant download”命令会下载构建Tomcat需要的库文件到/usr/share/java目录下。在典型的Linux或者MacOS系统上，即使你这样做，写到这个目录对你来说可能不合适。在Windows上这个目录通常是和c:\usr\share\java目录一致。除非你使用的是Cygwin。阅读下面的部分学习如何自定义二进这制文件的下载目录。

      • 注意：通过代理访问Internet的用户必须使用一个属性文件指向Ant代理配置。见下文。
      • 可以通过创建一个${tomcat.source}/build.properties文件来控制构建，添加如下内容到文件中：
        

            # ----- 代理设置 -----
            # 如何使用代理服务请解除注释
            #proxy.host=proxy.domain
            #proxy.port=8080
            #proxy.use=on
        
            # ----- 依赖包的默认基准目录 -----
            # 替换需要下载的依赖二进制包的下载目录
            base.path=/home/me/some-place-to-download-to

4. 更新源代码
   建议你使用SVN客户端定期更新Tomcat 6的源代码

5. 重新构建
   你可以使用以下命令为修改的源代码做一个简单的构建

   cd ${tomcat.source}
   ant

6. 构建servlet 和 jsp API文档

   cd ${tomcat.source}
   ant -f dist.xml dist-javadoc

7. 额外的构建(commons-logging, webservices等)

   cd ${tomcat.source}
   ant -f extras.xml

8. 构建一个发布版
   一个完整的发布包包括Windows安装器，需要一个可用的Windows环境来创建它。如果不在Windows环境下构建它，构建脚本采用Wine也是可用的。如果不是这个场景，可以设置skip.installer属性来跳过安装器的创建。

   cd ${tomcat.source}
   ant -f dist.xml release

9. 其它
   本文翻译自Tomcat源代码目录中的BUILDING.txt文件
   注意：尊重劳动成果，转载请注明出处，谢谢！