filter

它新增加的功能包括：

1. 應用程序生命周期事件控制；

2. 新的國際化；

3. 澄清了類的裝載規則；

4. 新的錯誤及安全屬性；

5. 不贊成使用HttpUtils 類；

6. 各種有用的方法；

7. 闡明並擴展了幾個servlet DTD;

8. filter功能.

其中最重要的就是filter功能。它使用戶可以改變一個request和修改一個response. Filter 不是一個servlet，它不能產生一個response，它能夠在一個request到達servlet之前預處理request，也可以在response離開servlet時處理response.換種說法，filter其實是一個“servlet chaining“（servlet 鏈）.

包括

1. 在servlet被調用之前截獲；

2. 在servlet被調用之前檢查servlet request;

3. 根據需要修改request頭和request數據；

4. 根據需要修改response頭和response數據；

5. 在servlet被調用之後截獲.

你能夠配置一個filter 到一個或多個servlet；單個servlet或servlet組能夠被多個filter 使用。幾個實用的filter 包括：用戶辨認filter，日誌filter，審核filter，加密filter，符號filter，能改變xml內容的XSLT filter等。

一個filter必須實現javax.servlet.Filter。

三個方法

1. void setFilterConfig(FilterConfig config) //設置filter 的配置對象；

2. FilterConfig getFilterConfig() //返回filter的配置對象；

3. void doFilter(ServletRequest req,ServletResponse res,FilterChain chain) //執行filter 的工作.

註：現setFilterConfig和getFilterConfig方法已取消，代之為init(FilterConfig config)和destory()方法。

伺服器每次只調用setFilterConfig方法一次準備filter 的處理；調用doFilter方法多次以處理不同的請求.FilterConfig介面有方法可以找到filter名字及初始化參數信息。伺服器可以設置FilterConfig為空來指明filter已經終結.

每一個filter從doFilter（）方法中得到當前的request及response.在這個方法里，可以進行任何的針對request及response的操作.（包括收集數據，包裝數據等）.filter調用chain.doFilter（）方法把控制權交給下一個filter.一個filter在doFilter（）方法中結束。如果一個filter想停止request處理而獲得對response的完全的控制，那它可以不調用下一個filter.

一個filter可以包裝request 或response以改變幾個方法和提供用戶定製的屬性.Api2.3提供了HttpServletRequestWrapper 和HttpServletResponseWrapper來實現。它們能分派最初的request和response.如果要改變一個方法的特性，必須繼承wapper和重寫方法。下面是一段簡單的日誌filter用來記錄所有request的持續時間.

public class LogFilter implements Filter {

FilterConfig config;

public void setFilterConfig(FilterConfig config) {

this.config = config;

}

public FilterConfig getFilterConfig() {

return config;

}

public void doFilter(ServletRequest req,

ServletResponse res,

FilterChain chain) {

ServletContext context = getFilterConfig().getServletContext();

long bef = System.currentTimeMillis();

chain.doFilter(req,res); // no chain parameter needed here

long aft = System.currentTimeMillis();

context.log("Request to " + req.getRequestURI()

+ ": " + (aft-bef));

}

}

當server調用setFilterConfig(),filter保存config信息。在doFilter（）方法中通過config信息得到servletContext.如果要運行這個filter，必須去配置到web.xml中。以tomcat4.01為例：

log //filter 名字

LogFilter //filter class（上例的servlet)

< url-pattern>/*< /url-pattern>

把這個web.xml放到web-inf中（詳請參考tomcat幫助文檔）.

當每次請求一個request時（如index.jsp），先到LogFilter中去並調用doFilter（）方法，然後才到各自的servlet中去。如果是一個簡單的servlet（只是一個頁面，無任何輸出語句），那麼可能的輸出是：

Request to /index.jsp: 10