宗 鋒
西北大學計算機系碩士
2001 年 12 月

隨著java的流行，其在web上的應用也越來越廣，tomcat作為一個開源的servlet容器，應用前景越來越廣，本文將向你講述tomcat的一些知識。

一：簡單介紹
tomcat是jakarta項目中的一個重要的子項目，其被JavaWorld雜志的編輯選為2001年度最具創新的java產品(Most Innovative Java Product)，同一時候它又是sun公司官方推薦的servlet和jsp容器(詳細能夠見http://java.sun.com/products/jsp/tomcat/)，因此其越來越多的受到軟件公司和開發者的喜愛。servlet和jsp的最新規范都能夠在tomcat的新版本號中得到實現。

二：安裝及配置
tomcat最新版本號為4.0.1，這個版本號用了一個新的servlet容器Catalina，完整的實現了servlet2.3和jsp1.2規范。注意安裝之前你的系統必須安裝了jdk1.2以上版本號。

(一)：安裝
1：windows平臺
從tomcat站點下載 jakarta-tomcat-4.0.1.exe ，依照一般的windows程序安裝步驟就可以安裝好tomcat,安裝時它會自己主動尋找你的jdk和jre的位置。

2：linux平臺
下載 jakarta-tomcat-4.0.1.tar.gz ，將其解壓到一個文件夾。

(二)：配置
執行tomcat須要設置JAVA_HOME變量

                              
                                set JAVA_HOME=c:/jdk (win98，在msdos方式下使用，或者放入autoexec.bat中)

export JAVA_HOME=/usr/local/jdk (linux下使用，放到/etc/bashrc或者/etc/profile中)


                              
                            

(三)：執行
設置完成后就能夠執行tomcatserver了，進入tomcat的bin文件夾，win98下用startup啟動tomcat，linux下用startup.sh，對應的關閉tomcat的命令為shutdown和shutdown.sh。

啟動后能夠在瀏覽器中輸入http://localhost:8080/測試，因為tomcat本身具有webserver的功能，因此我們不必安裝apache，當然其也能夠與apache集成到一起，以下會介紹。

以下你能夠測試其自帶的jsp和servlet演示樣例。

三：應用

(一):文件夾結構
tomcat的文件夾結構例如以下：

(二)：server.xml配置簡單介紹
以下我們將講述這個文件里的基本配置信息，更詳細的配置信息見tomcat的文檔

注意：1：經過我測試，我設置Context 的path="",reloadable=true，然后放一個WAR文件到webapps文件夾，結果tomcat不能檢測出此文件(重起tomcat能夠)，而把此文件解壓，則tomcat會自己主動檢測出這個新的應用程序。假設不能自己主動檢測WAR文件，我們能夠利用以下管理中講的方法來部署應用程序。

2：默認的server.xml中，Realm元素僅僅設置了一個className屬性，但此文件里也包括幾個通過JDBC連接到數據庫進行驗證的演示樣例(被凝視掉了)，通過Realm元素我們能夠實現容器安全管理(Container Managed Security)。

3：另一些元素我們沒有介紹，如Parameter，loader，你能夠通過tomcat的文檔獲取這些元素的信息。

(三)：管理

1：配置
在進行詳細的管理之前，我們先給tomcat加入一個用戶，使這個用戶有權限來進行管理。

打開conf文件夾下的tomcat-users.xml文件，在對應的位置加入以下一行：

注意：這一行的最后部分一定是/>,tomcat的文檔掉了/符號，假設沒有/符號的話，tomcat重起時將無法訪問應用程序。通過logs/catalina.out文件你能夠看到這個錯誤的具體信息。

然后重起tomcat，在瀏覽器中輸入http://localhost:8080/manager/，會彈出對話框，輸入上面的username和password就可以。

2：應用程序列表
在瀏覽器中輸入http://localhost:8080/manager/list，瀏覽器將會顯演示樣例如以下的信息：

                              
                                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
                              
                            

面的信息分別為應用程序的路徑，當前狀態(running 或者stopped)，與這個程序相連的session數。

3：又一次裝載應用程序
在瀏覽器中輸入 http://localhost:8080/manager/reload?path=/examples，瀏覽器顯演示樣例如以下：

                              
                                OK - Reloaded application at context path /examples  


                              
                            

表示example應用程序裝載成功，假設我們將server.xml的Context元素的reloadable屬性設為true(見上面表格)，則不是必需利用這樣的方式又一次裝載應用程序，由于tomcat會自己主動裝載。

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：啟動和關閉應用程序
在瀏覽器中輸入http://localhost:8080/manager/start?path=/examples和http://localhost:8080/manager/stop?path=/examples分別啟動和關閉examples應用程序。

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

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

部署后就能夠用 http://localhost:8080/examples訪問了。

在瀏覽器中輸入： http://localhost:8080/manager/remove?path=/examples
就會撤銷剛才部署的應用程序。

(四)：與apache集成
盡管tomcat也能夠作webserver,但其處理靜態html的速度比不上apache,且其作為webserver的功能遠不如apache,因此我們想把apache和tomcat集成起來。

我們以linux系統為例介紹.

從apache站點下載 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命令指定目標安裝文件夾，而且增加DSO(Dynamic Shared Object)支持，注意一定不要忘了這一個選項。

然后下載 webapp模塊 ，將解壓后mod_webapp.so文件放入apache的libexec文件夾，編輯apache的conf文件夾下的httpd.conf，在這個文件的最后增加以下三行：

                              
                                LoadModule webapp_module libexec/mod_webapp.so

WebAppConnection warpConnection warp localhost:8008

WebAppDeploy examples warpConnection /examples/ 


                              
                            

第一行是添加webapp模塊，假設編譯apache時不添加DSO支持，則無法使用LoadModule指令，第二行指定tomcat與apache的連接，第三行指定部署那個應用，這兩個指令使用格式例如以下：

                              
                                WebAppConnection [connection name] [provider] [host:port]

WebAppDeploy [application name] [connection name] [url path]  


                              
                            

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

                              
                                
                                  
                                   ****** 
                 
                                
                              
                            

application name與你在tomcat中部署的應用名一致，url path指定訪問這個應用的url。比如上面的樣例能夠通過http://localhost/examples/來訪問tomcat中的examples應用。

(五)：中文問題
一般jsp的亂碼問題能夠通過在jsp中增加<%@ page contentType="text/html;charset=GB2312" %>來解決，至于servlet的亂碼在能夠使用servlet2.3中提供的HttpServeletRequest.setCharacterEncoding函數。更具體的中文問題請見 JSP/Servlet 中的漢字編碼問題 。

四：綜述
tomcat作為一個servlet(jsp也被編譯為servlet運行)容器，其應用前景是很好的，假設與 jboss 結合起來，則能夠實現sun的j2ee規范(用jboss作ejbserver)。jboss的官方站點也提供集成了tomcat3.2*的jboss以供下載。另外一個開源的應用server( enhydra ) 也是基于tomcat的，其提供了更友好的管理界面，部署應用程序也更簡單，功能也更強大。

參考資料：

• tomcat文檔
• www.jguru.com的tomcat faq
• apache的文檔