Tomcat配置

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

Server

Server 元素表示整個(gè) Catalina servlet 容器。

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

屬性表

Service

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

屬性表

實(shí)例 - conf/server.xml 配置文件示例

  ...

Executor

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

屬性表

Connector

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

屬性表

以下屬性在標(biāo)準(zhǔn)的Connector(NIO, NIO2 和 APR/native)中有效:

Context

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

屬性表

Engine

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

屬性表

Host

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

屬性表

Cluster

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

啟動(dòng)

部署方式

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

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

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

注意

以上步驟是最簡(jiǎn)單的示例。步驟中的 war 包解壓路徑、啟動(dòng)端口以及一些更多的功能都可以修改配置文件來定制 （主要是 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 {
        // 設(shè)定 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 啟動(dòng)嵌入式 Tomcat 的最簡(jiǎn)示例。

這個(gè)示例中使用的是 Tomcat 默認(rèn)的配置，但通常，我們需要對(duì) Tomcat 配置進(jìn)行一些定制和調(diào)優(yōu)。為了加載配置文件，啟動(dòng)類就要稍微再復(fù)雜一些。這里不想再貼代碼，有興趣的同學(xué)可以參考：

示例項(xiàng)目

使用 maven 插件啟動(dòng)（不推薦）

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

使用方法

在 pom.xml 中引入插件

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

運(yùn)行 mvn tomcat7:run 命令，啟動(dòng) Tomcat。

成功后，可以訪問 http://localhost:8080/xxx （xxx 是 ${project.artifactId} 指定的項(xiàng)目名）。

IDE 插件

常見 Java IDE 一般都有對(duì) Tomcat 的支持。

以 Intellij IDEA 為例，提供了 Tomcat and TomEE Integration 插件（一般默認(rèn)會(huì)安裝）。

使用步驟

·點(diǎn)擊 Run/Debug Configurations > New Tomcat Server > local ，打開 Tomcat 配置頁面。

·點(diǎn)擊 Confiure... 按鈕，設(shè)置 Tomcat 安裝路徑。

·點(diǎn)擊 Deployment 標(biāo)簽頁，設(shè)置要啟動(dòng)的應(yīng)用。

·設(shè)置啟動(dòng)應(yīng)用的端口、JVM 參數(shù)、啟動(dòng)瀏覽器等。

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

說明

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