4.11.1 Cosminexusが提供するサーブレットフィルタbuilt-inフィルタ

Cosminexusでは,次に示す機能を使用するためのサーブレットフィルタ(built-inフィルタ)を提供しています。

built-inフィルタの種類を次の表に示します。また,Webアプリケーションにbuilt-inフィルタを組み込むことによって使用できる機能の参照先をあわせて示します。

表4-23 built-inフィルタの種類

built-inフィルタの種類機能の説明参照先
セッションフェイルオーバ用フィルタJ2EEアプリケーションで実行中のセッション情報を管理します。J2EEサーバで障害が発生したときに,管理しているセッション情報をほかのJ2EEサーバに引き継ぎます。12章
HTTPレスポンス圧縮フィルタサーブレット,JSP,および静的コンテンツへのHTTPリクエストに対するHTTPレスポンスをgzip形式に圧縮します。4.12

以降で,built-inフィルタのHTTPリクエスト・HTTPレスポンスへの作用,built-inフィルタの動作条件に関する制約について説明します。

<この項の構成>
(1) HTTPリクエストおよびHTTPレスポンスへの作用
(2) 動作条件に関する制約

(1) HTTPリクエストおよびHTTPレスポンスへの作用

built-inフィルタは,クライアント側から送信されるHTTPリクエストのリクエストヘッダ,およびリクエストボディに対して作用して,情報の削除,追加,変更などを実施する場合があります。また,サーバから送信されるHTTPレスポンスのレスポンスヘッダ,およびレスポンスボディに対して同様に作用する場合もあります。built-inフィルタのHTTPリクエストおよびHTTPレスポンスへの作用を次の表に示します。

表4-24 built-inフィルタのHTTPリクエストおよびHTTPレスポンスへの作用

built-inフィルタの種類HTTPリクエストへの作用HTTPレスポンスへの作用
セッションフェイルオーバ用フィルタ
HTTPレスポンス圧縮フィルタレスポンスボディが圧縮される場合,Content-Encodingヘッダに「gzip」を指定します。また,レスポンスボディをgzip形式で圧縮します。

(凡例) -:該当なし


(2) 動作条件に関する制約

ユーザのフィルタと,built-inフィルタを同時に使用する場合,フィルタ連鎖の中でbuilt-inフィルタが呼び出される順序に制約があります。

built-inフィルタごとに次に示す制約について説明します。

(a) セッションフェイルオーバ用フィルタに対する制約

セッションフェイルオーバ用フィルタに対する制約を次の表に示します。

表4-25 セッションフェイルオーバ用フィルタに対する制約

制約の種類説明
位置に関する制約フィルタ連鎖の中で,最初に呼び出される必要があります。すべてのユーザのフィルタおよびbuilt-inフィルタよりも前に配置する必要があります。
動作条件に関する制約
前後に配置するほかのサーブレットフィルタに対する制約

(凡例) -:該当なし


(b) HTTPレスポンス圧縮フィルタに対する制約

HTTPレスポンス圧縮フィルタに対する制約を次の表に示します。

表4-26 HTTPレスポンス圧縮フィルタに対する制約

制約の種類説明
位置に関する制約
動作条件に関する制約
前後に配置するほかのサーブレットフィルタに対する制約javax.servlet.http.HttpServletResponseクラスのsetHeaderメソッド,addHeaderメソッド,setIntHeaderメソッド,またはaddIntHeaderメソッドを使用して,Content-Lengthヘッダ,またはContent-Encodingヘッダの設定を変更するサーブレットフィルタと同時に使用する場合,そのサーブレットフィルタはHTTPレスポンス圧縮フィルタよりあとに配置する必要があります。

(凡例) -:該当なし