Server コンポーネント

目次

はじめに

Server 要素は、Catalina サーブレットコンテナ全体を表します。そのため、conf/server.xml 設定ファイルでは、唯一の最上位要素である必要があります。その属性は、サーブレットコンテナ全体の特性を表します。

属性

共通属性

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

属性説明
className

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

address

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

port

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

注：シャットダウンポートを無効にすることは、Apache Commons Daemon（Windowsでサービスとして実行する場合、またはUnix系でjsvcを使用する場合）を使用してTomcatを起動する場合に有効です。ただし、標準のシェルスクリプトでTomcatを実行している場合は使用できません。これは、shutdown.bat|.shとcatalina.bat|.shがTomcatを正常に停止できなくなるためです。

portOffset

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

shutdown

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

utilityThreads

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

標準実装

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

属性説明
utilityThreadsAsDaemon

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

periodicEventDelay

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

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

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

特別な機能

Server に関連付けられた特別な機能はありません。