编译Tomcat5.5.x

1. 准备工作：
1.1 系统信息：
OS : Windows XP Professional 2002 SP2
CPU: Intel(R) Core(TM)2 Duo T5870 2GHz
RAM: 2G
1.2 构建工具：
JDK: 1.6.0_13(HotSpot)
ANT: 1.7.1
SVN: 1.6.4

2. 下载源码:
cd F:/env/leisore/tomcat/tc5.5.x
co http://svn.apache.org/repos/asf/tomcat/tc5.5.x/trunk F:/env/leisore/tomcat/tc5.5.x/trunk

3. 创建依赖库存放文件夹：
cd F:/env/leisore/tomcat/tc5.5.x/trunk
mkdir lib

5. 准备build.properties：
5.1 进入F:\env\leisore\tomcat\tc5.5.x\trunk\build，将build.properties.default
copy一份，名字修改为build.properties
5.2 修改build.properties中的base.path，指定为lib的绝对路径:
base.path=F:/env/leisore/tomcat/tc5.5.x/trunk/lib

6. 下载依赖库：
6.1 进入F:\env\leisore\tomcat\tc5.5.x\trunk\build
6.2 执行命令：
ant download

7. 构建时出错：
7.1 下载过程中构建DBCP时出错，内容如下：
============================================================================================
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\
dbcp\dbcp\DelegatingDatabaseMetaData.java:41: org.apache.tomcat.dbcp.dbcp.DelegatingDatabaseMetaData
不是抽象的，并且未覆盖 java.sql.DatabaseMetaData 中的抽象方法 getFunctionColumns(java.lang.String,
java.lang.String,java.lang.String,java.lang.String)
[javac] public class DelegatingDatabaseMetaData extends AbandonedTrace
[javac] ^
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\
dbcp\dbcp\DelegatingResultSet.java:61: org.apache.tomcat.dbcp.dbcp.DelegatingResultSet 不是抽象的，并且
未覆盖 java.sql.ResultSet 中的抽象方法 updateNClob(java.lang.String,java.io.Reader)
[javac] public class DelegatingResultSet extends AbandonedTrace implements ResultSet {
[javac] ^
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\dbcp\dbcp\
PoolableCallableStatement.java:38: org.apache.tomcat.dbcp.dbcp.PoolableCallableStatement 不是
抽象的，并且未覆盖 java.sql.CallableStatement 中的抽象方法 setNClob(java.lang.String,java.io.Reader)
[javac] public class PoolableCallableStatement extends DelegatingCallableStatement implements
CallableStatement {
[javac] ^
......
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\dbcp\dbcp\
datasources\SharedPoolDataSource.java:52: org.apache.tomcat.dbcp.dbcp.datasources.SharedPoolDataSource
不是抽象的，并且未覆盖 java.sql.Wrapper 中的抽象方法 isWrapperFor(java.lang.Class)
[javac] public class SharedPoolDataSource
[javac] ^
[javac] 注意：某些输入文件使用或覆盖了已过时的 API。
[javac] 注意：要了解详细信息，请使用 -Xlint:deprecation 重新编译。
[javac] 14 错误

BUILD FAILED
F:\env\leisore\tomcat\tc5.5.x\trunk\build\build.xml:2094: The following error occurred while executing this line:
============================================================================================

7.2 Google了一下也没有找到为什么出错，但是在下载的dbcp的README.txt总看到如下信息：
README.txt位置：F:\env\leisore\tomcat\tc5.5.x\trunk\lib\commons-dbcp-1.3-src
信息：
============================================================================================
DBCP 1.4 compiles and runs under JDK 1.6 only (JDBC 4)
DBCP 1.3 compiles and runs under JDK 1.4-1.5 only (JDBC 3)
============================================================================================
于是决定试试DBCP1.4，因为JDK是1.6，修改build.properties中那个的DBCP项：
修改前：
============================================================================================
# ----- Commons DBCP, version 1.1 or later -----
# commons-dbcp.version=1.3
commons-dbcp.version=1.3
============================================================================================
修改后：
============================================================================================
# ----- Commons DBCP, version 1.1 or later -----
# commons-dbcp.version=1.4
commons-dbcp.version=1.4
============================================================================================
继续编译：
ant download
7.3 还是出错，信息为：
============================================================================================
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\
dbcp\dbcp\PoolingDataSource.java:89: -source 1.4 中不支持泛型
[javac] （请使用 -source 5 或更高版本以启用泛型）
[javac] public boolean isWrapperFor(Class<?> iface) throws SQLException {
[javac] ^
[javac] F:\env\leisore\tomcat\tc5.5.x\trunk\lib\tomcat-deps\dbcp\src\java\org\apache\tomcat\
dbcp\dbcp\datasources\InstanceKeyDataSource.java:171: -source 1.4 中不支持泛型
[javac] （请使用 -source 5 或更高版本以启用泛型）
[javac] public boolean isWrapperFor(Class<?> iface) throws SQLException {
[javac] ^
[javac] 7 错误

BUILD FAILED
============================================================================================
这次的错误就比较明显了，继续修改build.properties：
============================================================================================
compile.source=1.5
compile.target=1.5
============================================================================================
修改前均为1.4，修改完继续编译：
ant download

8. 依赖库下载成功：
经过上边的折腾，ant download成功，可以看到lib下有如下依赖库：
============================================================================================
commons-beanutils-1.7.0
commons-collections-3.2
commons-digester-1.8
commons-el-1.0
commons-logging-1.1.1
commons-modeler-2.0.1
commons-fileupload-1.2
commons-io-1.4
xerces-2_9_1
mx4j-3.0.2
junit3.8.2
commons-launcher
nsis-2.46
struts-1.2.9-bin
commons-daemon-1.0.7
tomcat-native-1.1.22
javamail-1.4.1
jaf-1.1.1
servlet-api-2.4
jsp-api-2.0
commons-pool-1.5.5-src
tomcat-deps
commons-dbcp-1.3-src
commons-dbcp-1.4-src
ecj-3.7
============================================================================================

9. 编译tomcat源码：
9.1 设置ant的jvm属性：
set ANT_OPTS=-Xms1024M -Xmx1024M
9.2 编译tomcat：
进入F:\env\leisore\tomcat\tc5.5.x\trunk\build
执行命令：
ant

10. 编译成功：
============================================================================================
BUILD SUCCESSFUL
Total time: 39 seconds
============================================================================================
可以看见在F:\env\leisore\tomcat\tc5.5.x\trunk\build下游如下目录：
============================================================================================
classes
server
common
bin
conf
docs
lib
tests
logs
shared
work
temp
webapps
============================================================================================

11. 构建release版本:
11.1 修改 build.properties：
============================================================================================
full.dist=on
============================================================================================
11.2 构建release版本：
============================================================================================
cd F:\env\leisore\tomcat\tc5.5.x\trunk\build
ant release
============================================================================================
11.2 构建成功：
在F:\env\leisore\tomcat\tc5.5.x\trunk\build有如下目录：
============================================================================================
release
└─v5.5.34
│ KEYS
│ RELEASE-NOTES
│ README.html
│
├─bin
│ apache-tomcat-5.5.34.exe
│ apache-tomcat-5.5.34.exe.md5
│ apache-tomcat-5.5.34.zip
│ apache-tomcat-5.5.34.zip.md5
│ apache-tomcat-5.5.34.tar.gz
│ apache-tomcat-5.5.34.tar.gz.md5
│ apache-tomcat-5.5.34-embed.zip
│ apache-tomcat-5.5.34-embed.zip.md5
│ apache-tomcat-5.5.34-embed.tar.gz
│ apache-tomcat-5.5.34-embed.tar.gz.md5
│ apache-tomcat-5.5.34-deployer.zip
│ apache-tomcat-5.5.34-deployer.zip.md5
│ apache-tomcat-5.5.34-deployer.tar.gz
│ apache-tomcat-5.5.34-deployer.tar.gz.md5
│ apache-tomcat-5.5.34-compat.zip
│ apache-tomcat-5.5.34-compat.zip.md5
│ apache-tomcat-5.5.34-compat.tar.gz
│ apache-tomcat-5.5.34-compat.tar.gz.md5
│ apache-tomcat-5.5.34-admin.zip
│ apache-tomcat-5.5.34-admin.zip.md5
│ apache-tomcat-5.5.34-admin.tar.gz
│ apache-tomcat-5.5.34-admin.tar.gz.md5
│ apache-tomcat-5.5.34-fulldocs.tar.gz
│ apache-tomcat-5.5.34-fulldocs.tar.gz.md5
│ README.html
│
└─src
apache-tomcat-5.5.34-src.zip
apache-tomcat-5.5.34-src.zip.md5
apache-tomcat-5.5.34-src.tar.gz
apache-tomcat-5.5.34-src.tar.gz.md5

12. 测试：
12.1 进入F:\env\leisore\tomcat\tc5.5.x\trunk\build，执行：
ant clean-tester run-tester
12.2 测试成功

13. 至此，tomcat构建完毕。