關於Java Servlet的Filter 技術

Filter 技術是servlet 2.3 新增加的功能.servlet2.3是sun公司與2000年10月發佈的,它的開發者包括許多個人和公司團體,充分體現了sun公司所倡導的代碼開放性原則.由於衆多的參與者的共同努力,servlet2.3比以往功能都強大了許多,而且性能也有了大幅提高. 
它新增加的功能包括: 
1. 應用程序生命週期事件控制; 
2. 新的國際化; 
3. 澄清了類的裝載規則; 
4. 新的錯誤及安全屬性; 
5. 不贊成使用HttpUtils 類; 
6. 各種有用的方法; 
7. 闡明並擴展了幾個servlet DTD; 
8. filter功能. 
其中最重要的就是filter功能.它使用戶可以改變一個request和修改一個response. Filter 不是一個servlet,它不能產生一個response,它能夠在一個request到達servlet之前預處理request,也可以在離開servlet時處理response.換種說法,filter其實是一個”servlet chaining”(servlet 鏈).一個filter 包括: 
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方法一次準備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爲例: 
<filter> 
<filter-name> 
log //filter 名字 
</filter-name> 
<filter-class> 
LogFilter //filter class(上例的servlet) 
</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>log</filter-name> 
<servletname>servletname</servlet-name> 
</filter-mapping> 
<servlet> 
<servlet-name>servletname</servletname> 
<servletclass>servletclass</servlet-class> 
</servlet> 
<servlet-mapping> 
<servlet-name>servletname</servlet-name> 
<url-pattern>*</url-pattern> 
</servlet-mapping> 

把這個web.xml放到web-inf中(詳請參考tomcat幫助文檔). 
當每次請求一個request時(如index.jsp),先到LogFilter中去並調用doFilter()方法,然後纔到各自的servlet中去.如果是一個簡單的servlet(只是一個頁面,無任何輸出語句),那麼可能的輸出是: 
Request to /index.jsp: 10