前言
Tomcat作为我们常用的web服务器,还是有必要深入学习以下的。本章是我记录Tomcat学习的第一篇文章,将会记录tomcat7
和tomcat8
在IDEA
上编译运行的过程,运行环境是JDK1.8
。
在IDEA
上编译运行tomcat源码将会基于Maven
,因此需要先了解Maven
的g、a、v
概念,这样方便处理编译运行过程中可能出现的问题。g
也就是Group Id
,表示组织名称,a
是Artifact Id
,表示项目名称,v
是Version
,表示版本号,这三者合在一起俗称坐标,就是创建的项目在Maven
本地仓库的目录位置。
举个例子:
在我的本地Maven
仓库中有个分级目录org\apache\maven
,在IDEA
中是org.apache.maven
,也就是Group ID
即组织。
该组织下有个plugins\maven-compiler-plugin
,在IDEA
中是plugins.maven-compiler-plugin
,也就是项目名称。在该项目下又分了若干个版本,即为版本号Version
。
Maven
安装可参考我的另一篇文章:STS创建Maven工程配置Spring实现登陆注册功能的过程,至于如何在IDEA
中配置Maven
,这个网上一大堆,可自行百度。
tomcat7
和tomcat8
的源码都是官网上的,网址是http://archive.apache.org/dist/tomcat/
,由于下载速度比较慢,我下载下来后上传到了网盘。
一、Tomcat7源码的编译运行
下载源码压缩包,解压后,如图:
在该目录下创建一个pom.xml
文件:
编辑该文件,复制以下内容:
<?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>Tomcat7.0</artifactId>
<name>Tomcat</name>
<version>7.0</version>
<build>
<finalName>Tomcat7</finalName>
<sourceDirectory>java</sourceDirectory>
<!--<testSourceDirectory>test</testSourceDirectory> test 下的有些文件报错,因此将test文件夹去掉了-->
<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>3.5.1</version>
<configuration>
<encoding>UTF-8</encoding>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.6</version>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>ant</groupId>
<artifactId>ant</artifactId>
<version>1.6.5</version>
</dependency>
<dependency>
<groupId>org.easymock</groupId>
<artifactId>easymock</artifactId>
<version>3.4</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.2.2</version>
</dependency>
</dependencies>
</project>
接下来在IDEA
中打开项目:
找到刚才解压的目录,选中打开:
打开项目后会被识别成Maven
项目,开始下载pom.xml
中的依赖项:
下载过程中往往会报以下的错误:
Cannot resolve plugin org.apache.maven.plugins:maven-compiler-plugin:3.5.1
Cannot resolve plugin org.apache.maven.plugins:maven-jar-plugin:2.6
Cannot resolve plugin org.apache.maven.plugins:maven-deploy-plugin:2.7
Cannot resolve plugin org.apache.maven.plugins:maven-site-plugin:3.3
不要慌,这是下载包的过程中出错,导致下载未完成,可能跟Maven
配置的阿里云镜像源有关。在网页中搜maven
,找到Maven Repository: Search/Browse/Explore
打开:
通过验证后进入到maven
远程仓库页面:
找到第一条报错:
Cannot resolve plugin org.apache.maven.plugins:maven-compiler-plugin:3.5.1
就是无法下载版本为3.5.1
的maven-compiler-plugin
呗,那么我们就直接搜索maven-compiler-plugin
找到对应的版本号3.5.1
:
点击下载:
下载完成后,根据前面讲的g、a、v
概念,将找到本地仓库相应的位置:
将下载失败的那些文件全部删除掉,再将刚才下载的jar包移动到该文件夹:
对于另外的几个报错,解决办法和上面的操作一样。
Cannot resolve plugin org.apache.maven.plugins:maven-jar-plugin:2.6
Cannot resolve plugin org.apache.maven.plugins:maven-deploy-plugin:2.7
Cannot resolve plugin org.apache.maven.plugins:maven-site-plugin:3.3
弄好之后,回到IDEA
,Ctrl A + Ctrl X
将pom.xml
文件的内容全部剪切,再Ctrl S
保存,此时会弹出import changes
:
将刚才剪切的内容再粘贴回去,保存,点击import changes
,就不会再报错了:
接下来便是编译运行tomcat7源码。
相关设置如下图:
其中Name
可随意设置,Main class
一定要写为org.apache.catalina.startup.Bootstrap
,VM options
写为:
-Dcatalina.home=D:\idea_projects_2019.2.4\apache-tomcat-7.0.100-src
-Dfile.encoding=UTF-8
-Duser.region=us
-Duser.language=en
其中-Dcatalina.home
要改为自己解压的tomcat目录。
点击Apply
和OK
。
接下来重构项目:
重构会报找不到符号的错误:
解决办法便是将JDTCompiler.java
中的372-373
两行注释掉,将440-443
四行注释掉:
再次重构,成功:
接下来运行tomcat7:
emm运行成功,但是报了几个找不到类的错,上网查阅,说是把webapps
目录下的exsamples
目录删掉就行:
删除之后,重新运行:
成功。
接下来测试,将我之前打包好的Login3.war
放到webapps
目录下,过一会自动完成解压:
访问localhost:8080/Login3
:
说明Tomcat7
源码成功在IDEA
编译运行。
我将编译好的源码放在了gitee上面:
https://gitee.com/as_gygutgkj/apache-tomcat-7.0.100-src.git
二、Tomcat8源码的编译运行
和Tomcat7
差不多。
解压:
在解压后的根目录下创建pom.xml
并写入:
<?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>Tomcat8.0</artifactId>
<name>Tomcat8.0</name>
<version>8.0</version>
<build>
<finalName>Tomcat8.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>3.5.1</version>
<configuration>
<encoding>UTF-8</encoding>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.6</version>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>ant</groupId>
<artifactId>ant</artifactId>
<version>1.6.5</version>
</dependency>
<dependency>
<groupId>org.easymock</groupId>
<artifactId>easymock</artifactId>
<version>3.4</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.2.2</version>
</dependency>
</dependencies>
</project>
在IDEA
中打开项目:
这里在下载依赖的时候若报Cannot resolve plugin org.apache.maven.plugins
的错,参照上面Tomcat7
的解决办法。
接下来Add Configuration
:
其中Name
可随意设置,Main class
一定要写为org.apache.catalina.startup.Bootstrap
,VM options
写为:
-Dcatalina.home=D:\idea_projects_2019.2.4\apache-tomcat-8.5.51-src
-Dfile.encoding=UTF-8
-Duser.region=us
-Duser.language=en
其中-Dcatalina.home
要改为自己解压的tomcat目录。
接下来构建项目:
出现了上面Tomcat7
一样的问题:
解决:
注释掉341-342
两行代码,注释掉409-412
四行代码。
再次构建项目,不再报错:
运行项目,又报找不到类的错:
把webapps
目录下的exsamples
目录删掉:
再次运行,不再报错:
测试。将Login3.war
复制到webapps
目录下,tomcat会自动解压:
访问localhost:8080/Login3
,报下面的错:
这是因为Tomcat内部使⽤了SPI机制来初始化jsp相关的东⻄,⼿动运⾏源码的过程中默认不会去初始化jsp相关的东西。
找到res/META-INF/jasper,jar/services
文件夹,复制:
在工程根目录新建resources
文件夹,在里面创建META-INF
文件夹,将刚才复制的services
文件夹复制进去。
右键resources
文件夹,选择Make Directory as
,点击Resources Root
重启Tomcat8
,再次访问localhost:8080/Login3
:
成功。
编译好的Tomcat8
源码gitee地址:
https://gitee.com/as_gygutgkj/apache-tomcat-8.5.51-src.git
总结
编译好了Tomcat
源码,接下来就是深入学习其机制了。