Tomcat源码编译

编译Tomcat源码,使用以下环境:

名称 版本
macOS 10.15.6
Git 2.24.3
IntelliJ IDEA 2020.1.2
JDK IntelliJ IDEA中的OpenJDK14
Maven IntelliJ IDEA中的Maven3.6.3
Tomcat源码 10.0

Tomcat项目是基于Ant + Eclipe构建的,但是现在很多开发人喜欢用Maven + IDEA,所以本文将基于这个环境来构建Tomcat源码。

改造成Maven项目

父目录

创建

1
2
# 创建父目录tomcat-source
mkdir tomcat-source && cd tomcat-source

配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 创建父目录的pom文件
echo '<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

<modelVersion>4.0.0</modelVersion>
<groupId>gxf</groupId>
<artifactId>tomcat-source</artifactId>
<name>tomcat-source</name>
<version>1.0</version>
<packaging>pom</packaging>
<modules>
<module>tomcat</module>
</modules>
</project>
' > pom.xml

子目录

下载源码

1
git clone https://github.com/apache/tomcat.git

配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# 创建子目录的pom文件
echo '<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

<modelVersion>4.0.0</modelVersion>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat</artifactId>
<name>tomcat</name>
<version>10</version>


<build>
<finalName>Tomcat10.0</finalName>
<sourceDirectory>java</sourceDirectory>
<testSourceDirectory>test</testSourceDirectory>
<resources>
<resource>
<directory>java</directory>
</resource>
</resources>
<testResources>
<testResource>
<directory>test</directory>
</testResource>
</testResources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0.2</version>

<configuration>
<encoding>UTF-8</encoding>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>

<dependencies>
<dependency>
<groupId>org.easymock</groupId>
<artifactId>easymock</artifactId>
<version>3.5</version>
<scope>test</scope>
</dependency>

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>ant</groupId>
<artifactId>ant</artifactId>
<version>1.7.0</version>
</dependency>
<dependency>
<groupId>wsdl4j</groupId>
<artifactId>wsdl4j</artifactId>
<version>1.6.2</version>
</dependency>
<dependency>
<groupId>javax.xml</groupId>
<artifactId>jaxrpc</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<groupId>org.eclipse.jdt.core.compiler</groupId>
<artifactId>ecj</artifactId>
<version>4.6.1</version>
</dependency>
</dependencies>
</project>
' > tomcat/pom.xml

配置Catalina目录

1
2
3
4
5
# 在父目录创建catalina-home
mkdir catalina-home

# 把子目录的conf复制到catalina-home
cp -r tomcat/conf catalina-home

在IDEA中编译

打开项目

IDEA工具栏:File -> Open -> 选择tomcat-source。

编译

IDEA功能区:Build Project(锤子按钮)。

我这里JDTCompiler、TestStream、TestCookieFilter三个类报错,直接注释三个类的内容,再次编译就可以了。

paste image

在IDEA中启动

IDEA配置启动类Bootstrap,同时需要配置VM Options,再运行启动类:

1
2
3
4
5
-Dcatalina.home=catalina-home
-Dcatalina.base=catalina-home
-Djava.io.tmpdir=catalina-home/temp
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-Djava.util.logging.config.file=catalina-home/conf/logging.properties

paste image

测试

创建Web应用

1
2
3
4
5
# 创建应用的目录
mkdir catalina-home/webapps/ROOT

# 创建测试页面
echo 'Tomcat10 source' > catalina-home/webapps/ROOT/index.html

浏览器访问

访问http://localhost:8080 ,将能看到Tomcat10 source

总结

Tomcat的Maven+IDEA环境已经搭好。Tomcat启动类是Bootstrap,后边将逐步学习Tomcat源码。

坚持原创技术分享,您的支持将鼓励我继续创作!