Tomcat 全攻略

Tomcat 全攻略 收藏

宗 鋒, 西北大學計算機系碩士

簡介： 隨着 java 的流行，其在 web 上的應用也越來越廣，tomcat 作爲一個開源的 servlet 容器，應用前景越來越廣，本文將向你講述 tomcat 的一些知識。
轉載自：http://www.ibm.com/developerworks/cn/java/l-tomcat/index.html#1
簡介
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 中 )

( 三 )：運行
設置完畢後就可以運行 tomcat 服務器了，進入 tomcat 的 bin 目錄，win98 下用 startup 啓動 tomcat，linux 下用 startup.sh，相應的關閉 tomcat 的命令爲 shutdown 和 shutdown.sh。
啓動後可以在瀏覽器中輸入 http://localhost:8080/ 測試，由於 tomcat 本身具有 web 服務器的功能，因此我們不必安裝 apache，當然其也可以與 apache 集成到一起，下面會介紹。
下面你可以測試其自帶的 jsp 和 servlet 示例。
回頁首

應用
( 一 ): 目錄結構
tomcat 的目錄結構如下：
目錄名 簡介
bin 存放啓動和關閉 tomcat 腳本
conf 包含不同的配置文件 ,server.xml(Tomcat 的主要配置文件 ) 和 web.xml
work 存放 jsp 編譯後產生的 class 文件
webapp 存放應用程序示例，以後你要部署的應用程序也要放到此目錄
logs 存放日誌文件
lib/japser/common 這三個目錄主要存放 tomcat 所需的 jar 文件
( 二 )：server.xml 配置簡介
下面我們將講述這個文件中的基本配置信息，更具體的配置信息見 tomcat 的文檔
元素名 屬性 解釋
server port 指定一個端口，這個端口負責監聽關閉 tomcat 的請求
shutdown 指定向端口發送的命令字符串
service name 指定 service 的名字
Connector ( 表示客戶端和 service 之間的連接 ) port 指定服務器端要創建的端口號，並在這個斷口監聽來自客戶端的請求
minProcessors 服務器啓動時創建的處理請求的線程數
maxProcessors 最大可以創建的處理請求的線程數
enableLookups 如果爲 true，則可以通過調用 request.getRemoteHost() 進行 DNS 查詢來得到遠程客戶端的實際主機名，若爲 false 則不進行 DNS 查詢，而是返回其 ip 地址
redirectPort 指定服務器正在處理 http 請求時收到了一個 SSL 傳輸請求後重定向的端口號
acceptCount 指定當所有可以使用的處理請求的線程數都被使用時，可以放到處理隊列中的請求數，超過這個數的請求將不予處理
connectionTimeout 指定超時的時間數 ( 以毫秒爲單位 )
Engine ( 表示指定 service 中的請求處理機，接收和處理來自 Connector 的請求 ) defaultHost 指定缺省的處理請求的主機名，它至少與其中的一個 host 元素的 name 屬性值是一樣的
Context ( 表示一個 web 應用程序，通常爲 WAR 文件，關於 WAR 的具體信息見 servlet 規範 ) docBase 應用程序的路徑或者是 WAR 文件存放的路徑
path 表示此 web 應用程序的 url 的前綴，這樣請求的 url 爲 http://localhost:8080/path/****
reloadable 這個屬性非常重要，如果爲 true，則 tomcat 會自動檢測應用程序的 /WEB-INF/lib 和 /WEB-INF/classes 目錄的變化，自動裝載新的應用程序，我們可以在不重起 tomcat 的情況下改變應用程序
host ( 表示一個虛擬主機 ) name 指定主機名
appBase 應用程序基本目錄，即存放應用程序的目錄
unpackWARs 如果爲 true，則 tomcat 會自動將 WAR 文件解壓，否則不解壓，直接從 WAR 文件中運行應用程序
Logger ( 表示日誌，調試和錯誤信息 ) className 指定 logger 使用的類名，此類必須實現 org.apache.catalina.Logger 接口
prefix 指定 log 文件的前綴
suffix 指定 log 文件的後綴
timestamp 如果爲 true，則 log 文件名中要加入時間，如下例 :localhost_log.2001-10-04.txt
Realm ( 表示存放用戶名，密碼及 role 的數據庫 ) className 指定 Realm 使用的類名，此類必須實現 org.apache.catalina.Realm 接口
Valve ( 功能與 Logger 差不多，其 prefix 和 suffix 屬性解釋和 Logger 中的一樣 ) className 指定 Valve 使用的類名，如用 org.apache.catalina.valves.AccessLogValve 類可以記錄應用程序的訪問信息
directory 指定 log 文件存放的位置
pattern 有兩個值，common 方式記錄遠程主機名或 ip 地址，用戶名，日期，第一行請求的字符串，HTTP 響應代碼，發送的字節數。combined 方式比 common 方式記錄的值更多
注意：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 文件，在相應的位置添加下面一行：
<user name="zf" password="zf" roles="standard,manager"/>

注意：這一行的最後部分一定是 />,tomcat 的文檔掉了 / 符號，如果沒有 / 符號的話，tomcat 重起時將無法訪問應用程序。通過 logs/catalina.out 文件你可以看到這個錯誤的詳細信息。
然後重起 tomcat，在瀏覽器中輸入 http://localhost:8080/manager/，會彈出對話框，輸入上面的用戶名和密碼即可。
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 也可以作 web 服務器 , 但其處理靜態 html 的速度比不上 apache, 且其作爲 web 服務器的功能遠不如 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 最後幾行指定的要保持一致。文件如下：
<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 中部署的應用名一致，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 作 ejb 服務器 )。jboss 的官方網站也提供集成了 tomcat3.2* 的 jboss 以供下載。另外一個開源的應用服務器 ( enhydra) 也是基於 tomcat 的，其提供了更友好的管理界面，部署應用程序也更簡單，功能也更強大。