これは,Tomcat 6 Servlet/JSP コンテナの振舞を設定するために
conf/server.xml ファイルに書くことができる
すべての設定ディレクティブについてのリファレンス・マニュアルである。
特定のタスクを遂行するためにどの設定ディレクティブを使ったらよいかは説明しない。
それについてはメイン index ページの HOW-TO ドキュメントを見よ。
設定要素の記述を大きく次のカテゴリに分ける:
- Top Level Elements -
<Server>
が設定ファイル全体のルート要素である。
一方,<Service> は1個の Engine に対する
Connector のグループを表す。
[実際,<Service> は <Server> の直下の要素であり,
1個の <Engine> と複数の <Connector> を子として持ちます]
- Connectors -
外部クライアントと Service のインタフェースを表す。
クライアントは Service へリクエストを送信し,そのレスポンスを受信する。
- Containers -
到来するリクエストの処理と,対応するレスポンスの生成を機能とするコンポーネントを表す。
Engine [というコンテナ] は Service へのすべてのリクエストを処理する。
Host [というコンテナ] は特定の仮想ホストへのすべてのリクエストを処理する。
Context [というコンテナ]
は1個の web アプリケーションへのすべてのリクエストを処理する。
- Nested Components -
コンテナを表す要素の内側で入れ子にできる要素を表す。
どのコンテナの内側でも入れ子にできる要素と,
Context の内側だけで入れ子にできる要素がある。
各要素に対応するドキュメンテーションは,下記の一般アウトラインに従う。
- はじめに (Introduction) -
このコンポーネントの全体的な記述である。
1個以上の標準実装によって実装されている
対応する Java インタフェース が
(
org.apache.catalina パッケージに) あるだろう。
- 属性 (Attributes) -
この要素で有効な属性の集合。
一般にこれは対応する Java インタフェースのすべての実装でサポートされている
共通 (Common) 属性と,
同インタフェースを実装する特定の Java class
に固有の標準 (Standard Implementation) 属性に小分割される。
必須属性名はボールド体で示される。
- 入れ子コンポーネント (Nested Components) -
この要素の中に正当に入れ子にできる入れ子コンポーネントを列挙する。
- 特記事項 (Special Features) -
このインタフェースの標準実装がサポートする (各要素型に固有の) さまざまな
特記事項の設定を記述する。