サービスコンポーネント

目次

はじめに

サービス要素は、1 つまたは複数の コネクタコンポーネントと、着信要求を処理するための単一の エンジン コンポーネントを共有する組み合わせを表します。1 つまたは複数の サービス要素を サーバー 要素内にネストできます。

属性

共通の属性

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

属性説明
className

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

name

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

標準実装

サービス の標準実装は org.apache.catalina.core.StandardService です。この実装は、前述の共通属性に加えて、次の追加属性をサポートしています

属性説明
gracefulStopAwaitMillis

サービスの停止時に、クライアント接続が処理を終えて閉じられる前にサービスのコンテナ階層が停止されるのを待つ時間をミリ秒数で指定します。待ち時間は、デフォルトではない bindOnInit 値が false で設定されたコネクタにのみ適用されます。0 以下の値は待機しないことを意味します。指定されない場合は、デフォルト値の 0 が使用されます。

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

サービス要素内にネストできる唯一のコンポーネントは、1 つまたは複数の コネクタ要素であり、その後に 1 つの エンジン 要素が続きます。

特別な機能

サービスに関連する特別な機能はありません。