Tomcat配置

本節(jié)將列舉一些重要、常見的配置項。詳細的 Tomcat8 配置可以參考 Tomcat 8 配置官方參考文檔 。

Server

Server 元素表示整個 Catalina servlet 容器。

因此，它必須是 conf/server.xml 配置文件中的根元素。它的屬性代表了整個 servlet 容器的特性。

屬性表

Service

Service元素表示一個或多個連接器組件的組合，這些組件共享一個用于處理傳入請求的引擎組件。Server 中可以有多個 Service。

屬性表

實例 - conf/server.xml 配置文件示例

  ...

Executor

Executor表示可以在Tomcat中的組件之間共享的線程池。

屬性表

Connector

Connector代表連接組件。Tomcat 支持三種協(xié)議：HTTP/1.1、HTTP/2.0、AJP。

屬性表

以下屬性在標準的Connector(NIO, NIO2 和 APR/native)中有效:

Context

Context元素表示一個Web應用程序，它在特定的虛擬主機中運行。每個Web應用程序都基于Web應用程序存檔（WAR）文件，或者包含相應的解包內(nèi)容的相應目錄，如Servlet規(guī)范中所述。

屬性表

Engine

Engine元素表示與特定的Catalina服務相關聯(lián)的整個請求處理機器。它接收并處理來自一個或多個連接器的所有請求，并將完成的響應返回給連接器，以便最終傳輸回客戶端。

屬性表

Host

Host元素表示一個虛擬主機，它是一個服務器的網(wǎng)絡名稱（如“www.mycompany.com”）與運行Tomcat的特定服務器的關聯(lián)。

屬性表

Cluster

由于在實際開發(fā)中，我從未用過Tomcat集群配置，所以沒研究。

啟動

部署方式

這種方式要求本地必須安裝 Tomcat 。

將打包好的 war 包放在 Tomcat 安裝目錄下的 webapps 目錄下，然后在 bin 目錄下執(zhí)行 startup.bat 或 startup.sh ，Tomcat 會自動解壓 webapps 目錄下的 war 包。

成功后，可以訪問 http://localhost:8080/xxx （xxx 是 war 包文件名）。

注意

以上步驟是最簡單的示例。步驟中的 war 包解壓路徑、啟動端口以及一些更多的功能都可以修改配置文件來定制 （主要是 server.xml 或 context.xml 文件）。

嵌入式

API 方式

在 pom.xml 中添加依賴

  org.apache.tomcat.embed
  tomcat-embed-core
  8.5.24
添加 SimpleEmbedTomcatServer.java 文件，內(nèi)容如下：
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 {
        // 設定 profile
        Optional 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 配置進行一些定制和調(diào)優(yōu)。為了加載配置文件，啟動類就要稍微再復雜一些。這里不想再貼代碼，有興趣的同學可以參考：

示例項目

使用 maven 插件啟動（不推薦）

不推薦理由：這種方式啟動 maven 雖然最簡單，但是有一個很大的問題是，真的很久很久沒發(fā)布新版本了（最新版本發(fā)布時間：2013-11-11）。且貌似只能找到 Tomcat6 、Tomcat7 插件。

使用方法

在 pom.xml 中引入插件

  org.apache.tomcat.maven
  tomcat7-maven-plugin
  2.2
  
    8080
    /${project.artifactId}
    UTF-8
  

運行 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 參數(shù)、啟動瀏覽器等。

·成功后，可以訪問 http://localhost:8080/（當然，你也可以在 url 中設置上下文名稱）。

說明

個人認為這個插件不如 Eclipse 的 Tomcat 插件好用，Eclipse 的 Tomcat 插件支持對 Tomcat xml 配置文件進行配置。而這里，你只能自己去 Tomcat 安裝路徑下修改配置文件。