Servlet基本_Filter

１、概念
・サーブレットフィルタとは、サーブレットやJSPの「共通の前後処理」を記述するための仕組みです。
・フィルタはサーブレットやJSPの前に位置し、実行前と後に、リクエスト、レスポンスに対して任意の処理を行うことができます。
・フィルタの処理対象は任意のURLパターンが指定可能です。フィルタ対象はサーブレットとJSPだけではなく、
　Html、画像などWebアプリケーション内のリソースであれば何にでもフィルタをかけることができます。

２、フィルタの作成
・javax.servlet.Filter インターフェイス を実装したフィルタクラスを作成する。
・web.xmlにフィルタを登録する。

３、フィルタインタフェース
【javax.servlet.Filter】
フィルタクラスは、このインタフェースを実装して作成します。
3つのメソッドが定義されており、処理のある・なしにかかわらず3つとも実装必要です。
・void init(FilterConfig filterConfig)：　初期化
・void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)：フィルタ処理
・void destroy() ：終了処理

【javax.servlet.FilterConfig】
Filter.init()メソッドの引数に指定されるインタフェースです。

【javax.servlet.FilterChain】
Filter.doFilter()メソッドの引数に指定されるインタフェースです。
Filter は、チェーン内の次のフィルタを呼び出す時あるいは、呼び出している Filter がチェーン内の最後の Filter なら、
チェーンの終わりのリソースを呼び出す時に FilterChain を利用します。

４、web.xmlへの登録
    <filter>
        <filter-name>フィルタ名</filter-name>
        <filter-class>クラスファイル</filter-class>        
        <init-param>
            <param-name>初期化パラメータ名</param-name>
            <param-value初期化>値</param-value>
        </init-param>
    </filter>

<filter-mapping>
        <filter-name>フィルタ名</filter-name>
        <url-pattern>フィルタをかけるURL対象</url-pattern>
    </filter-mapping>

「url-pattern」は、
・「/*」は、全てのURLリソースに対してフィルタを適用します。
・「/admin/*」は、adminディレクトリ以下への呼び出しにフィルタ適用。
・「*.do」は、.doというURLに適用

５、フィルタのオン/オフ
フィルタへweb.xmlを編集することで付けたりはずしたりできます。
例えば、<filter-mapping>要素のコメントアウトでフィルタをオフします。

６、フィルタの順序
<filter-mapping>要素を記述した順番でフィルタが呼ばれます。

７、初期化パラメータ
フィルタは実行時に設定情報をweb.xmlから読み込むことができます。
初期化パラメータは＜filter＞の＜init-param＞要素で指定できます。
web.xmlに指定した初期化パラメータをフィルタクラスで読み込むためには、
Filter.init()メソッド内でjavax.servlet.FilterConfig.getInitParameter()メソッドを使用します。