サーバーコンポーネント

目次

はじめに

Server要素は、Catalinaサーブレットコンテナ全体を表します。したがって、conf/server.xml設定ファイル内で唯一の最も外側の要素でなければなりません。その属性は、サーブレットコンテナ全体の特性を表します。

属性

共通属性

Serverのすべての実装は、以下の属性をサポートしています。

属性説明
className

使用する実装のJavaクラス名です。このクラスはorg.apache.catalina.Serverインターフェースを実装している必要があります。クラス名が指定されていない場合、標準実装が使用されます。

address

このサーバーがシャットダウンコマンドを待機するTCP/IPアドレスです。アドレスが指定されていない場合、localhostが使用されます。

port

このサーバーがシャットダウンコマンドを待機するTCP/IPポート番号です。シャットダウンポートを無効にするには-1に設定します。

注意：シャットダウンポートを無効にすると、TomcatがApache Commons Daemonを使用して起動される場合（Windows上でサービスとして、またはun*xes上でjsvcを使用して実行される場合）にうまく機能します。ただし、標準のシェルスクリプトでTomcatを実行する場合には使用できません。なぜなら、これによりshutdown.bat|.shおよびcatalina.bat|.shが正常に停止できなくなるためです。

portOffset

portおよびネストされたコネクタのポートに適用するオフセットです。非負の整数である必要があります。指定しない場合、デフォルト値の0が使用されます。

shutdown

Tomcatをシャットダウンするために、指定されたポート番号へのTCP/IP接続を介して受信する必要があるコマンド文字列です。

utilityThreads

このServiceが、繰り返し実行されるものを含む様々なユーティリティタスクに使用するスレッド数です。0の特殊な値は、Runtime.getRuntime().availableProcessors()の値が使用されることを意味します。負の値は、Runtime.getRuntime().availableProcessors() + valueが使用されることを意味しますが、これが1未満になる場合は1つのスレッドが使用されます。デフォルト値は1です。

標準実装

Serverの標準実装はorg.apache.catalina.core.StandardServerです。これは、上記の共通属性に加えて、以下の追加属性をサポートします。

属性説明
utilityThreadsAsDaemon

ユーティリティスレッドのデーモンフラグ値を設定します。デフォルト値はfalseです。

periodicEventDelay

この値は、このServerに設定されたライフサイクルリスナーの定期的ライフサイクルイベント呼び出し間の遅延を秒単位で表します。値は秒単位で、負またはゼロの値は呼び出しを無効にします。指定しない場合、この属性のデフォルト値は10秒です。

ネストされたコンポーネント

以下のコンポーネントは、Server要素内にネストできます。

特殊機能

Serverには特別な機能は関連付けられていません。