Tomcat4.01全攻略

IBM developerWorks 中國網站 02-01-05 10:53 2118p 宗鋒

一：簡介 
    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中)

	###還需環境變量--add by haolq###
		CLASSPATH=C:\jdk1.3\lib\dt.jar;C:\jdk1.3\lib\tools.jar
		PATH=C:\jdk1.3\bin
	###

    (三)：運行 
    設置完畢后就可以運行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的，其提供了更友好的管理界面，部署應用程序也更簡單，功能也更強大。 

參考資料： 
tomcat文檔 
www.jguru.com的tomcat faq 
apache的文檔