內(nèi)容： 

一：簡(jiǎn)介 
二：安裝及配置 
三：應(yīng)用 
四：綜述 
參考資料 
關(guān)于作者 

   
宗 鋒 
西北大學(xué)計(jì)算機(jī)系碩士 
2001 年 12 月 

隨著java的流行，其在web上的應(yīng)用也越來(lái)越廣，tomcat作為一個(gè)開(kāi)源的servlet容器，應(yīng)用前景越來(lái)越廣，本文將向你講述tomcat的一些知識(shí)。 
一：簡(jiǎn)介 
tomcat是jakarta項(xiàng)目中的一個(gè)重要的子項(xiàng)目，其被JavaWorld雜志的編輯選為2001年度最具創(chuàng)新的java產(chǎn)品(Most Innovative Java Product)，同時(shí)它又是sun公司官方推薦的servlet和jsp容器(具體可以見(jiàn)http://java.sun.com/products/jsp/tomcat/)，因此其越來(lái)越多的受到軟件公司和開(kāi)發(fā)人員的喜愛(ài)。servlet和jsp的最新規(guī)范都可以在tomcat的新版本中得到實(shí)現(xiàn)。 

二：安裝及配置 
tomcat最新版本為4.0.1，這個(gè)版本用了一個(gè)新的servlet容器Catalina，完整的實(shí)現(xiàn)了servlet2.3和jsp1.2規(guī)范。注意安裝之前你的系統(tǒng)必須安裝了jdk1.2以上版本。 

(一)：安裝 
1：windows平臺(tái) 
從tomcat網(wǎng)站下載jakarta-tomcat-4.0.1.exe，按照一般的windows程序安裝步驟即可安裝好tomcat,安裝時(shí)它會(huì)自動(dòng)尋找你的jdk和jre的位置。 

2：linux平臺(tái) 
下載jakarta-tomcat-4.0.1.tar.gz，將其解壓到一個(gè)目錄。 

(二)：配置 
運(yùn)行tomcat需要設(shè)置JAVA_HOME變量 

set JAVA_HOME=c:/jdk (win98，在msdos方式下使用，或者放入autoexec.bat中) 
export JAVA_HOME=/usr/local/jdk (linux下使用，放到/etc/bashrc或者/etc/profile中) 

(三)：運(yùn)行 
設(shè)置完畢后就可以運(yùn)行tomcat服務(wù)器了，進(jìn)入tomcat的bin目錄，win98下用startup啟動(dòng)tomcat，linux下用startup.sh，相應(yīng)的關(guān)閉tomcat的命令為shutdown和shutdown.sh。 

啟動(dòng)后可以在瀏覽器中輸入http://localhost:8080/測(cè)試，由于tomcat本身具有web服務(wù)器的功能，因此我們不必安裝apache，當(dāng)然其也可以與apache集成到一起，下面會(huì)介紹。 

下面你可以測(cè)試其自帶的jsp和servlet示例。 

三：應(yīng)用 

(一):目錄結(jié)構(gòu) 
tomcat的目錄結(jié)構(gòu)如下： 

目錄名 簡(jiǎn)介 
bin 存放啟動(dòng)和關(guān)閉tomcat腳本 
conf 包含不同的配置文件,server.xml(Tomcat的主要配置文件)和web.xml 
work 存放jsp編譯后產(chǎn)生的class文件 
webapp 存放應(yīng)用程序示例，以后你要部署的應(yīng)用程序也要放到此目錄 
logs 存放日志文件 
lib/japser/common 這三個(gè)目錄主要存放tomcat所需的jar文件 

(二)：server.xml配置簡(jiǎn)介 
下面我們將講述這個(gè)文件中的基本配置信息，更具體的配置信息見(jiàn)tomcat的文檔 

元素名 屬性 解釋 
server port 指定一個(gè)端口，這個(gè)端口負(fù)責(zé)監(jiān)聽(tīng)關(guān)閉tomcat的請(qǐng)求 
shutdown 指定向端口發(fā)送的命令字符串 
service name 指定service的名字 
Connector 
(表示客戶端和service之間的連接) port 指定服務(wù)器端要?jiǎng)?chuàng)建的端口號(hào)，并在這個(gè)斷口監(jiān)聽(tīng)來(lái)自客戶端的請(qǐng)求 
minProcessors 服務(wù)器啟動(dòng)時(shí)創(chuàng)建的處理請(qǐng)求的線程數(shù) 
maxProcessors 最大可以創(chuàng)建的處理請(qǐng)求的線程數(shù) 
enableLookups 如果為true，則可以通過(guò)調(diào)用request.getRemoteHost()進(jìn)行DNS查詢來(lái)得到遠(yuǎn)程客戶端的實(shí)際主機(jī)名，若為false則不進(jìn)行DNS查詢，而是返回其ip地址 
redirectPort 指定服務(wù)器正在處理http請(qǐng)求時(shí)收到了一個(gè)SSL傳輸請(qǐng)求后重定向的端口號(hào) 
acceptCount 指定當(dāng)所有可以使用的處理請(qǐng)求的線程數(shù)都被使用時(shí)，可以放到處理隊(duì)列中的請(qǐng)求數(shù)，超過(guò)這個(gè)數(shù)的請(qǐng)求將不予處理 
connectionTimeout 指定超時(shí)的時(shí)間數(shù)(以毫秒為單位) 
Engine 
(表示指定service中的請(qǐng)求處理機(jī)，接收和處理來(lái)自Connector的請(qǐng)求) defaultHost 指定缺省的處理請(qǐng)求的主機(jī)名，它至少與其中的一個(gè)host元素的name屬性值是一樣的 
Context 
(表示一個(gè)web應(yīng)用程序，通常為WAR文件，關(guān)于WAR的具體信息見(jiàn)servlet規(guī)范) docBase 應(yīng)用程序的路徑或者是WAR文件存放的路徑 
path 表示此web應(yīng)用程序的url的前綴，這樣請(qǐng)求的url為http://localhost:8080/path/**** 
reloadable 這個(gè)屬性非常重要，如果為true，則tomcat會(huì)自動(dòng)檢測(cè)應(yīng)用程序的/WEB-INF/lib 和/WEB-INF/classes目錄的變化，自動(dòng)裝載新的應(yīng)用程序，我們可以在不重起tomcat的情況下改變應(yīng)用程序 
host 
(表示一個(gè)虛擬主機(jī)) 
name 指定主機(jī)名 
appBase 應(yīng)用程序基本目錄，即存放應(yīng)用程序的目錄 
unpackWARs 如果為true，則tomcat會(huì)自動(dòng)將WAR文件解壓，否則不解壓，直接從WAR文件中運(yùn)行應(yīng)用程序 
Logger 
(表示日志，調(diào)試和錯(cuò)誤信息) 
className 指定logger使用的類(lèi)名，此類(lèi)必須實(shí)現(xiàn)org.apache.catalina.Logger 接口 
prefix 指定log文件的前綴 
suffix 指定log文件的后綴 
timestamp 如果為true，則log文件名中要加入時(shí)間，如下例:localhost_log.2001-10-04.txt 
Realm 
(表示存放用戶名，密碼及role的數(shù)據(jù)庫(kù)) 
className 指定Realm使用的類(lèi)名，此類(lèi)必須實(shí)現(xiàn)org.apache.catalina.Realm接口 
Valve 
(功能與Logger差不多，其prefix和suffix屬性解釋和Logger 中的一樣) 
className 指定Valve使用的類(lèi)名，如用org.apache.catalina.valves.AccessLogValve類(lèi)可以記錄應(yīng)用程序的訪問(wèn)信息 

directory 指定log文件存放的位置 
pattern 有兩個(gè)值，common方式記錄遠(yuǎn)程主機(jī)名或ip地址，用戶名，日期，第一行請(qǐng)求的字符串，HTTP響應(yīng)代碼，發(fā)送的字節(jié)數(shù)。combined方式比common方式記錄的值更多 

注意：1：經(jīng)過(guò)我測(cè)試，我設(shè)置Context 的path="",reloadable=true，然后放一個(gè)WAR文件到webapps目錄，結(jié)果tomcat不能檢測(cè)出此文件(重起tomcat可以)，而把此文件解壓，則tomcat會(huì)自動(dòng)檢測(cè)出這個(gè)新的應(yīng)用程序。如果不能自動(dòng)檢測(cè)WAR文件，我們可以利用下面管理中講的方法來(lái)部署應(yīng)用程序。 

2：默認(rèn)的server.xml中，Realm元素只設(shè)置了一個(gè)className屬性，但此文件中也包含幾個(gè)通過(guò)JDBC連接到數(shù)據(jù)庫(kù)進(jìn)行驗(yàn)證的示例(被注釋掉了)，通過(guò)Realm元素我們可以實(shí)現(xiàn)容器安全管理(Container Managed Security)。 

3：還有一些元素我們沒(méi)有介紹，如Parameter，loader，你可以通過(guò)tomcat的文檔獲取這些元素的信息。 

(三)：管理 

1：配置 
在進(jìn)行具體的管理之前，我們先給tomcat添加一個(gè)用戶，使這個(gè)用戶有權(quán)限來(lái)進(jìn)行管理。 

打開(kāi)conf目錄下的tomcat-users.xml文件，在相應(yīng)的位置添加下面一行： 

<user name="zf" password="zf" roles="standard,manager"/> 

注意：這一行的最后部分一定是/>,tomcat的文檔掉了/符號(hào)，如果沒(méi)有/符號(hào)的話，tomcat重起時(shí)將無(wú)法訪問(wèn)應(yīng)用程序。通過(guò)logs/catalina.out文件你可以看到這個(gè)錯(cuò)誤的詳細(xì)信息。 

然后重起tomcat，在瀏覽器中輸入http://localhost:8080/manager/，會(huì)彈出對(duì)話框，輸入上面的用戶名和密碼即可。 

2：應(yīng)用程序列表 
在瀏覽器中輸入http://localhost:8080/manager/list，瀏覽器將會(huì)顯示如下的信息： 

OK - Listed applications for virtual host localhost 
/ex:running:1 
/examples:running:1 
/webdav:running:0 
/tomcat-docs:running:0 
/manager:running:0 
/:running:0 

面的信息分別為應(yīng)用程序的路徑，當(dāng)前狀態(tài)(running 或者stopped)，與這個(gè)程序相連的session數(shù)。 

3：重新裝載應(yīng)用程序 
在瀏覽器中輸入 http://localhost:8080/manager/reload?path=/examples，瀏覽器顯示如下： 

OK - Reloaded application at context path /examples 

表示example應(yīng)用程序裝載成功，如果我們將server.xml的Context元素的reloadable屬性設(shè)為true(見(jiàn)上面表格)，則沒(méi)必要利用這種方式重新裝載應(yīng)用程序，因?yàn)閠omcat會(huì)自動(dòng)裝載。 

4：顯示session信息 
在瀏覽器中輸入http://localhost:8080/manager/sessions?path=/examples，瀏覽器顯示如下： 

OK - Session information for application at context path /examples Default maximum session inactive interval 30 minutes 

5：?jiǎn)��?dòng)和關(guān)閉應(yīng)用程序 
在瀏覽器中輸入http://localhost:8080/manager/start?path=/examples和http://localhost:8080/manager/stop?path=/examples分別啟動(dòng)和關(guān)閉examples應(yīng)用程序。 

6：部署及撤銷(xiāo)部署 
WAR有兩種組織方式，一種是按一定的目錄結(jié)構(gòu)組織文件，一種是一個(gè)后綴為WAR的壓縮包，因此它的部署方式也有兩種： 
(1)：在瀏覽器中輸入：http://localhost:8080/manager/install?path=/examples&war=file:/c:\examples 
就會(huì)將按目錄結(jié)構(gòu)組織的WAR部署 

(2)：如果輸入:http://localhost:8080/manager/install?path=/examples&war=jar:file:/c:\examples.war!/ 
就會(huì)將按壓縮包組織的WAR部署，注意此url后半部分一定要有!/號(hào)。 

部署后就可以用 http://localhost:8080/examples訪問(wèn)了。 

在瀏覽器中輸入：http://localhost:8080/manager/remove?path=/examples 
就會(huì)撤銷(xiāo)剛才部署的應(yīng)用程序。 

(四)：與apache集成 
雖然tomcat也可以作web服務(wù)器,但其處理靜態(tài)html的速度比不上apache,且其作為web服務(wù)器的功能遠(yuǎn)不如apache,因此我們想把a(bǔ)pache和tomcat集成起來(lái)。 

我們以linux系統(tǒng)為例介紹. 

從apache網(wǎng)站下載apache1.3.22源代碼版本，然后使用如下命令配置安裝apache： 

mkdir /usr/local/apache 
tar zxvf apache.1.32.tar.gz 
cd apache.1.32 
./configure --prefix=/usr/local/apache --enable-module=so 
make 
make install 

注意configure命令指定目標(biāo)安裝目錄，并且加入DSO(Dynamic Shared Object)支持，注意一定不要忘了這一個(gè)選項(xiàng)。 

然后下載webapp模塊，將解壓后mod_webapp.so文件放入apache的libexec目錄，編輯apache的conf目錄下的httpd.conf，在這個(gè)文件的最后加入下面三行： 

LoadModule webapp_module libexec/mod_webapp.so 
WebAppConnection warpConnection warp localhost:8008 
WebAppDeploy examples warpConnection /examples/ 

第一行是加入webapp模塊，如果編譯apache時(shí)不增加DSO支持，則無(wú)法使用LoadModule指令，第二行指定tomcat與apache的連接，第三行指定部署那個(gè)應(yīng)用，這兩個(gè)指令使用格式如下： 

WebAppConnection [connection name] [provider] [host:port] 
WebAppDeploy [application name] [connection name] [url path] 

其中connection name指定連接名，provider只能是warp，port端口與你的tomcat的配置文件server.xml最后幾行指定的要保持一致。文件如下： 

<Service name="Tomcat-Apache"> 
<Connector className="org.apache.catalina.connector.warp.WarpConnector" 
port="8008" minProcessors="5" maxProcessors="75" 
enableLookups="true" 
acceptCount="10" debug="0"/> 
****** 
</Service> 

application name與你在tomcat中部署的應(yīng)用名一致，url path指定訪問(wèn)這個(gè)應(yīng)用的url。例如上面的例子可以通過(guò)http://localhost/examples/來(lái)訪問(wèn)tomcat中的examples應(yīng)用。 

(五)：中文問(wèn)題 
一般jsp的亂碼問(wèn)題可以通過(guò)在jsp中加入<%@ page contentType="text/html;charset=GB2312" %>來(lái)解決，至于servlet的亂碼在可以使用servlet2.3中提供的HttpServeletRequest.setCharacterEncoding函數(shù)。更詳細(xì)的中文問(wèn)題請(qǐng)見(jiàn)JSP/Servlet 中的漢字編碼問(wèn)題。 

四：綜述 
tomcat作為一個(gè)servlet(jsp也被編譯為servlet執(zhí)行)容器，其應(yīng)用前景是非常好的，如果與jboss結(jié)合起來(lái)，則可以實(shí)現(xiàn)sun的j2ee規(guī)范(用jboss作ejb服務(wù)器)。jboss的官方網(wǎng)站也提供集成了tomcat3.2*的jboss以供下載。另外一個(gè)開(kāi)源的應(yīng)用服務(wù)器(enhydra) 也是基于tomcat的，其提供了更友好的管理界面，部署應(yīng)用程序也更簡(jiǎn)單，功能也更強(qiáng)大。