在上一篇文章《原始碼執行環境搭建》裡是通過直接執行 BootStarp 的 main 函式來啟動的,只是加了一個 catalina.home 的系統屬性。而正常情況下啟動 Tomcat 是通過執行指令碼的方式,這個就涉及到建立工程時拷貝過來的 script 目錄下的一堆指令碼檔案了。
以我的 windows 系統舉例,實際上最終是執行 startup.bat 這個批處理檔案來啟動 tomcat 的。 那麼啟動分析就衝這個檔案開始吧:一、分析 startup.bat 檔案
startup.bat :
1 @echo off
2 rem Licensed to the Apache Software Foundation (ASF) under one or more
3 rem contributor license agreements. See the NOTICE file distributed with
4 rem this work for additional information regarding copyright ownership.
5 rem The ASF licenses this file to You under the Apache License, Version 2.0
6 rem (the "License"); you may not use this file except in compliance with
7 rem the License. You may obtain a copy of the License at
8 rem
9 rem http://www.apache.org/licenses/LICENSE-2.0
10 rem
11 rem Unless required by applicable law or agreed to in writing, software
12 rem distributed under the License is distributed on an "AS IS" BASIS,
13 rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 rem See the License for the specific language governing permissions and
15 rem limitations under the License.
16
17 if "%OS%" == "Windows_NT" setlocal
18 rem ---------------------------------------------------------------------------
19 rem Start script for the CATALINA Server
20 rem
21 rem $Id: startup.bat 895392 2010-01-03 14:02:31Z kkolinko $
22 rem ---------------------------------------------------------------------------
23
24 rem Guess CATALINA_HOME if not defined
25 set "CURRENT_DIR=%cd%"
26 if not "%CATALINA_HOME%" == "" goto gotHome
27 set "CATALINA_HOME=%CURRENT_DIR%"
28 if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
29 cd ..
30 set "CATALINA_HOME=%cd%"
31 cd "%CURRENT_DIR%"
32 :gotHome
33 if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
34 echo The CATALINA_HOME environment variable is not defined correctly
35 echo This environment variable is needed to run this program
36 goto end
37 :okHome
38
39 set "EXECUTABLE=%CATALINA_HOME%\bin\catalina.bat"
40
41 rem Check that target executable exists
42 if exist "%EXECUTABLE%" goto okExec
43 echo Cannot find "%EXECUTABLE%"
44 echo This file is needed to run this program
45 goto end
46 :okExec
47
48 rem Get remaining unshifted command line arguments and save them in the
49 set CMD_LINE_ARGS=
50 :setArgs
51 if ""%1""=="""" goto doneSetArgs
52 set CMD_LINE_ARGS=%CMD_LINE_ARGS% %1
53 shift
54 goto setArgs
55 :doneSetArgs
56
57 call "%EXECUTABLE%" start %CMD_LINE_ARGS%
58
59 :end
複製程式碼
第 1 行 @echo off
的是關閉顯示命令列自身的意思,接下來一大堆 rem 是註釋,第 17 行 if "%OS%" == "Windows_NT" setlocal
是要臨時修改系統變數,方便批處理執行。第 26 到 33 行的作用是設定 CATALINA_HOME
環境變數,如果作業系統中沒設定,則將當前執行指令碼的目錄作為該環境變數的值,最終都會跳轉到 37 行。39 到 46 行驗證 CATALINA_HOME
變數所示目錄下的 catalina.bat 檔案是否存在,不存在則批處理直接結束。48 到 55 行將執行指令碼前如果設定了其他引數,將引數儲存到 CMD_LINE_ARGS
變數中。最後第 57 行執行 catalina.bat 批處理檔案,注意,該行後面跟著兩個引數,第 1 個引數是 start。
二、分析 catalina.bat 檔案
1 @echo off
2 rem Licensed to the Apache Software Foundation (ASF) under one or more
3 rem contributor license agreements. See the NOTICE file distributed with
4 rem this work for additional information regarding copyright ownership.
5 rem The ASF licenses this file to You under the Apache License, Version 2.0
6 rem (the "License"); you may not use this file except in compliance with
7 rem the License. You may obtain a copy of the License at
8 rem
9 rem http://www.apache.org/licenses/LICENSE-2.0
10 rem
11 rem Unless required by applicable law or agreed to in writing, software
12 rem distributed under the License is distributed on an "AS IS" BASIS,
13 rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 rem See the License for the specific language governing permissions and
15 rem limitations under the License.
16
17 if "%OS%" == "Windows_NT" setlocal
18 rem ---------------------------------------------------------------------------
19 rem Start/Stop Script for the CATALINA Server
20 rem
21 rem Environment Variable Prerequisites
22 rem
23 rem Do not set the variables in this script. Instead put them into a script
24 rem setenv.bat in CATALINA_BASE/bin to keep your customizations separate.
25 rem
26 rem CATALINA_HOME May point at your Catalina "build" directory.
27 rem
28 rem CATALINA_BASE (Optional) Base directory for resolving dynamic portions
29 rem of a Catalina installation. If not present, resolves to
30 rem the same directory that CATALINA_HOME points to.
31 rem
32 rem CATALINA_OPTS (Optional) Java runtime options used when the "start",
33 rem "run" or "debug" command is executed.
34 rem Include here and not in JAVA_OPTS all options, that should
35 rem only be used by Tomcat itself, not by the stop process,
36 rem the version command etc.
37 rem Examples are heap size, GC logging, JMX ports etc.
38 rem
39 rem CATALINA_TMPDIR (Optional) Directory path location of temporary directory
40 rem the JVM should use (java.io.tmpdir). Defaults to
41 rem %CATALINA_BASE%\temp.
42 rem
43 rem JAVA_HOME Must point at your Java Development Kit installation.
44 rem Required to run the with the "debug" argument.
45 rem
46 rem JRE_HOME Must point at your Java Runtime installation.
47 rem Defaults to JAVA_HOME if empty. If JRE_HOME and JAVA_HOME
48 rem are both set, JRE_HOME is used.
49 rem
50 rem JAVA_OPTS (Optional) Java runtime options used when any command
51 rem is executed.
52 rem Include here and not in CATALINA_OPTS all options, that
53 rem should be used by Tomcat and also by the stop process,
54 rem the version command etc.
55 rem Most options should go into CATALINA_OPTS.
56 rem
57 rem JAVA_ENDORSED_DIRS (Optional) Lists of of semi-colon separated directories
58 rem containing some jars in order to allow replacement of APIs
59 rem created outside of the JCP (i.e. DOM and SAX from W3C).
60 rem It can also be used to update the XML parser implementation.
61 rem Defaults to $CATALINA_HOME/endorsed.
62 rem
63 rem JPDA_TRANSPORT (Optional) JPDA transport used when the "jpda start"
64 rem command is executed. The default is "dt_socket".
65 rem
66 rem JPDA_ADDRESS (Optional) Java runtime options used when the "jpda start"
67 rem command is executed. The default is 8000.
68 rem
69 rem JPDA_SUSPEND (Optional) Java runtime options used when the "jpda start"
70 rem command is executed. Specifies whether JVM should suspend
71 rem execution immediately after startup. Default is "n".
72 rem
73 rem JPDA_OPTS (Optional) Java runtime options used when the "jpda start"
74 rem command is executed. If used, JPDA_TRANSPORT, JPDA_ADDRESS,
75 rem and JPDA_SUSPEND are ignored. Thus, all required jpda
76 rem options MUST be specified. The default is:
77 rem
78 rem -agentlib:jdwp=transport=%JPDA_TRANSPORT%,
79 rem address=%JPDA_ADDRESS%,server=y,suspend=%JPDA_SUSPEND%
80 rem
81 rem LOGGING_CONFIG (Optional) Override Tomcat's logging config file
82 rem Example (all one line)
83 rem set LOGGING_CONFIG="-Djava.util.logging.config.file=%CATALINA_BASE%\conf\logging.properties"
84 rem
85 rem LOGGING_MANAGER (Optional) Override Tomcat's logging manager
86 rem Example (all one line)
87 rem set LOGGING_MANAGER="-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager"
88 rem
89 rem TITLE (Optional) Specify the title of Tomcat window. The default
90 rem TITLE is Tomcat if it's not specified.
91 rem Example (all one line)
92 rem set TITLE=Tomcat.Cluster#1.Server#1 [%DATE% %TIME%]
93 rem
94 rem
95 rem
96 rem $Id: catalina.bat 1344732 2012-05-31 14:08:02Z kkolinko $
97 rem ---------------------------------------------------------------------------
98
99 rem Suppress Terminate batch job on CTRL+C
100 if not ""%1"" == ""run"" goto mainEntry
101 if "%TEMP%" == "" goto mainEntry
102 if exist "%TEMP%\%~nx0.run" goto mainEntry
103 echo Y>"%TEMP%\%~nx0.run"
104 if not exist "%TEMP%\%~nx0.run" goto mainEntry
105 echo Y>"%TEMP%\%~nx0.Y"
106 call "%~f0" %* <"%TEMP%\%~nx0.Y"
107 rem Use provided errorlevel
108 set RETVAL=%ERRORLEVEL%
109 del /Q "%TEMP%\%~nx0.Y" >NUL 2>&1
110 exit /B %RETVAL%
111 :mainEntry
112 del /Q "%TEMP%\%~nx0.run" >NUL 2>&1
113
114 rem Guess CATALINA_HOME if not defined
115 set "CURRENT_DIR=%cd%"
116 if not "%CATALINA_HOME%" == "" goto gotHome
117 set "CATALINA_HOME=%CURRENT_DIR%"
118 if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
119 cd ..
120 set "CATALINA_HOME=%cd%"
121 cd "%CURRENT_DIR%"
122 :gotHome
123
124 if exist "%CATALINA_HOME%\bin\catalina.bat" goto okHome
125 echo The CATALINA_HOME environment variable is not defined correctly
126 echo This environment variable is needed to run this program
127 goto end
128 :okHome
129
130 rem Copy CATALINA_BASE from CATALINA_HOME if not defined
131 if not "%CATALINA_BASE%" == "" goto gotBase
132 set "CATALINA_BASE=%CATALINA_HOME%"
133 :gotBase
134
135 rem Ensure that any user defined CLASSPATH variables are not used on startup,
136 rem but allow them to be specified in setenv.bat, in rare case when it is needed.
137 set CLASSPATH=
138
139 rem Get standard environment variables
140 if not exist "%CATALINA_BASE%\bin\setenv.bat" goto checkSetenvHome
141 call "%CATALINA_BASE%\bin\setenv.bat"
142 goto setenvDone
143 :checkSetenvHome
144 if exist "%CATALINA_HOME%\bin\setenv.bat" call "%CATALINA_HOME%\bin\setenv.bat"
145 :setenvDone
146
147 rem Get standard Java environment variables
148 if exist "%CATALINA_HOME%\bin\setclasspath.bat" goto okSetclasspath
149 echo Cannot find "%CATALINA_HOME%\bin\setclasspath.bat"
150 echo This file is needed to run this program
151 goto end
152 :okSetclasspath
153 call "%CATALINA_HOME%\bin\setclasspath.bat" %1
154 if errorlevel 1 goto end
155
156 rem Add on extra jar file to CLASSPATH
157 rem Note that there are no quotes as we do not want to introduce random
158 rem quotes into the CLASSPATH
159 if "%CLASSPATH%" == "" goto emptyClasspath
160 set "CLASSPATH=%CLASSPATH%;"
161 :emptyClasspath
162 set "CLASSPATH=%CLASSPATH%%CATALINA_HOME%\bin\bootstrap.jar"
163
164 if not "%CATALINA_TMPDIR%" == "" goto gotTmpdir
165 set "CATALINA_TMPDIR=%CATALINA_BASE%\temp"
166 :gotTmpdir
167
168 rem Add tomcat-juli.jar to classpath
169 rem tomcat-juli.jar can be over-ridden per instance
170 if not exist "%CATALINA_BASE%\bin\tomcat-juli.jar" goto juliClasspathHome
171 set "CLASSPATH=%CLASSPATH%;%CATALINA_BASE%\bin\tomcat-juli.jar"
172 goto juliClasspathDone
173 :juliClasspathHome
174 set "CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\tomcat-juli.jar"
175 :juliClasspathDone
176
177 if not "%LOGGING_CONFIG%" == "" goto noJuliConfig
178 set LOGGING_CONFIG=-Dnop
179 if not exist "%CATALINA_BASE%\conf\logging.properties" goto noJuliConfig
180 set LOGGING_CONFIG=-Djava.util.logging.config.file="%CATALINA_BASE%\conf\logging.properties"
181 :noJuliConfig
182 set JAVA_OPTS=%JAVA_OPTS% %LOGGING_CONFIG%
183
184 if not "%LOGGING_MANAGER%" == "" goto noJuliManager
185 set LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
186 :noJuliManager
187 set JAVA_OPTS=%JAVA_OPTS% %LOGGING_MANAGER%
188
189 rem ----- Execute The Requested Command ---------------------------------------
190
191 echo Using CATALINA_BASE: "%CATALINA_BASE%"
192 echo Using CATALINA_HOME: "%CATALINA_HOME%"
193 echo Using CATALINA_TMPDIR: "%CATALINA_TMPDIR%"
194 if ""%1"" == ""debug"" goto use_jdk
195 echo Using JRE_HOME: "%JRE_HOME%"
196 goto java_dir_displayed
197 :use_jdk
198 echo Using JAVA_HOME: "%JAVA_HOME%"
199 :java_dir_displayed
200 echo Using CLASSPATH: "%CLASSPATH%"
201
202 set _EXECJAVA=%_RUNJAVA%
203 set MAINCLASS=org.apache.catalina.startup.Bootstrap
204 set ACTION=start
205 set SECURITY_POLICY_FILE=
206 set DEBUG_OPTS=
207 set JPDA=
208
209 if not ""%1"" == ""jpda"" goto noJpda
210 set JPDA=jpda
211 if not "%JPDA_TRANSPORT%" == "" goto gotJpdaTransport
212 set JPDA_TRANSPORT=dt_socket
213 :gotJpdaTransport
214 if not "%JPDA_ADDRESS%" == "" goto gotJpdaAddress
215 set JPDA_ADDRESS=8000
216 :gotJpdaAddress
217 if not "%JPDA_SUSPEND%" == "" goto gotJpdaSuspend
218 set JPDA_SUSPEND=n
219 :gotJpdaSuspend
220 if not "%JPDA_OPTS%" == "" goto gotJpdaOpts
221 set JPDA_OPTS=-agentlib:jdwp=transport=%JPDA_TRANSPORT%,address=%JPDA_ADDRESS%,server=y,suspend=%JPDA_SUSPEND%
222 :gotJpdaOpts
223 shift
224 :noJpda
225
226 if ""%1"" == ""debug"" goto doDebug
227 if ""%1"" == ""run"" goto doRun
228 if ""%1"" == ""start"" goto doStart
229 if ""%1"" == ""stop"" goto doStop
230 if ""%1"" == ""configtest"" goto doConfigTest
231 if ""%1"" == ""version"" goto doVersion
232
233 echo Usage: catalina ( commands ... )
234 echo commands:
235 echo debug Start Catalina in a debugger
236 echo debug -security Debug Catalina with a security manager
237 echo jpda start Start Catalina under JPDA debugger
238 echo run Start Catalina in the current window
239 echo run -security Start in the current window with security manager
240 echo start Start Catalina in a separate window
241 echo start -security Start in a separate window with security manager
242 echo stop Stop Catalina
243 echo configtest Run a basic syntax check on server.xml
244 echo version What version of tomcat are you running?
245 goto end
246
247 :doDebug
248 shift
249 set _EXECJAVA=%_RUNJDB%
250 set DEBUG_OPTS=-sourcepath "%CATALINA_HOME%\..\..\java"
251 if not ""%1"" == ""-security"" goto execCmd
252 shift
253 echo Using Security Manager
254 set "SECURITY_POLICY_FILE=%CATALINA_BASE%\conf\catalina.policy"
255 goto execCmd
256
257 :doRun
258 shift
259 if not ""%1"" == ""-security"" goto execCmd
260 shift
261 echo Using Security Manager
262 set "SECURITY_POLICY_FILE=%CATALINA_BASE%\conf\catalina.policy"
263 goto execCmd
264
265 :doStart
266 shift
267 if not "%OS%" == "Windows_NT" goto noTitle
268 if "%TITLE%" == "" set TITLE=Tomcat
269 set _EXECJAVA=start "%TITLE%" %_RUNJAVA%
270 goto gotTitle
271 :noTitle
272 set _EXECJAVA=start %_RUNJAVA%
273 :gotTitle
274 if not ""%1"" == ""-security"" goto execCmd
275 shift
276 echo Using Security Manager
277 set "SECURITY_POLICY_FILE=%CATALINA_BASE%\conf\catalina.policy"
278 goto execCmd
279
280 :doStop
281 shift
282 set ACTION=stop
283 set CATALINA_OPTS=
284 goto execCmd
285
286 :doConfigTest
287 shift
288 set ACTION=configtest
289 set CATALINA_OPTS=
290 goto execCmd
291
292 :doVersion
293 %_EXECJAVA% -classpath "%CATALINA_HOME%\lib\catalina.jar" org.apache.catalina.util.ServerInfo
294 goto end
295
296
297 :execCmd
298 rem Get remaining unshifted command line arguments and save them in the
299 set CMD_LINE_ARGS=
300 :setArgs
301 if ""%1""=="""" goto doneSetArgs
302 set CMD_LINE_ARGS=%CMD_LINE_ARGS% %1
303 shift
304 goto setArgs
305 :doneSetArgs
306
307 rem Execute Java with the applicable properties
308 if not "%JPDA%" == "" goto doJpda
309 if not "%SECURITY_POLICY_FILE%" == "" goto doSecurity
310 %_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
311 goto end
312 :doSecurity
313 %_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Djava.security.manager -Djava.security.policy=="%SECURITY_POLICY_FILE%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
314 goto end
315 :doJpda
316 if not "%SECURITY_POLICY_FILE%" == "" goto doSecurityJpda
317 %_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %JPDA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
318 goto end
319 :doSecurityJpda
320 %_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %JPDA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Djava.security.manager -Djava.security.policy=="%SECURITY_POLICY_FILE%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
321 goto end
322
323 :end
複製程式碼
1 到 99 行一大堆註釋說明就不看了,100 到 110 行一堆 run 檔案校驗之類的一般用不到,直接跳到 111 行,接下來先刪除上面可能產生的中間檔案,接著按照正常流程,在上面的 startup.bat 檔案中已經設定過CATALINA_HOME
變數,並且校驗了改變數下 bin\catalina.bat 檔案已經存在(我猜作者寫這一段是防止使用者直接執行 catalina.bat 檔案)。經過這些判斷後跳轉到 128 行,130 到 133 行設定CATALINA_BASE
變數,中間幾行註釋略過,139 到 144 行如果有 setenv.bat 檔案則執行一下該檔案。147 到 153 行執行 setclasspath.bat 檔案(該檔案在同級目錄下已經提供,具體指令碼下面已經貼出來了,可以讀一下,這裡不再做分析。主要功能校驗是否設定JAVA_HOME
變數,沒有則在控制檯顯示出提示資訊。注意該檔案中第 79 行將會設定_RUNJAVA
變數,該變數的值即JAVA_HOME
或JRE_HOME
的 bin 目錄下的 java.exe 檔案)。從 156 到 224 行校驗並設定一堆變數(注意第 202、203 和 204 行,最後啟動分析時將會用到)。226 到 231 行將根據呼叫 catalina.bat 時設定的引數決定跳轉,按照上一段的最後的說明,此時將會跳轉到 doStart 標記行。從 265 行開始,校驗和設定一些變數之後(注意第 269 行)將會跳轉到 execCmd 標記行,即 297 行。297 到 305 行作用是將系統引數儲存到CMD_LINE_ARGS
變數中。
接下來便是謎底解開的時候,正常情況下將會執行到 310 行,這裡單獨貼出來分析一下:
%_EXECJAVA% %JAVA_OPTS% %CATALINA_OPTS% %DEBUG_OPTS% -Djava.endorsed.dirs="%JAVA_ENDORSED_DIRS%" -classpath "%CLASSPATH%" -Dcatalina.base="%CATALINA_BASE%" -Dcatalina.home="%CATALINA_HOME%" -Djava.io.tmpdir="%CATALINA_TMPDIR%" %MAINCLASS% %CMD_LINE_ARGS% %ACTION%
按照 202 行的提示_EXECJAVA
一開始的值等於_RUNJAVA
,但在 269 行將該值改成了start "%TITLE%" %_RUNJAVA%
,這裡的作用是另啟動一個命令列視窗,並給視窗起名,最終還是執行 java.exe 檔案。從%JAVA_OPTS%
開始到%MAINCLASS%
之前都是在設定執行時引數和系統屬性,%MAINCLASS%
即 203 行的 org.apache.catalina.startup.Bootstrap,後面是其它的命令列引數,最後一個引數%ACTION%
在 204 行時被設定成 start。歸結起來一句話,即執行 Bootstrap 類的 main 方法。
setclasspath.bat:
1 @echo off
2 rem Licensed to the Apache Software Foundation (ASF) under one or more
3 rem contributor license agreements. See the NOTICE file distributed with
4 rem this work for additional information regarding copyright ownership.
5 rem The ASF licenses this file to You under the Apache License, Version 2.0
6 rem (the "License"); you may not use this file except in compliance with
7 rem the License. You may obtain a copy of the License at
8 rem
9 rem http://www.apache.org/licenses/LICENSE-2.0
10 rem
11 rem Unless required by applicable law or agreed to in writing, software
12 rem distributed under the License is distributed on an "AS IS" BASIS,
13 rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 rem See the License for the specific language governing permissions and
15 rem limitations under the License.
16
17 rem ---------------------------------------------------------------------------
18 rem Set JAVA_HOME or JRE_HOME if not already set, ensure any provided settings
19 rem are valid and consistent with the selected start-up options and set up the
20 rem endorsed directory.
21 rem
22 rem $Id: setclasspath.bat 1202062 2011-11-15 06:50:02Z mturk $
23 rem ---------------------------------------------------------------------------
24
25 rem Make sure prerequisite environment variables are set
26
27 rem In debug mode we need a real JDK (JAVA_HOME)
28 if ""%1"" == ""debug"" goto needJavaHome
29
30 rem Otherwise either JRE or JDK are fine
31 if not "%JRE_HOME%" == "" goto gotJreHome
32 if not "%JAVA_HOME%" == "" goto gotJavaHome
33 echo Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
34 echo At least one of these environment variable is needed to run this program
35 goto exit
36
37 :needJavaHome
38 rem Check if we have a usable JDK
39 if "%JAVA_HOME%" == "" goto noJavaHome
40 if not exist "%JAVA_HOME%\bin\java.exe" goto noJavaHome
41 if not exist "%JAVA_HOME%\bin\javaw.exe" goto noJavaHome
42 if not exist "%JAVA_HOME%\bin\jdb.exe" goto noJavaHome
43 if not exist "%JAVA_HOME%\bin\javac.exe" goto noJavaHome
44 set "JRE_HOME=%JAVA_HOME%"
45 goto okJava
46
47 :noJavaHome
48 echo The JAVA_HOME environment variable is not defined correctly.
49 echo It is needed to run this program in debug mode.
50 echo NB: JAVA_HOME should point to a JDK not a JRE.
51 goto exit
52
53 :gotJavaHome
54 rem No JRE given, use JAVA_HOME as JRE_HOME
55 set "JRE_HOME=%JAVA_HOME%"
56
57 :gotJreHome
58 rem Check if we have a usable JRE
59 if not exist "%JRE_HOME%\bin\java.exe" goto noJreHome
60 if not exist "%JRE_HOME%\bin\javaw.exe" goto noJreHome
61 goto okJava
62
63 :noJreHome
64 rem Needed at least a JRE
65 echo The JRE_HOME environment variable is not defined correctly
66 echo This environment variable is needed to run this program
67 goto exit
68
69 :okJava
70 rem Don't override the endorsed dir if the user has set it previously
71 if not "%JAVA_ENDORSED_DIRS%" == "" goto gotEndorseddir
72 rem Set the default -Djava.endorsed.dirs argument
73 set "JAVA_ENDORSED_DIRS=%CATALINA_HOME%\endorsed"
74 :gotEndorseddir
75
76 rem Set standard command for invoking Java.
77 rem Note that NT requires a window name argument when using start.
78 rem Also note the quoting as JAVA_HOME may contain spaces.
79 set _RUNJAVA="%JRE_HOME%\bin\java"
80 set _RUNJDB="%JAVA_HOME%\bin\jdb"
81
82 goto end
83
84 :exit
85 exit /b 1
86
87 :end
88 exit /b 0
複製程式碼
三、總結
以上即 tomcat 的啟動指令碼中的總體流程,只是講了預設的指令碼執行方式,但在指令碼閱讀中可以看到能根據 catalina.bat 裡可以根據不同引數以不同方式執行 tomcat :
debug Start Catalina in a debugger
debug -security Debug Catalina with a security manager
jpda start Start Catalina under JPDA debugger
run Start Catalina in the current window
run -security Start in the current window with security manager
start Start Catalina in a separate window
start -security Start in a separate window with security manager
stop Stop Catalina
configtest Run a basic syntax check on server.xml
複製程式碼
只要能看懂基本 dos 命令,這幾個指令碼的閱讀其實很簡單,其他 bat 檔案可以大體瀏覽一下,會發現轉了半天,最終都會執行 catalina.bat 檔案,而 catalina.bat 檔案裡最終會執行 Bootstrap 檔案的 main 方法,不同的是呼叫 main 方法時會各自新增不同的入參而已。bat 檔案用於 windows 作業系統下啟動 tomcat,而 sh 檔案則用於 unix 環境下的啟動,原理是一致的。