Tomcat配置(二)：tomcat配置文件server.xml詳解和部署簡介

来源:https://www.cnblogs.com/f-ck-need-u/archive/2017/12/26/8120008.html
-Advertisement-
Play Games

本文目錄：1. 入門示例：虛擬主機提供web服務2. tomcat體繫結構基本說明3. tomcat的appBase和docBase詳細說明4. webapp體繫結構5. tomcat進階：tomcat配置文件server.xml詳解　5.1 頂級元素server　5.2 頂級元素service　5 ...


本文目錄：
1. 入門示例：虛擬主機提供web服務
2. tomcat體繫結構基本說明
3. tomcat的appBase和docBase詳細說明
4. webapp體繫結構
5. tomcat進階：tomcat配置文件server.xml詳解
　5.1 頂級元素server
　5.2 頂級元素service
　5.3 執行器executor
　5.4 連接器connector
　5.5 容器類engine
　5.6 容器類host
　5.7 容器類context
　5.8 被嵌套類realm
　5.9 被嵌套類valve

1. 入門示例：虛擬主機提供web服務

該示例通過設置虛擬主機來提供web服務，因為是入門示例，所以設置極其簡單，只需修改$CATALINA_HOME/conf/server.xml文件為如下內容即可。其中大部分都採用了預設設置，只是在engine容器中添加了兩個Host容器。

<?xml version="1.0" encoding="UTF-8"?>
<Server port="8005" shutdown="SHUTDOWN">
  <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

  <GlobalNamingResources>
    <Resource name="UserDatabase" auth="Container"
              type="org.apache.catalina.UserDatabase"
              description="User database that can be updated and saved"
              factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
              pathname="conf/tomcat-users.xml" />
  </GlobalNamingResources>
  <Service name="Catalina">
    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" enableLookups="false" />
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
   <Engine name="Catalina" defaultHost="localhost">
     <Realm className="org.apache.catalina.realm.LockOutRealm">
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
               resourceName="UserDatabase" />
      </Realm>

<!--  從此處開始添加以下兩個Host容器作為虛擬主機 -->
      <Host name="www.longshuai.com"  appBase="/www/longshuai"
            unpackWARs="true" autoDeploy="true">
          <Context path="" docBase="/www/longshuai" reloadable="true" />
          <Context path="/xuexi" docBase="xuexi" reloadable="true" />
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="longshuai_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
      </Host>
      <Host name="www.xiaofang.com"  appBase="/www/xiaofang"
            unpackWARs="true" autoDeploy="true">
          <Context path="" docBase="/www/xiaofang" reloadable="true" />
          <Context path="/xuexi" docBase="xuexi" reloadable="true" />
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="xiaofang_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
      </Host>
      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />
      </Host>
    </Engine>
  </Service>
</Server>

除了engine中定義的預設localhost虛擬主機，另外佈置了兩個虛擬主機www.longshuai.com和www.xiaofang.com，它們的程式目錄分別為/www/longshuai和/www/xiaofang，所以需要提前建立好這兩個目錄。另外，在context中定義了docBase，對於uri路徑/xuexi，它的文件系統路徑為/www/{longshuai,xiaofang}/xuexi目錄，所以也要在上面兩個程式根目錄中定義好xuexi目錄。除此之外，還分別為這3個虛擬主機定義了日誌，它們的路徑為相對路徑logs，相對於$CATALINA_HOME。

再提供appBase目錄和docBase目錄。

mkdir -p /www/{longshuai,xiaofang}/xuexi

再提供測試用的index.jsp文件。內容大致如下，分別複製到/www/{longshuai,xiaofang}/和/www/{longshuai,xiaofang}/xuexi/下，並將out.println的輸出內容分別稍作修改，使能夠區分讀取的是哪個index.jsp。

<%@ page language="java" %>
<%@ page import="java.util.*" %>
<html>
  <body>
    <% out.println("hello world from longshuai Root"); %>
  </body>
</html>

最後重啟catalina。

catalina.sh stop
catalina.sh start

再測試主機上添加www.{longshuai,xiaofang}.com的host記錄。例如在windows上，在C:\Windows\System32\drivers\etc\hosts中添加如下記錄：

192.168.100.22 www.longshuai.com www.xiaofang.com

在瀏覽器中進行測試，結果如下：

2. tomcat體繫結構基本說明

如下圖：

tomcat高度模塊化，各個模塊之間有嵌套的父子關係。如果使用配置文件來描述，可以大致簡化為如下：

<server>
    <service>
        <connector PORT />
        <engine>
            <host name=www.a.com appBase=/www/a >
                <context path="" docBase=/www/a />
                <context path="/xuexi" docBase=/www/a/xuexi />
            </host>

            <host>
                <context />
            </host>
        </engine>
    </service>
</server>

其中： server組件是工作在後臺管理tomcat實例的組件，可以監聽一個埠，從此埠上可以遠程向該實例發送shutdown關閉命令。
service組件是一個邏輯組件，綁定connector和containor，有了service表示可以向外提供服務，就像是一般的daemon類服務的service。
connector組件是服務監聽組件，用於監聽外界請求並建立TCP連接，然後將連接交給containor，之後可以從此連接傳輸數據，例如接收http請求，發送http響應等。
containor是容器，在配置文件中沒有體現出來，它包含4個容器類組件：engine容器、host容器、context容器和wrapper容器。
engine容器用於從connector組件處接收已建立的TCP連接，還用於接收客戶端發送的http請求並分析請求，然後按照分析的結果將相關參數傳遞給匹配出的虛擬主機。engine還用於指定預設的虛擬主機。
host容器定義虛擬主機，由於tomcat主要是作為servlet容器的，所以為每個web應用程式指定了它們的根目錄appBase。
context容器對應servlet容器的處理過程。還可以指定相關的wrapper容器類，當然一般都採用預設的標準wrapper類。

最後當請求處理完畢後，context將響應數據返回給host，再返回給engine，再返回給connector，最後返回給客戶端。

撇開tomcat作為servlet容器的行為。它和apache、nginx的功能大致都能對應上。例如以nginx為例，以下是nginx提供web服務時的配置結構：

server {
    listen PORT;
    server_name www.a.com;   # 對應於<host name=www.a.com>
    location / {             # 對應於context path=""
            root   html;     # 對應於docBase
        }
    location /xuexi {        # 對應於context path="/xuexi"
            root   html/xuexi;
        }
}

connetcor組件類似於nginx的listen指令。host容器類似於nginx的server指令，host容器中的name屬性相當於nginx的server_name指令。engine組件則沒有對應配置項，不過在nginx同樣有engine的功能，例如預設的虛擬主機，分析URL來判斷請求交給哪個虛擬主機處理等。context容器相當於location指令，context容器的path屬性相當於location的uri匹配路徑，docBase相當於location的中的root指令，即DocumentRoot。

tomcat作為簡單的web服務程式大致如此，但它的核心畢竟是處理servlet和jsp，它必須得管理好每個webapp。因此，對於tomcat來說，必須要掌握部署webapp的方式。在tomcat上部署webapp時，必須要理解context的概念。對於tomcat而言，每個context都應該算是一個webapp，其路徑由docBase決定，該目錄存放的是歸檔的war文件或未歸檔的webapp相關文件，而host容器中的appBase則是虛擬主機整理webapp的地方，一個appBase下可以有多個webapp，即多個context。

3. tomcat的appBase和docBase詳細說明

這兩貨雖然意義很明確，但"潛規則"很嚴重。以下麵的配置為例。

<host name=www.a.com appBase=/www/a >
    <context path="" docBase=/www/a />
    <context path="/xuexi" docBase=/www/a/xuexi />
</host>

appBase是虛擬主機存放webapp的目錄，它可以是相對路徑，也可以是絕對路徑。如果是相對路徑，則相對於$CATALINA_HOME，嚴格並準確地說是$CATALINA_BASE。

path是URI的匹配路徑，相當於nginx的location後的路徑。tomcat要求每個虛擬主機必須配置一個空字元串的path，該條context作為URI無法被明確匹配時的預設context，它相當於nginx中location / {}的作用。

docBase則是每個webapp的存放目錄(或者是已歸檔的war文件)，它可以是相對路徑，也可以是絕對路徑，提供相對路徑時它相對於appBase。該目錄一般在appBase的目錄下，但並不規定一定要放在appBase下。對於web服務來說，它相當於nginx的root指令，但對於webapp來說，一個context就相當於一個webapp，而docBase正是webapp的路徑。

"潛規則"在於預設的context如何提供。有以下幾種情況：

  1. 明確定義了<context path="" docBase=webappPATH>，此時預設context的處理路徑為webappPATH。
  2. 明確定義了<context path="">，但卻沒給定docBase屬性，此時該預設context處理路徑為appBase/ROOT目錄，註意ROOT為大寫。
  3. 完全沒有定義path=""的context時，即host容器中沒有明確的path=""，此時將隱式定義一個預設context，處理路徑為appBase/ROOT目錄。
  4. 定義了path但沒有定義docBase屬性時，docBase將根據path推斷出它的路徑。推斷的規則如下：(註：此時推斷的不是預設context，而是對應context的docbase)
context path    context name    推斷出的docBase路徑
--------------------------------------------------
/foo            /foo            foo    
/foo/bar        /foo/bar        foo/bar
Empty String    Empty String    ROOT

顯然，沒有給定path=""或缺少docbase時，都以ROOT作為目錄。以下是幾個定義示例：

# 虛擬主機中沒有定義任何context，將以appBase下的ROOT作為預設處理路徑
<Host appBase="webapps">
</Host>

# 沒有定義path=""的context，但定義了path非空的context，也將以ROOT作為預設處理路徑
# 如果下麵的Context容器中省略docBase屬性，則推斷出該context的docBase路徑為appBase/xuexi
<Host appBase="webapps">
    <Context path="/xuexi" docBase="webappPATH" />
</Host>

# 某個context定義了path=""，該context將作為預設context
# 但該預設context如果沒有定義docBase，將推斷出其docBase路徑為appBase/ROOT
<Host appBase="webapps">
    <Context path="" docBase="webappPATH" />
</Host>

# 某個context定義了path=""，該context將作為預設context
# 下麵的預設context明確定義了docBase
<Host appBase="webapps">
    <Context path="" docBase="webappPATH" />
</Host>

4. webapp體繫結構

webapp有特定的組織格式，是一種層次型目錄結構，通常包含了servlet代碼文件、jsp頁面文件、類文件、部署描述符文件等等。

這些文件可能是以目錄的形式存放，也可能會打包成各種歸檔格式的文件，如jar、war等。但jsp有規定，在web應用程式的根目錄下，一般要有下麵幾個目錄：

  • /WEB-INF：此webapp的私有資源目錄，從瀏覽器上是無法訪問此目錄資源的，通常web.xml和context.xml均放置於此目錄
  • /WEB-INF/classes：此webapp自有的類
  • /WEB-INF/lib：此webapp自有能夠打包為jar格式的類
  • /META-INF：並非標準的webapp目錄，有的應用程式才有。當該應用程式想獨立定義自己的context.xml時可放入此目錄，也是私有目錄。

每個webapp要想被tomcat載入，一種方法是程式目錄放在$catalina.home/webapps下，另一種方式是配置該webapp相關的context配置，使tomcat能找到此webapp。之所以可以直接放在$catalina.home/webapps下，是因為預設的localhost虛擬主機的appBase="webapps"，該目錄下的所有內容它都可以自動查找，不過要註意，此時要想訪問此webapp只能通過虛擬主機是localhost。

簡單部署示例：

(1)對於war類歸檔程式：將歸檔文件複製到$CATALINA_BASE/webapps/目錄中，並重啟tomcat即可，tomcat會自動展開war歸檔。例如官方提供了一個sample.war作為tomcat學習初級示例( https://tomcat.apache.org/tomcat-8.5-doc/appdev/sample/sample.war )，下載後只需將其放入webapps下即可。

(2)在程式的開發過程中，很多時候是未歸檔程式，這時可以手動創建目錄來實現部署。需要創建的目錄有webapps/yourapp，此目錄下還要創建WEB-INF目錄，在WEB-INF目錄中還要創建classes和lib目錄。然後將jsp文件放在對應目錄下即可，如寫一個測試的index.jsp放在yourapp目錄下。

5. tomcat配置文件server.xml詳解

tomcat配置文件中配置的是各個組件的屬性，全局配置文件為$CATALINA_HOME/conf/server.xml，主要的組件有以下幾項：Server,Service,Connector,Engine,Host,Alias,Context,Valve等。配置完配置文件後需要重啟tomcat，但在啟動後一定要檢查tomcat是否啟動成功，因為即使出錯，很多時候它都不會報錯，可從監聽埠判斷。

配置方法見官方手冊，在頁面的左邊有各個組件的鏈接。

tomcat的配置文件都是xml文件，以下是xml文件的常見規則：

  1. 文件第一行設置xml標識，表示該文件是xml格式的文件。例如<?xml version="1.0" encoding="UTF-8"?>。
  2. xml文件的註釋方法為<!-- XXX -->，這可以是單行註釋，也可以多行註釋，只要前後註釋符號能對應上，中間的內容都是註釋。
  3. 定義屬性時有兩種方式：單行定義和多行定義。例如：
<!-- 單行定義的方式 -->
<NAME key=value />

<!-- 多行定義的方式 -->
<NAME key=value>
</NAME>

下麵個組件的配置中有些地方使用了相對於$CATALINA_BASE的相對路徑，它和$CATALINA_HOME小有區別。如果只有一個tomcat實例，則它們是等價的，都是tomcat的安裝路徑。如果有多個tomcat實例，則$CATALINA_HOME表示的是安裝路徑，而$CATALINA_BASE表示的是各實例所在根目錄。關於tomcat多實例，見running.txt中對應的說明。

5.1 頂級元素server

server組件定義的是一個tomcat實例。預設定義如下：

<Server port="8005" shutdown="SHUTDOWN">
</Server>

它預設監聽在8005埠以接收shutdown命令。要啟用多個tomcat實例，將它們監聽在不同的埠即可。這個埠的定義為管理員提供一個關閉實例的便捷途徑，可以直接telnet至此埠使用SHUTDOWN命令關閉此實例。不過基於安全形度的考慮，通常不允許遠程進行。

Server的相關屬性：

  • className：用於實現此組件的java類的名稱，這個類必須實現介面org.apache.catalina.Server。不給定該屬性時將採用預設的標準類org.apache.catalina.core.StandardServer；
  • address：監聽埠綁定的地址。如不指定，則預設為Localhost，即只能在localhost上發送SHUTDOWN命令；
  • port：接收shutdown指令的埠，預設僅允許通過本機訪問，預設為8005；
  • shutdown：通過TCP/IP連接發往此Server用於實現關閉tomcat實例的命令字元串。

在server組件中可嵌套一個或多個service組件。

5.2 頂級元素service

定義了service就能提供服務了。service組件中封裝connector和containor，它同時也表示將此service中的connector和containor綁定起來，即由它們組成一個service向外提供服務。預設定義如下：

<Service name="Catalina">
</Service>

Service相關的屬性：

  • className：用於實現service的類名，這個類必須實現org.apache.catalina.Service介面。不給定該屬性時將採用預設的標準類org.apache.catalina.core.StandardService。
  • name：此service的顯示名稱，該名稱主要用於在日誌中進行標識service。一般來說無關緊要，預設為Catalina。

5.3 執行器executor

執行器定義tomcat各組件之間共用的線程池。在以前，每個connector都會獨自創建自己的線程池，但現在，可以定義一個線程池，各組件都可以共用該線程池，不過主要是為各connector之間提供共用。註意，executor創建的是共用線程池，如果某個connector不引用executor創建的線程池，那麼該connector仍會根據自己指定的屬性創建它們自己的線程池。

連接器必須要實現org.apache.catalina.Executor介面。它是一個嵌套在service組件中的元素，為了挑選所使用的connector，該元素還必須定義在connector元素之前。

預設的定義如下：

<Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
    maxThreads="150" minSpareThreads="4"/>

其中該組件的屬性有：

  • className：用於實現此組件的java類的名稱，這個類必須實現介面org.apache.catalina.Executor。不給定該屬性時將採用預設的標準類org.apache.catalina.core.StandardThreadExecutor；
  • name：該線程池的名稱，其他組件需要使用該名稱引用該線程池。

標準類的屬性包括：

  • threadPriority：線程優先順序，預設值為5。
  • daemon：線程是否以daemon的方式運行，預設值為true。
  • namePrefix：執行器創建每個線程時的名稱首碼，最終線程的名稱為:namePrefix+threadNumber。
  • maxThreads：線程池激活的最大線程數量。預設值為200。
  • minSpareThreads：線程池中最少空閑的線程數量。預設值為25。
  • maxIdleTime：在空閑線程關閉前的毫秒數。除非激活的線程數量小於或等於minSpareThreads的值，否則會有空閑線程的出現。預設值為60000，即空閑線程需要保留1分鐘的空閑時間才被殺掉。
  • maxQueueSize：可執行任務的最大隊列數，達到隊列上限時的連接請求將被拒絕。
  • prestartminSpareThreads：在啟動executor時是否立即創建minSpareThreads個線程數，預設為false，即在需要時才創建線程。

例如在connector中指定所使用的線程池，方式如下：

<Connector executor="tomcatThreadPool"
           port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

5.4 連接器connector

連接器用於接收客戶端發送的請求並返迴響應給客戶端。一個service中可以有多個connector。有多種connector，常見的為http/1.1,http/2和ajp(apache jserv protocol)。在tomcat中，ajp連接協議類型專用於tomcat前端是apache反向代理的情況下。

因此tomcat可以扮演兩種角色：

  1. Tomcat僅作為應用程式伺服器：請求來自於前端的web伺服器，這可能是Apache, IIS, Nginx等；
  2. Tomcat既作為web伺服器，也作為應用程式伺服器：請求來自於瀏覽器。

Tomcat應該考慮工作情形併為相應情形下的請求分別定義好需要的連接器才能正確接收來自於客戶端的請求。

此處暫先介紹HTTP/1.1連接器的屬性設置。ajp後文再做介紹。

HTTP連接器表示支持HTTP/1.1協議的組件。設置了該連接器就表示catalina啟用它的獨立web服務功能，當然，肯定也提供它必須的servlets和jsp執行功能。在一個service中可以配置一個或多個連接器，每個連接器都可以將請求轉發給它們相關聯的engine以處理請求、創建響應。

每個流入的請求都需要一個獨立的線程來接收。當併發請求數量超出maxThreads指定的值時，多出的請求將被堆疊在套接字中，直到超出acceptCount指定的值。超出accpetCount的請求將以"connection refused"錯誤進行拒絕。

預設的定義如下：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

HTTP連接器的屬性實在太多，詳細配置方法見官方手冊。通常定義HTTP連接器時必須定義的屬性只有"port"。

  • address：指定連接器監聽的地址，預設為所有地址，即0.0.0.0。
  • maxThreads：支持的最大併發連接數，預設為200；如果引用了executor創建的共用線程池，則該屬性被忽略。
  • acceptCount：設置等待隊列的最大長度；通常在tomcat所有處理線程均處於繁忙狀態時，新發來的請求將被放置於等待隊列中；
  • maxConnections：允許建立的最大連接數。acceptCount和maxThreads是接受連接的最大線程數。存在一種情況，maxConnections小於acceptCount時，超出maxConnections的連接請求將被接收，但不會與之建立連接。
  • port：監聽的埠，預設為0，此時表示隨機選一個埠，通常都應該顯式指定監聽埠。
  • protocol：連接器使用的協議，用於處理對應的請求。預設為HTTP/1.1，此時它會自動在基於Java NIO或APR/native連接器之間進行切換。定義AJP協議時通常為AJP/1.3。
  • redirectPort：如果某連接器支持的協議是HTTP，當接收客戶端發來的HTTPS請求時，則轉發至此屬性定義的埠。
  • connectionTimeout：等待客戶端發送請求的超時時間，單位為毫秒，預設為60000，即1分鐘；註意，這時候連接已經建立。
  • keepAliveTimeout：長連接狀態的超時時間。超出該值時，長連接將關閉。
  • enableLookups：是否通過request.getRemoteHost()進行DNS查詢以獲取客戶端的主機名；預設為true，應設置為false防止反解客戶端主機；
  • compression：是否壓縮數據。預設為off。設置為on時表示只壓縮text文本，設置為force時表示壓縮所有內容。應該在壓縮和sendfile之間做個權衡。
  • useSendfile：該屬性為NIO的屬性，表示是否啟用sendfile的功能。預設為true，啟用該屬性將會禁止compression屬性。

當協議指定為HTTP/1.1時，預設會自動在NIO/APR協議處理方式上進行按需切換。如要顯式指定協議，方式如下：

<connector port="8080" protocol="HTTP/1.1">
<connector port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol">
<connector port="8080" protocol="org.apache.coyote.http11.Http11Nio2Protocol">
<connector port="8080" protocol="org.apache.coyote.http11.Http11AprProtocol">

其中NIO是C/C++的非阻塞IO復用模型在JAVA中的IO實現，NIO2即AIO是非同步NIO，即非同步非阻塞IO：
NioProtocol ：non blocking Java NIO connector
Nio2Protocol：non blocking Java NIO2 connector
AprProtocol ：the APR/native connector
它們之間的異同點如下表所示：

 Java Nio ConnectorJava Nio2 ConnectorAPR/native Connector
Classname Http11NioProtocol Http11Nio2Protocol Http11AprProtocol
Tomcat Version 6.x onwards 8.x onwards 5.5.x onwards
Support Polling YES YES YES
Polling Size maxConnections maxConnections maxConnections
Read Request Headers Non Blocking Non Blocking Non Blocking
Read Request Body Blocking Blocking Blocking
Write Response Headers and Body Blocking Blocking Blocking
Wait for next Request Non Blocking Non Blocking Non Blocking
SSL Support Java SSL or OpenSSL Java SSL or OpenSSL OpenSSL
SSL Handshake Non blocking Non blocking Blocking
Max Connections maxConnections maxConnections maxConnections

下麵是一個定義了多個屬性的SSL連接器：

<Connector port="8443"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" acceptCount="100" debug="0" scheme="https" secure="true"
    clientAuth="false" sslProtocol="TLS" />

5.5 容器類engine

engine是service組件中用來分析協議的引擎機器，它從一個或多個connector上接收請求，並將請求交給對應的虛擬主機進行處理，最後返回完整的響應數據給connector，通過connector將響應數據返回給客戶端。

只有一個engine元素必須嵌套在每個service中，且engine必須在其所需要關聯的connector之後，這樣在engine前面的connector都可以被此engine關聯，而在engine後面的connector則被忽略，因為一個service中只允許有一個engine。

定義方式大致如下：

<Engine name="Catalina" defaultHost="localhost">
</Engine>

<Engine name="Standalone" defaultHost="localhost" jvmRoute="TomcatA">
</Engine>

常用的engine屬性有：

  • className：實現engine的類，該類必須實現org.apache.catalina.Engine介面。不給定該屬性時將採用預設的標準類org.apache.catalina.core.StandardEngine。
  • defaultHost：指定處理請求的預設虛擬主機。在Engine中定義的多個虛擬主機的主機名稱中至少有一個跟defaultHost定義的主機名稱同名。
  • name：Engine組件的名稱，用於記錄日誌和錯誤信息，無關緊要的屬性，可隨意給定。
  • jvmRoute：在啟用session粘性時指定使用哪種負載均衡的標識符。所有的tomcat server實例中該標識符必須唯一，它會追加在session標識符的尾部，因此能讓前端代理總是將特定的session轉發至同一個tomcat實例上。
    註意，jvmRoute同樣可以使用jvmRoute的系統屬性來設置。如果此處設置了jvmRoute，則覆蓋jvmRoute系統屬性。關於jvmRoute的使用，在後面tomcat ajp負載均衡的文章中介紹。

engine是容器中的頂級子容器，其內可以嵌套一個或多個Host作為虛擬主機，且至少一個host要和engine中的預設虛擬主機名稱對應。除了host，還可以嵌套releam和valve組件。

5.6 容器類host

host容器用來定義虛擬主機。engine從connector接收到請求進行分析後，會將相關的屬性參數傳遞給對應的(篩選方式是從請求首部的host欄位和虛擬主機名稱進行匹配)虛擬host進行處理。如果沒有合適的虛擬主機，則傳遞給預設虛擬主機。因此每個容器中必須至少定義一個虛擬主機，且必須有一個虛擬主機和engine容器中定義的預設虛擬主機名稱相同。

大致定義方式如下：

<Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">
</Host>

常用屬性說明：

  • className：實現host容器的類，該類必須實現org.apache.catalina.Host介面。不給定該屬性時將採用預設的標準類org.apache.catalina.core.StandardHost。
  • name：虛擬主機的主機名，忽略大小寫(初始化時會自動轉換為小寫)。可以使用首碼星號通配符，如"*.a.com"。使用了星號首碼的虛擬主機的匹配優先順序低於精確名稱的虛擬主機。
  • appBase：此Host的webapps目錄，即webapp部署在此虛擬主機上時的存放目錄。包括非歸檔的web應用程式目錄和歸檔後的WAR文件的目錄。使用相對路徑時基於$CATALINA_BASE。
  • xmlBase：部署在此虛擬主機上的context xml目錄。
  • startStopThreads：啟動context容器時的並行線程數。如果使用了自動部署功能，則再次部署或更新時使用相同的線程池。
  • autoDeploy：在Tomcat處於運行狀態時放置於appBase目錄中的應用程式文件是否自動進行deploy或自動更新部署狀態。這等於同時開啟了deployOnStartup屬性和reload/redeploy webapp的功能。觸發自動更新時將預設重載該webapp。預設為true。
  • unpackWars：在執行此webapps時是否先對歸檔格式的WAR文件解壓再運行，設置為false時則直接執行WAR文件；預設為true。設置為false時會損耗性能。
  • workDir：該虛擬主機的工作目錄。每個webapp都有自己的臨時IO目錄，預設該工作目錄為$CATALINA_BASE/work。

大多數時候都只需設置虛擬主機名稱name和webBase屬性即可，其餘採用預設，預設時會自動部署webapp。有時候還需要管理多個站點名稱，即主機別名。可以使用Alias為Host指定的主機名定義主機別名。如：

<Host name="web.a.com" appBase="webapps" unpackWARs="true">
  <Alias>www.a.com</Alias>
</Host>

自動部署指的是自動裝載webapp以提供相關webapp的服務。

5.7 容器類context

connector和containor是整個tomcat的心臟，而context則是containor的心臟，更是tomcat心髒的心臟。它是真正管理servlet的地方，它的配置影響了servlet的工作方式。

一個context代表一個webapp。servlet中規定，每個webapp都必須基於已歸檔的WAR(WEB application archive)文件或基於非歸檔相關內容所在目錄。

catalina基於對請求URI與context中定義的path進行最大匹配首碼的規則進行挑選，從中選出使用哪個context來處理該HTTP請求。這相當於nginx的location容器，catalina的path就相當於location的path，它們的作用是相同的。

每個context都必須在虛擬主機容器host中有一個唯一的context name。context的path不需要唯一，因為允許同一個webapp不同版本的共存部署。此外，必須要有一個context的path為0長度的字元串(如<Context path="" docBase="ROOT"/>)，該context是該虛擬主機的預設webapp，用於處理所有無法被虛擬主機中所有context path匹配的請求(當然，不定義也可以，此時將自動隱式提供，見前文所述)。

關於context name，它是從context path推斷出來的，不僅如此，其餘幾個屬性如context basefile name也是由此推斷出來的。規則如下：

  • 如果path不為空，則context name等於context path，basefile name取path中去除首碼"/"後的路徑，且所有"/"替換為"#"。
  • 如果path為空，則context name也為空，而basefile為ROOT(註意是大寫)。

例如：

context path    context name    basefile name     deploy examples
-----------------------------------------------------------------
/foo
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • C#實現映像劫持
    “映像劫持”，也被稱為“IFEO”（Image File Execution Options），在WindowsNT架構的系統里，IFEO的本意是為一些在預設系統環境中運行時可能引發錯誤的程式執行體提供特殊的環境設定。當一個可執行程式位於IFEO的控制中時，它的記憶體分配則根據該程式的參數來設定，而W ...
  • Orchard Core Framework：ASP.NET Core 模塊化，多租戶框架
    Orchard Core Framework：ASP.NET Core 模塊化，多租戶框架 上一篇編寫Orchard Core一分鐘搭建ASP.NET Core CMS ，介紹ASP.NET Core CMS ，Orchard的ASP.NET Core版，同時對應有一個ASP.NET Core框架。 ...
  • [UWP]本地化入門
    1. 前言 "上一篇文章" 介紹了各種WPF本地化的入門知識，這篇文章介紹UWP本地化的入門知識。 2. 使用resw資源文件實現本地化 在以前的XAML平臺，resx資源文件是一種很方便的本地化方案，但在UWP中微軟又再次推薦x:Uid方案，預設的資源文件也變成resw資源文件。雖然尾碼名只差了一 ...
  • 背水一戰 Windows 10 (81) - 全球化
    背水一戰 Windows 10 之 全球化: Demo, 格式化數字 ...
  • .Net 5分鐘搞定網頁實時監控
    一、為什麼會用到網頁實時監控 LZ最近在無錫買房了，雖然在上海工作，但是上海房價實在太高無法承受，所以選擇還可以接受的無錫作為安身之地。買過房的小伙伴可能知道買房的流程，買房中間有一步很重要的就是需要商品房備案，簡單點說就是你買房時可以在政府商品房備案網站處查看你購買房的備案情況，如果是已經備案了開 ...
  • 快收藏！高手Linux運維管理必備工具大全，你會嗎？
    一、統一賬號管理 1.LDAP 統一管理各種平臺帳號和密碼，包括但不限於各種操作系統(Windows、Linux)，Linux系統sudo集成，系統用戶分組，主機登入限制等；可與Apache，HTTP，FTP，SAMBA，ZABBIX，Jenkins等集成；支持密碼策略(密碼強度、密碼過期時間、強制 ...
  • 項目實戰12.2—企業級監控工具應用實戰-zabbix操作進階
    無監控，不運維。好了，廢話不多說，下麵都是乾貨。 流量黨勿入，圖片太多！！！ 項目實戰系列，總架構圖 http://www.cnblogs.com/along21/p/8000812.html 一、User parameters 用戶參數 1、介紹和用法 ① 介紹 自定義用戶參數，也就是自定義key ...
  • Python之路【第一篇】:Python簡介和入門
    python簡介： 一、什麼是python Python（英國發音：/ pa θ n/ 美國發音：/ pa θɑ n/），是一種面向對象、直譯式的電腦程式語言。 每一門語言都有自己的哲學： pythonde 設計哲學是：“優雅”、“明確”、“簡單” 二、python由來 1989年的聖誕節期間，吉 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類