Service コンポーネント

目次

はじめに

Service 要素は、受信リクエストを処理するために単一の Engine コンポーネントを共有する 1 つ以上の Connector コンポーネントの組み合わせを表します。 1 つ以上の Service 要素が Server 要素内にネストされている場合があります。

属性

共通属性

Service のすべての実装は、次の属性をサポートしています

属性説明
className

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

name

この Service の表示名。標準の Catalina コンポーネントを使用する場合、ログメッセージに含められます。 特定の Server に関連付けられている各 Service の名前は一意である必要があります。

標準的な実装

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

属性説明
gracefulStopAwaitMillis

Service を停止するときに、クライアント接続が処理を完了して閉じるのを待つ時間 (ミリ秒単位)。Service のコンテナ階層が停止する前に待ちます。 待機は、デフォルトではない bindOnInit 値が false に設定された Connector にのみ適用されます。 0 以下の値は待機しないことを意味します。 指定しない場合、デフォルト値の 0 が使用されます。

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

Service 要素内にネストできるコンポーネントは、1 つ以上の Connector 要素と、それに続く 1 つの Engine 要素のみです。

特別な機能

Service に関連する特別な機能はありません。