189 8069 5689

Tomcat9源代码浅析-环境搭建-创新互联

1.概要

Apache Tomcat是一个非常受欢迎的开源Web容器,使用Java语言开发。

成都创新互联服务电话:18980820575,为您提供成都网站建设网页设计及定制高端网站建设服务,成都创新互联网页制作领域十年,包括广告设计等多个方面拥有多年的营销推广经验,选择成都创新互联,为网站锦上添花。

近期公司开始推行开源技术的应用,目前正在将Weblogic替换为Tomcat,我们称之为W2T。本系列为项目过程中对 Tomcat 9源代码分析的记录,过程中主要参考了官方文档以及网络上的博客。
本篇为源代码分析的第一步,源代码环境的构建。

2.构建步骤

完整的构建步骤说明为源代码中的BUILDING.txt文件,本过程大部分内容为该文件的翻译,本文构建平台为Windows操作系统。

2.1基础环境准备

JDK的下载和安装

  • 版本要求:version 8 of Java Development Kit (JDK) release
  • 载地址: http://www.oracle.com/technetwork/java/javase/downloads/index.html

  • 设置环境变量:

      JAVA_HOME:计算机中JDK安装的绝对路径
      CLASSPATH:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
      PATH:%JAVA_HOME%\bin
    

    ANT的下载和安装

  • 版本要求:version 1.9.8 or later
  • 下载地址: https://ant.apache.org/bindownload.cgi
  • 设置环境变量:

      ANT_HOME:计算机中ANT安装的绝对路径
      PATH: %ANT_HOME%\bin
    

    2.2 构建Tomcat

    Tomcat9源代码下载

    Tomcat9源代码可通过Git仓库checkout也可以在官网下载代码压缩包。

    • Tomcat GitHub repository URL: https://github.com/apache/tomcat

    • Source packages can be downloaded from: @VERSION_MAJOR_#_@_#_0.cgi"">https://tomcat.apache.org/download-@VERSION_MAJOR@0.cgi

Ant构建

  • 首先在项目根目录创建文件==build.properties==,其内容可直接复制==build.properties.default==
  • Ant构建时会下载Tomcat所依赖的lib文件,下载路径由属性==base.path==指定,默认为${user.home}/tomcat-build-libs
  • 进入到项目目录,运行ant命令开始构建
    cd ${tomcat.source}
    ant
    
    构建成功后,在目录${tomcat.source}/output/build下就是一个我们平时下载的Tomcat容器,可以使用startup.bat、startup.sh、shutdown.bat、shutdown.sh等命令进行操作。

2.3 编译运行源代码

编译源代码

本文为使用IntelliJ IDEA编译运行源代码,因Tomcat是使用Ant构建的,所以并没有依据项目工程结构添加依赖,导入IDEA中会提示编译错误,需要先将源代码改造为Maven结构,通过Maven进行编译。
当然也可以将项目视为简单Java项目进行构建,需要为项目添加base.path指定的tomcat-build-libs中jar包依赖,但IDEA在编译Java项目时不会复制非java文件,例如properties、xml等,如果以此方式运行源代码,则不能使用IDEA,可以改用eclipse。

在项目根目录添加pom.xml文件,并在添加为maven项目,之后可以通过可视化操作或者命令进行编译。



    4.0.0
    org.apache.tomcat
    Tomcat9
    Tomcat9
    9
    
        D:/tomcat9/tomcat-build-libs
        D:/software/apache-ant-1.9.13
    
    
        Tomcat9
        java
        test
        
            
                java
            
        
        
           
                test
           
        
        
            
                org.apache.maven.plugins
                maven-compiler-plugin
                2.3
                
                    UTF-8
                    1.8
                    1.8
                
            
        
    
    
        
            junit
            junit
            4.12
            test
        
        
            ecj
            ecj
            4.12
            system
            ${base.path}/ecj-4.12/ecj-4.12.jar
        
        
            saaj-api
            saaj-api
            1.3.5
            system
            ${base.path}/saaj-api-1.3.5/saaj-api-1.3.5.jar
        
        
            jaxrpc
            jaxrpc
            1.1
            system
            ${base.path}/jaxrpc-1.1-rc4/geronimo-spec-jaxrpc-1.1-rc4.jar
        
        
            wsdl4j
            wsdl4j
            1.6.3
            system
            ${base.path}/wsdl4j-1.6.3/wsdl4j-1.6.3.jar
        
        
            ant
            ant
            1.9.3
            system
            ${ant.home}/lib/ant.jar
        
        
            org.easymock
            easymock
            3.4
        
    

操作完成后,项目结构如下图:
Tomcat9源代码浅析-环境搭建
此时在Test目录中仍然存在编译错误,原因是Test对tomcat/webapps/examples 进行了引用,在File->Project Structure中添加依赖
Tomcat9源代码浅析-环境搭建
Tomcat9源代码浅析-环境搭建

运行源代码

Tomcat的入口为org.apache.catalina.startup.Bootstrap的main方法,但在运行前需要设定环境变量==catalina.home==,用于指定Tomcat的根目录,否则运行时会提示某些配置文件不存在。以我本地为例,设置了构建后的目录路径。

-Dcatalina.home=D:\apache-tomcat-9.0.24-src\output\build

Tomcat9源代码浅析-环境搭建
至此,Tomcat9的环境搭建完毕,运行Bootstrap的main方法,启动Tomcat。

[ 在运行时控制台出现了中文乱码的问题,经查看为国际化的问题,此处没有进行深入研究,直接将语言环境设置为英文,设置了JVM参数:-Duser.language=en]


网页名称:Tomcat9源代码浅析-环境搭建-创新互联
文章出自:http://jkwzsj.com/article/dgpcgh.html

其他资讯