このマニュアルには、conf/server.xml
ファイルに含めることができる、Tomcat Servlet/JSP コンテナの動作を構成するためのすべての構成ディレクティブに関するリファレンス情報が含まれています。特定のタスクを実行するためにどの構成ディレクティブを使用する必要があるかを説明しようとするものではありません。それについては、メインインデックスページのさまざまなハウツー文書を参照してください。
Tomcat 構成ファイルはスキーマなしの XML 形式で、要素と属性は大文字と小文字が区別されます。Apache Ant スタイルの変数置換がサポートされています。名前が propname
のシステムプロパティを構成ファイル内で ${propname}
シンタックスを使用して使用できます。-D
シンタックスを使用して設定されたプロパティ、JVM によって自動的に使用可能になるプロパティ、および $CATALINA_BASE/conf/catalina.properties
ファイルで設定されたプロパティを含むすべてのシステムプロパティを使用できます。
構成要素の説明は、次の主要なカテゴリに整理されています。
- 最上位要素 -
<Server>
は構成ファイル全体のルート要素である一方、<Service>
は Engine に関連付けられたコネクタのグループを表します。 - コネクタ - 外部クライアントと、特定のサービスへのリクエストの送信(およびそれらからの応答の受信)とのインターフェースを表します。
- コンテナ - 着信リクエストを処理し、対応する応答を作成するコンポーネントを表します。エンジンはサービスのすべてのリクエストを処理し、ホストは特定の仮想ホストのすべてのリクエストを処理し、コンテキストは特定の Web アプリケーションのすべてのリクエストを処理します。
- ネストされたコンポーネント - コンテナの要素内でネストできる要素を表します。一部の要素はどのコンテナ内にもネストできますが、コンテキスト内でのみネストできる要素もあります。
要素ごとに、対応するドキュメントには、この一般的なアウトラインが含まれています。
- はじめに - この特定のコンポーネントの概要説明。1 つ以上の標準実装によって実装される、対応する Java インターフェース(
org.apache.catalina
パッケージ内)があります。 - 属性 - この要素に対して使用できる属性のセット。通常、これは、対応する Java インターフェースのすべての実装によってサポートされる 共通属性、およびこのインターフェースを実装する特定の Java クラスに固有の 標準実装属性に細分されます。必須属性の名前は**太字**です。
- ネストされたコンポーネント - この要素内にネストできる ネストされたコンポーネント の列挙。
- 特殊な機能 - このインターフェースの標準実装によりサポートされる、多種多様な特別な機能の構成について記載します(それぞれの要素タイプに固有)。