作者: 李文軍
??? 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
Servlet和Filter的url匹配以及url-pattern詳解
一，servlet容器對url的匹配過程：
當一個請求發送到servlet容器的時候，容器先會將請求的url減去當前應用上下文的路徑作為servlet的映射url，比如我訪問的是http://localhost/test/aaa.html，我的應用上下文是test，容器會將http://localhost/test去掉，剩下的/aaa.html部分拿來做servlet的映射匹配。這個映射匹配過程是有順序的，而且當有一個servlet匹配成功以后，就不會去理會剩下的servlet了（filter不同，后文會提到）。其匹配規則和順序如下：
1.?????精確路徑匹配。例子：比如servletA?的url-pattern為?/test，servletB的url-pattern為?/*?，這個時候，如果我訪問的url為http://localhost/test?，這個時候容器就會先?進行精確路徑匹配，發現/test正好被servletA精確匹配，那么就去調用servletA，也不會去理會其他的servlet了。
2.?????最長路徑匹配。例子：servletA的url-pattern為/test/*，而servletB的url-pattern為/test/a/*，此時訪問http://localhost/test/a時，容器會選擇路徑最長的servlet來匹配，也就是這里的servletB。
3.?????擴展匹配，如果url最后一段包含擴展，容器將會根據擴展選擇合適的servlet。例子：servletA的url-pattern：*.action
4.?????如果前面三條規則都沒有找到一個servlet，容器會根據url選擇對應的請求資源。如果應用定義了一個default?servlet，則容器會將請求丟給default?servlet（什么是default?servlet？后面會講）。
?????根據這個規則表，就能很清楚的知道servlet的匹配過程，所以定義servlet的時候也要考慮url-pattern的寫法，以免出錯。
?????? 對于filter，不會像servlet那樣只匹配一個servlet，因為filter的集合是一個鏈，所以只會有處理的順序不同，而不會出現只選擇一個filter。Filter的處理順序和filter-mapping在web.xml中定義的順序相同。
????二，url-pattern詳解
?????????在web.xml文件中，以下語法用于定義映射：
l??以”/’開頭和以”/*”結尾的是用來做路徑映射的。
l??以前綴”*.”開頭的是用來做擴展映射的。
l??“/”?是用來定義default?servlet映射的。
l??剩下的都是用來定義詳細映射的。比如：?/aa/bb/cc.action
所以，為什么定義”/*.action”這樣一個看起來很正常的匹配會錯？因為這個匹配即屬于路徑映射，也屬于擴展映射，導致容器無法判斷。