解析Tomcat的启动脚本--startup.bat

 更新时间:2016年12月13日 10:23:21   作者:削个椰子皮  
本文主要对Tomcat的三个最重要的启动脚本之一--startup.bat脚本做了详细分析,具有很好的参考价值,需要的朋友可以看下

概述

我们通常使用 Tomcat 中的 startup.bat 来启动 Tomcat. 但是这其中干了一些什么事呢?

大家都知道一个 Java 程序需要启动的话, 肯定需要 main 方法, 那么这个 main 方法在哪呢?

Tomcat 脚本中又是配置了一些什么参数呢, 什么情况下 Tomcat 会启动失败呢?

带着一些列的疑问我们来分析 Tomcat 的三个最重要的启动脚本:

  • startup.bat
  • catalina.bat
  • setclasspath.bat

startup.bat 脚本

该脚本主要做了以下几件事:

  • 设置 CATALINA_HOME 环境变量的值
  • 找到 catalina.bat 脚本
  • 调用 catalina.bat 脚本, 并把参数传过去

贴出简化版本的 startup.bat 脚本的内容

@echo off
rem 执行这个命令之后, 增加或者改动的环境变量只限于匹配到 endlocal 命令或者到达文件末尾.
setlocal
rem 假设 CATALINA_HOME 环境变量没有定义
rem 取当前目录的路径值, 赋给 CURRENT_DIR 变量, 就是 ./apache-tomcat-x.x.xx/bin
set "CURRENT_DIR=%cd%"
rem 如果 CATALINA_HOME 变量值不是 "" 的话, 调到 gotHome 标签处
if not "%CATALINA_HOME%" == "" goto gotHome
rem 如果 CATALINA_HOME 是 "" 的话, 设置 CATALINA_HOME 变量值为 当前目录的路径值(./apache-tomcat-x.x.xx/bin)
set "CATALINA_HOME=%CURRENT_DIR%"
rem 判断当前路径下的是否有 bin\catalina.bat, 也就是 ./apache-tomcat-x.x.xx/bin/bin/catalina.bat
rem 如果存在的话, 直接调到 okHome 标签处, 显然是不存在的
if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
rem 不存在的话, CATALINA_HOME 取上级目录的值, 也就是(./apache-tomcat-x.x.xx/)
cd ..
set "CATALINA_HOME=%cd%"
rem 进入 CURRENT_DIR(./apache-tomcat-x.x.xx/bin)
cd "%CURRENT_DIR%"
:gotHome
rem 通过上面的设置, CATALINA_HOME 的值已经是: ./apache-tomcat-x.x.xx/
rem 所以整理是可以找到 catalina.bat 脚本的, 直接调到 okHome 标签处
if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
echo The CATALINA_HOME environment variable is not defined correctly
echo This environment variable is needed to run this program
goto end
:okHome
rem 设置 EXECUTABLE 变量指向为 catalina.bat 脚本
set "EXECUTABLE=%CATALINA_HOME%\bin\catalina.bat"
rem 检查目标可执行文件(catalina.bat)是否存在, 通常情况下是存在的, 直接调到 okExec 标签处
rem 如果不存在的话, 直接退出. 启动 Tomcat 结束
if exist "%EXECUTABLE%" goto okExec
echo Cannot find "%EXECUTABLE%"
echo This file is needed to run this program
goto end
:okExec
rem 获取剩余的没有用 shift 取出来的命令行参数, 并保存它们在 CMD_LINE_ARGS
set CMD_LINE_ARGS=
:setArgs
rem 如果第一个命令行参数是空的话, 跳到 doneSetArgs 标签处
rem "%1" : 表示执行命令之后的第一个参数
if ""%1""=="""" goto doneSetArgs
rem 第一个参数不是空的话, 拼接到 CMD_LINE_ARGS 变量
set CMD_LINE_ARGS=%CMD_LINE_ARGS% %1
rem 这个命令可以自行百度
shift
goto setArgs
:doneSetArgs
rem 上面设置了 EXECUTABLE 变量的值是指向了 catalina.bat 脚本, 这个利用 call 命令执行调用, 并把参数传进去
rem 接下来, 咱们看 catalina.bat 脚本的内容
rem 完整的命令: ./apache-tomcat-x.x.xx/bin/catalina.bat start
call "%EXECUTABLE%" start %CMD_LINE_ARGS%
:end

要想理解脚本中的一些命令, 首先来了解一下常用的命令(我们用的 Window 版的)

  • rem : 该命令后的代码不会被执行, 相当于注释
  • @echo off : 关闭命令的显示, 如果没有设置, 执行了哪些命令都会显示出来
  • echo : 输出后面的内容
  • setlocal : 执行这个命令之后, 增加或者改动的环境变量的作用范围只限于匹配到 endlocal 命令或者到达文件末尾.
  • set : 设置一个变量
  • :xxx : 定义一个标签
  • goto : 跳转到制定的标签处
  • call : 执行命令

我们来一行行分析 startup.bat 脚本

set "CURRENT_DIR=%cd%"

%cd% : 表示文件所在的目录的路径

如果我们解压的 Tomcat 所在的目录为 D:/apache-tomcat-x.x.x/ . 因为 startup.bat 命令在 bin 目录下, 所以此时 %cd% 表示的目录是 D:/apache-tomcat-x.x.x/bin

if not "%CATALINA_HOME%" == "" goto gotHome

我们通常情况下不会配置 CATALINA_HOME 这个环境变量的, 所以这里不会调到 gotHome 标签处.

set "CATALINA_HOME=%CURRENT_DIR%"

直接把当前目录假设为 CATALINA_HOME 的值

if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome

然后通过固定的格式来判断一下是否有 catalina.bat 脚本, 当然这里是肯定不会存在的, 因为 CATALINA_HOME = D:/apache-tomcat-x.x.x/bin

cd ..
set "CATALINA_HOME=%cd%"

因为 Tomcat 的目录格式是固定的, 所以这里直接进入上级目录(cd ..), 然后设置 CATALINA_HOME 的值为上级目录( D:/apache-tomcat-x.x.x ).

if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
echo The CATALINA_HOME environment variable is not defined correctly
echo This environment variable is needed to run this program
goto end

继续往下看, 这里又一次判断了一下 catalina.bat 在这样的目录结构是是否能找到, 如果我们解压完 Tomcat 后, 把 startup.bat 放在非 Tomcat 的 bin 目录下之后, 这里是找不到的, 就直接 goto end, 退出 Tomcat 的启动.

好了, 这里我们直接调到 okHome 标签处.

:okHome
set "EXECUTABLE=%CATALINA_HOME%\bin\catalina.bat"

好了, 这里很简单, 设置一个 EXECUTABLE 变量的值指向 catalina.bat 脚本.

if exist "%EXECUTABLE%" goto okExec
echo Cannot find "%EXECUTABLE%"
echo This file is needed to run this program
goto end

又一次的检查了一下这个脚本是否存在, 存在的话, 直接调到 okExec 标签处, 可以执行了.

如果没有通过检查的话, 依旧退出启动, 并打印错误信息.

:okExec
set CMD_LINE_ARGS=
:setArgs
if ""%1""=="""" goto doneSetArgs
set CMD_LINE_ARGS=%CMD_LINE_ARGS% %1
shift
goto setArgs

先设置了一个 CMD_LINE_ARGS 变量, 并且其值暂且为空

这里出现了一个 ""%1""=="""", 拆开看 就是判断 "%1" 是否等于 "". 那么 "%1" 又是什么呢?

这是 window 批处理的一个语法, 表示的是执行命令之后的第一个参数, 对于这里, 我们并没有传递什么参数, 所以这里的 "%1" 是 ""(空).

直接跳转到 doneSetArgs 标签处.

如果不是空的话, 就拼在后面呗.

这里这个 shift 命令意思就是移除一个参数, 举个例子就知道了:

@echo off
echo "%1"
shift
echo "%1"

建一个 test.bat 批处理程序, 然后把上面代码复制进去, 在 cmd 中执行并给它两个参数

下面是执行结果, 这里大家可以把 @echo off 去掉再执行, 验证一下这个命令的作用

PS D:\> .\test Hello World
"Hello"
"World"
PS D:\>

这样, 大家应该可以理解了.

继续分析

:doneSetArgs
call "%EXECUTABLE%" start %CMD_LINE_ARGS%
:end

在上面设置了 EXECUTABLE = %CATALINA_HOME%\bin\catalina.bat , 所以这里实际上是调用了 catalina.bat 这个脚本, 然后传递一个 start 参数给它.

如果我们在 cmd 中运行 startup.bat 并且后面跟着一些参数的话, 这里也一起传递过去了.

这里实际上就是执行了: %CATALINA_HOME%\bin\catalina.bat start

总结

这个脚本还是挺简单的, 目的就是找到 catalina.bat 并调用它.

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,下篇继续介绍Tomcat相关知识--《解析Tomcat的启动脚本--catalina.bat》,有兴趣的朋友可以看下

相关文章

  • Tomcat安装与配置Native APR模式的教程

    Tomcat安装与配置Native APR模式的教程

    APR是Apache HTTP服务器的支持库,提供了一组映射到下层操作系统的API。通过 tomcat-native 库,使tomcat运行时通过APR更多的调用本地API,达到提升性能的目的。下面这篇文章详细介绍了Tomcat安装与配置Native APR模式的教程,需要的朋友可以参考借鉴,一起来看看吧。
    2017-02-02
  • 一次tomcat源码启动控制台中文乱码的调试过程记录

    一次tomcat源码启动控制台中文乱码的调试过程记录

    平时在使用tomcat做一些服务的时候经常遇到各种乱码问题,下面这篇文章主要给大家介绍了一次tomcat源码启动控制台中文乱码的调试过程,需要的朋友可以参考下
    2021-06-06
  • 详解从源码分析tomcat如何调用Servlet的初始化

    详解从源码分析tomcat如何调用Servlet的初始化

    这篇文章主要介绍了详解从源码分析tomcat如何调用Servlet的初始化,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • 深入理解Tomcat的响应缓冲区大小

    深入理解Tomcat的响应缓冲区大小

    在Tomcat中,响应缓冲区的大小是一个重要的配置参数,合理设置缓冲区大小可以优化数据传输效率,具有一定的参考价值,感兴趣的可以了解一下
    2024-11-11
  • tomcat如何修改默认访问项目名称和项目发布路径

    tomcat如何修改默认访问项目名称和项目发布路径

    这篇文章主要介绍了tomcat如何修改默认访问项目名称和项目发布路径问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-06-06
  • 关于tomcat下启动solr遇到的问题及解决

    关于tomcat下启动solr遇到的问题及解决

    这篇文章主要介绍了关于tomcat下启动solr遇到的问题及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-07-07
  • Tomcat 请求的资源[/XXX/]不可用问题的解决方法

    Tomcat 请求的资源[/XXX/]不可用问题的解决方法

    遇到Tomcat提示资源不可用时,通常是因为请求的文件路径错误或文件未被正确部署,本文就来介绍一下Tomcat 请求的资源[/XXX/]不可用问题的解决方法,感兴趣的可以了解一下
    2024-09-09
  • 使用jenkins将项目部署到另一台主机的过程

    使用jenkins将项目部署到另一台主机的过程

    这篇文章主要介绍了使用jenkins将项目部署到另一台主机的详细过程,这这里手动部署需要关闭防火墙,确保git命令存在,拉取部署的项目包,具体实例代码跟随小编一起看看吧
    2021-10-10
  • Tomcat启动springboot项目war包报错:启动子级时出错的问题

    Tomcat启动springboot项目war包报错:启动子级时出错的问题

    这篇文章主要介绍了Tomcat启动springboot项目war包报错:启动子级时出错的问题,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • 详述 tomcat 中的 server.xml 配置文件示例

    详述 tomcat 中的 server.xml 配置文件示例

    本文将通过实例,介绍server.xml中各个组件的配置,并详细说明 Tomcat 各个核心组件的作用以及各个组件之间的相互关系。对tomcat server.xml 配置文件相关知识感兴趣的朋友一起看看吧
    2017-08-08

最新评论