Tomcat 教程之快速入门
版本說明
本文使用 Tomcat 版本為 Tomcat 8.5.24。
Tomcat 8.5 要求 JDK 版本為 1.7 以上。
簡介Tomcat 是什么
Tomcat 是由 Apache 開發的一個 Servlet 容器，實現了對 Servlet 和 JSP 的支持，并提供了作為Web服務器的一些特有功能，如Tomcat管理和控制平臺、安全域管理和Tomcat閥等。
由于 Tomcat 本身也內含了一個 HTTP 服務器，它也可以被視作一個單獨的 Web 服務器。但是，不能將 Tomcat 和 Apache HTTP 服務器混淆，Apache HTTP 服務器是一個用 C 語言實現的 HTTP Web 服務器；這兩個 HTTP web server 不是捆綁在一起的。Tomcat 包含了一個配置管理工具，也可以通過編輯XML格式的配置文件來進行配置。
Tomcat 重要目錄
- /bin?- Tomcat 腳本存放目錄（如啟動、關閉腳本）。?*.sh?文件用于 Unix 系統；?*.bat?文件用于 Windows 系統。
- /conf?- Tomcat 配置文件目錄。
- /logs?- Tomcat 默認日志目錄。
- /webapps?- webapp 運行的目錄。
web 工程發布目錄結構
一般 web 項目路徑結構
|-- webapp # 站點根目錄|-- META-INF # META-INF 目錄| `-- MANIFEST.MF # 配置清單文件|-- WEB-INF # WEB-INF 目錄| |-- classes # class文件目錄| | |-- *.class # 程序需要的 class 文件| | `-- *.xml # 程序需要的 xml 文件| |-- lib # 庫文件夾| | `-- *.jar # 程序需要的 jar 包| `-- web.xml # Web應用程序的部署描述文件|-- <userdir> # 自定義的目錄|-- <userfiles> # 自定義的資源文件webapp：工程發布文件夾。其實每個 war 包都可以視為 webapp 的壓縮包。
META-INF：META-INF 目錄用于存放工程自身相關的一些信息，元文件信息，通常由開發工具，環境自動生成。
WEB-INF：Java web應用的安全目錄。所謂安全就是客戶端無法訪問，只有服務端可以訪問的目錄。
/WEB-INF/classes：存放程序所需要的所有 Java class 文件。
/WEB-INF/lib：存放程序所需要的所有 jar 文件。
/WEB-INF/web.xml：web 應用的部署配置文件。它是工程中最重要的配置文件，它描述了 servlet 和組成應用的其它組件，以及應用初始化參數、安全管理約束等。
安裝前提條件
Tomcat 8.5 要求 JDK 版本為 1.7 以上。
進入?Tomcat 官方下載地址?選擇合適版本下載，并解壓到本地。
Windows
添加環境變量?CATALINA_HOME?，值為 Tomcat 的安裝路徑。
進入安裝目錄下的 bin 目錄，運行 startup.bat 文件，啟動 Tomcat
Linux / Unix
下面的示例以 8.5.24 版本為例，包含了下載、解壓、啟動操作。
# 下載解壓到本地 wget http://mirrors.hust.edu.cn/apache/tomcat/tomcat-8/v8.5.24/bin/apache-tomcat-8.5.24.tar.gz tar -zxf apache-tomcat-8.5.24.tar.gz # 啟動 Tomcat ./apache-tomcat-8.5.24/bin/startup.sh啟動后，訪問?http://localhost:8080?，可以看到 Tomcat 安裝成功的測試頁面。
配置
本節將列舉一些重要、常見的配置項。詳細的 Tomcat8 配置可以參考?Tomcat 8 配置官方參考文檔?。
Server
Server 元素表示整個 Catalina servlet 容器。
因此，它必須是?conf/server.xml?配置文件中的根元素。它的屬性代表了整個 servlet 容器的特性。
屬性表
| className | 這個類必須實現org.apache.catalina.Server接口。 | 默認 org.apache.catalina.core.StandardServer |
| address | 服務器等待關機命令的TCP / IP地址。如果沒有指定地址，則使用localhost。 | ? |
| port | 服務器等待關機命令的TCP / IP端口號。設置為-1以禁用關閉端口。 | ? |
| shutdown | 必須通過TCP / IP連接接收到指定端口號的命令字符串，以關閉Tomcat。 | ? |
Service
Service元素表示一個或多個連接器組件的組合，這些組件共享一個用于處理傳入請求的引擎組件。Server 中可以有多個 Service。
屬性表
| className | 這個類必須實現org.apache.catalina.Service接口。 | 默認?org.apache.catalina.core.StandardService |
| name | 此服務的顯示名稱，如果您使用標準 Catalina 組件，將包含在日志消息中。與特定服務器關聯的每個服務的名稱必須是唯一的。 | ? |
實例 -?conf/server.xml?配置文件示例
<?xml version="1.0" encoding="UTF-8"?> <Server port="8080" shutdown="SHUTDOWN"><Service name="xxx">...</Service> </Server>Executor
Executor表示可以在Tomcat中的組件之間共享的線程池。
屬性表
| className | 這個類必須實現org.apache.catalina.Executor接口。 | 默認?org.apache.catalina.core.StandardThreadExecutor |
| name | 線程池名稱。 | 要求唯一, 供Connector元素的executor屬性使用 |
| namePrefix | 線程名稱前綴。 | ? |
| maxThreads | 最大活躍線程數。 | 默認200 |
| minSpareThreads | 最小活躍線程數。 | 默認25 |
| maxIdleTime | 當前活躍線程大于minSpareThreads時,空閑線程關閉的等待最大時間。 | 默認60000ms |
| maxQueueSize | 線程池滿情況下的請求排隊大小。 | 默認Integer.MAX_VALUE |
Connector
Connector代表連接組件。Tomcat 支持三種協議：HTTP/1.1、HTTP/2.0、AJP。
屬性表
| asyncTimeout | Servlet3.0規范中的異步請求超時 | 默認30s |
| port | 請求連接的TCP Port | 設置為0,則會隨機選取一個未占用的端口號 |
| protocol | 協議. 一般情況下設置為 HTTP/1.1,這種情況下連接模型會在NIO和APR/native中自動根據配置選擇 | ? |
| URIEncoding | 對URI的編碼方式. | 如果設置系統變量org.apache.catalina.STRICT_SERVLET_COMPLIANCE為true,使用 ISO-8859-1編碼;如果未設置此系統變量且未設置此屬性, 使用UTF-8編碼 |
| useBodyEncodingForURI | 是否采用指定的contentType而不是URIEncoding來編碼URI中的請求參數 | ? |
以下屬性在標準的Connector(NIO, NIO2 和 APR/native)中有效:
| acceptCount | 當最大請求連接maxConnections滿時的最大排隊大小 | 默認100,注意此屬性和Executor中屬性maxQueueSize的區別.這個指的是請求連接滿時的堆棧大小,Executor的maxQueueSize指的是處理線程滿時的堆棧大小 |
| connectionTimeout | 請求連接超時 | 默認60000ms |
| executor | 指定配置的線程池名稱 | ? |
| keepAliveTimeout | keeAlive超時時間 | 默認值為connectionTimeout配置值.-1表示不超時 |
| maxConnections | 最大連接數 | 連接滿時后續連接放入最大為acceptCount的隊列中. 對 NIO和NIO2連接,默認值為10000;對 APR/native,默認值為8192 |
| maxThreads | 如果指定了Executor, 此屬性忽略;否則為Connector創建的內部線程池最大值 | 默認200 |
| minSpareThreads | 如果指定了Executor, 此屬性忽略;否則為Connector創建線程池的最小活躍線程數 | 默認10 |
| processorCache | 協議處理器緩存Processor對象的大小 | -1表示不限制.當不使用servlet3.0的異步處理情況下: 如果配置Executor,配置為Executor的maxThreads;否則配置為Connnector的maxThreads. 如果使用Serlvet3.0異步處理, 取maxThreads和maxConnections的最大值 |
Context
Context元素表示一個Web應用程序，它在特定的虛擬主機中運行。每個Web應用程序都基于Web應用程序存檔（WAR）文件，或者包含相應的解包內容的相應目錄，如Servlet規范中所述。
屬性表
| altDDName | web.xml部署描述符路徑 | 默認 /WEB-INF/web.xml |
| docBase | Context的Root路徑 | 和Host的appBase相結合, 可確定web應用的實際目錄 |
| failCtxIfServletStartFails | 同Host中的failCtxIfServletStartFails, 只對當前Context有效 | 默認為false |
| logEffectiveWebXml | 是否日志打印web.xml內容(web.xml由默認的web.xml和應用中的web.xml組成) | 默認為false |
| path | web應用的context path | 如果為根路徑,則配置為空字符串(""), 不能不配置 |
| privileged | 是否使用Tomcat提供的manager servlet | ? |
| reloadable | /WEB-INF/classes/ 和/WEB-INF/lib/ 目錄中class文件發生變化是否自動重新加載 | 默認為false |
| swallowOutput | true情況下, System.out和System.err輸出將被定向到web應用日志中 | 默認為false |
Engine
Engine元素表示與特定的Catalina服務相關聯的整個請求處理機器。它接收并處理來自一個或多個連接器的所有請求，并將完成的響應返回給連接器，以便最終傳輸回客戶端。
屬性表
| defaultHost | 默認主機名，用于標識將處理指向此服務器上主機名稱但未在此配置文件中配置的請求的主機。 | 這個名字必須匹配其中一個嵌套的主機元素的名字屬性。 |
| name | 此引擎的邏輯名稱，用于日志和錯誤消息。 | 在同一服務器中使用多個服務元素時，每個引擎必須分配一個唯一的名稱。 |
Host
Host元素表示一個虛擬主機，它是一個服務器的網絡名稱（如“www.mycompany.com”）與運行Tomcat的特定服務器的關聯。
屬性表
| name | 名稱 | 用于日志輸出 |
| appBase | 虛擬主機對應的應用基礎路徑 | 可以是個絕對路徑, 或${CATALINA_BASE}相對路徑 |
| xmlBase | 虛擬主機XML基礎路徑,里面應該有Context xml配置文件 | 可以是個絕對路徑, 或${CATALINA_BASE}相對路徑 |
| createDirs | 當appBase和xmlBase不存在時,是否創建目錄 | 默認為true |
| autoDeploy | 是否周期性的檢查appBase和xmlBase并deploy web應用和context描述符 | 默認為true |
| deployIgnore | 忽略deploy的正則 | ? |
| deployOnStartup | Tomcat啟動時是否自動deploy | 默認為true |
| failCtxIfServletStartFails | 配置為true情況下,任何load-on-startup >=0的servlet啟動失敗,則其對應的Contxt也啟動失敗 | 默認為false |
Cluster
由于在實際開發中，我從未用過Tomcat集群配置，所以沒研究。
啟動部署方式
這種方式要求本地必須安裝 Tomcat 。
將打包好的 war 包放在 Tomcat 安裝目錄下的?webapps?目錄下，然后在 bin 目錄下執行?startup.bat?或?startup.sh?，Tomcat 會自動解壓?webapps?目錄下的 war 包。
成功后，可以訪問?http://localhost:8080/xxx?（xxx 是 war 包文件名）。
注意
以上步驟是最簡單的示例。步驟中的 war 包解壓路徑、啟動端口以及一些更多的功能都可以修改配置文件來定制 （主要是?server.xml?或?context.xml?文件）。
嵌入式
API 方式
在 pom.xml 中添加依賴
<dependency><groupId>org.apache.tomcat.embed</groupId><artifactId>tomcat-embed-core</artifactId><version>8.5.24</version> </dependency>添加 SimpleEmbedTomcatServer.java 文件，內容如下：
import java.util.Optional; import org.apache.catalina.startup.Tomcat;public class SimpleTomcatServer {private static final int PORT = 8080;private static final String CONTEXT_PATH = "/javatool-server";public static void main(String[] args) throws Exception {// 設定 profileOptional<String> profile = Optional.ofNullable(System.getProperty("spring.profiles.active"));System.setProperty("spring.profiles.active", profile.orElse("develop"));Tomcat tomcat = new Tomcat();tomcat.setPort(PORT);tomcat.getHost().setAppBase(".");tomcat.addWebapp(CONTEXT_PATH, getAbsolutePath() + "src/main/webapp");tomcat.start();tomcat.getServer().await();}private static String getAbsolutePath() {String path = null;String folderPath = SimpleEmbedTomcatServer.class.getProtectionDomain().getCodeSource().getLocation().getPath().substring(1);if (folderPath.indexOf("target") > 0) {path = folderPath.substring(0, folderPath.indexOf("target"));}return path;} }成功后，可以訪問?http://localhost:8080/javatool-server?。
說明
本示例是使用?org.apache.tomcat.embed?啟動嵌入式 Tomcat 的最簡示例。
這個示例中使用的是 Tomcat 默認的配置，但通常，我們需要對 Tomcat 配置進行一些定制和調優。為了加載配置文件，啟動類就要稍微再復雜一些。這里不想再貼代碼，有興趣的同學可以參考：
示例項目
使用 maven 插件啟動（不推薦）
不推薦理由：這種方式啟動 maven 雖然最簡單，但是有一個很大的問題是，真的很久很久沒發布新版本了（最新版本發布時間：2013-11-11）。且貌似只能找到 Tomcat6 、Tomcat7 插件。
使用方法
在 pom.xml 中引入插件
<plugin><groupId>org.apache.tomcat.maven</groupId><artifactId>tomcat7-maven-plugin</artifactId><version>2.2</version><configuration><port>8080</port><path>/${project.artifactId}</path><uriEncoding>UTF-8</uriEncoding></configuration> </plugin>運行?mvn tomcat7:run?命令，啟動 Tomcat。
成功后，可以訪問?http://localhost:8080/xxx?（xxx 是 ${project.artifactId} 指定的項目名）。
IDE 插件
常見 Java IDE 一般都有對 Tomcat 的支持。
以 Intellij IDEA 為例，提供了?Tomcat and TomEE Integration?插件（一般默認會安裝）。
使用步驟
- 點擊 Run/Debug Configurations > New Tomcat Server > local ，打開 Tomcat 配置頁面。
- 點擊 Confiure... 按鈕，設置 Tomcat 安裝路徑。
- 點擊 Deployment 標簽頁，設置要啟動的應用。
- 設置啟動應用的端口、JVM 參數、啟動瀏覽器等。
- 成功后，可以訪問?http://localhost:8080/（當然，你也可以在?url 中設置上下文名稱）。
說明
個人認為這個插件不如 Eclipse 的 Tomcat 插件好用，Eclipse 的 Tomcat 插件支持對 Tomcat xml 配置文件進行配置。而這里，你只能自己去 Tomcat 安裝路徑下修改配置文件。
資料- Tomcat 官方網站
- Tomcat Wiki
- Tomee 官方網站
- Creating a Web App with Bootstrap and Tomcat Embedded
文中的嵌入式啟動示例可以參考我的示例項目
作者： 靜默虛空?
鏈接：https://www.imooc.com/article/22641
來源：慕課網
總結
以上是生活随笔為你收集整理的Tomcat 教程之快速入门的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： Tomcat的安装配置与JavaWeb入
- 下一篇： Tomcat-简易使用教程