Filter雖然很常用,但是覆蓋的范圍太廣,這里我們只介紹設置編碼和控制權限的過(guò)濾器,其他的使用方式還需要大家自行積累。
如果你不滿(mǎn)足以下任一條件,請繼續閱讀,否則請跳過(guò)此后的部分,進(jìn)入下一章:第 8 章 配置listener監聽(tīng)器。
了解Filter的使用。
編碼問(wèn)題會(huì )不會(huì )成為中國人學(xué)java的標志呢?
通過(guò)之前的討論第 2.2.2 節 “POST亂碼”,我們知道為了避免提交數據的亂碼問(wèn)題,需要在每次使用請求之前設置編碼格式。在你復制粘貼了無(wú)數次request.setCharacterEncoding("gb2312");后,有沒(méi)有想要一勞永逸的方法呢?能不能一次性修改所有請求的編碼呢?
用Filter吧,它的名字是過(guò)濾器,可以批量攔截修改servlet的請求和響應。
我們編寫(xiě)一個(gè)EncodingFilter.java,來(lái)批量設置請求編碼。
package anni; import java.io.IOException; import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; public class EncodingFilter implements Filter { public void init(FilterConfig config) throws ServletException {} public void destroy() {} public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { request.setCharacterEncoding("gb2312"); chain.doFilter(request, response); } }
在此EncodingFilter實(shí)現了Filter接口,Filter接口中定義的三個(gè)方法都要在EncodingFilter中實(shí)現,其中doFilter()的代碼實(shí)現主要的功能:為請求設置gb2312編碼并執行chain.doFilter()繼續下面的操作。
與servlet相似,為了讓filter發(fā)揮作用還需要在web.xml進(jìn)行配置。
<filter> <filter-name>EncodingFilter</filter-name> <filter-class>anni.EncodingFilter</filter-class> </filter> <filter-mapping> <filter-name>EncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
filter標簽部分定義使用的過(guò)濾器,filter-mapping標簽告訴服務(wù)器把哪些請求交給過(guò)濾器處理。這里的/*表示所有請求,/表示根路徑,*(星號)代表所有請求,加在一起就變成了根路徑下的所有請求。
這樣,所有的請求都會(huì )先被EncodingFilter攔截,并在請求里設置上指定的gb2312編碼。
例子在lingo-sample/07-01目錄下,這次我們不需要在test.jsp中為請求設置編碼也可以得到正常的中文參數了,EncodingFilter圓滿(mǎn)的完成了它的工作。
出于信息安全和其他一些原因的考慮,項目中的一些頁(yè)面要求用戶(hù)滿(mǎn)足了一定條件之后才能訪(fǎng)問(wèn)。比如,讓用戶(hù)輸入賬號和密碼,如果輸入的信息正確就在session里做一個(gè)成功登錄的標記,其后在請求保密信息的時(shí)候判斷session中是否有已經(jīng)登錄成功的標記,存在則可以訪(fǎng)問(wèn),不存在則禁止訪(fǎng)問(wèn)。
如07-02例子中所示,進(jìn)入首頁(yè)看到的就是登錄頁(yè)面。

現在用戶(hù)還沒(méi)有登錄,如果直接訪(fǎng)問(wèn)保密信息,就會(huì )顯示無(wú)法訪(fǎng)問(wèn)保密信息的頁(yè)面,并提醒用戶(hù)進(jìn)行注冊。

返回登錄頁(yè)面后,輸入正確的用戶(hù)名和密碼,點(diǎn)擊登錄。

后臺程序判斷用戶(hù)名和密碼正確無(wú)誤后,在session中設置已登錄的標記,然后跳轉到保密信息頁(yè)面。

我們要保護的頁(yè)面是admin/index.jsp,為此我們在web.xml進(jìn)行如下配置。
<filter> <filter-name>SecurityFilter</filter-name> <filter-class>anni.SecurityFilter</filter-class> </filter> <filter-mapping> <filter-name>SecurityFilter</filter-name> <url-pattern>/admin/*</url-pattern> </filter-mapping>
定義SecurityFilter過(guò)濾器,讓它過(guò)濾匹配/admin/*的所有請求,這就是說(shuō),對/admin/路徑下的所有請求都會(huì )接受SecurityFilter的檢查,那么SecurityFilter里到底做了些什么呢?
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req = (HttpServletRequest) request; HttpServletResponse res = (HttpServletResponse) response; HttpSession session = req.getSession(); if (session.getAttribute("username") != null) { chain.doFilter(request, response); } else { res.sendRedirect("../failure.jsp"); } }
首先要將ServletRequest和ServletResponse轉換成HttpServletRequest和HttpServletResponse,因為Filter本來(lái)設計成為多種協(xié)議服務(wù),http協(xié)議僅僅是其中一部分。不過(guò)我們接觸到的也只有http,而且也只有轉換成對應HttpServletRequest和HttpServletResponse才能進(jìn)行下面的session操作和頁(yè)面重定向。
得到了http請求之后,可以獲得請求對應的session,判斷session中的username變量是否為null,如果不為null,說(shuō)明用戶(hù)已經(jīng)登錄,就可以調用doFilter繼續請求訪(fǎng)問(wèn)的資源。如果為null,說(shuō)明用戶(hù)還沒(méi)有登錄,禁止用戶(hù)訪(fǎng)問(wèn),并使用頁(yè)面重定向跳轉到failure.jsp頁(yè)面顯示提示信息。
session中的username實(shí)在登錄的時(shí)候設置進(jìn)去的,值就是登錄用戶(hù)使用的用戶(hù)名,詳細代碼可以參考07-02/WEB-INF/src/LoginServlet.java,登錄和注銷(xiāo)都寫(xiě)成了servlet并映射到/login.do和/logout.do這兩個(gè)請求路徑上。源代碼和web.xml配置請自行參考07-02中的例子,這里就不復述了。
我們再來(lái)看看頁(yè)面重定向的寫(xiě)法,res.sendRedirect()中使用的是"../failure.jsp",兩個(gè)點(diǎn)(..)代表當前路徑的上一級路徑,這是因為SecurityFilter負責處理的是/admin/下的請求,而/failure.jsp的位置在/admin/目錄的上一級,所以加上兩個(gè)點(diǎn)才能正確跳轉到failure.jsp。當然這里使用forward()也可以,但是要注意在不同路徑下做請求轉發(fā)會(huì )影響頁(yè)面中相對路徑的指向。相關(guān)討論在:第 3.4.2 節 “forward導致找不到圖片”。
filter-mapping和servlet-mapping都是將對應的filter或servlet映射到某個(gè)url-pattern上,當客戶(hù)發(fā)起某一請求時(shí),服務(wù)器先將此請求與web.xml中定義的所有url-pattern進(jìn)行匹配,然后執行匹配通過(guò)的filter和servlet。
你可以使用三種方式定義url-pattern。
直接映射一個(gè)請求。
<servlet-mapping>
<servlet-name>ContactServlet</servlet-name>
<url-pattern>/contact.do</url-pattern>
</servlet-mapping>
像第 6.3 節 “使用servlet改寫(xiě)聯(lián)系簿”中對servlet的映射,只有當請求是/contact.do的時(shí)候才會(huì )執行ContactServlet。/contact.do?id=1或/contact.do?method=list&id=1的請求也可以匹配到ContactServlet,這是因為根據http規范,請求的路徑不包含問(wèn)號以后的部分。
映射一個(gè)路徑下的所有請求。
<servlet-mapping>
<servlet-name>EncodingFilter</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>
像第 7.1 節 “批量設置請求編碼”中這樣使用星號(*)的形式,可以將某個(gè)路徑下的所有請求都映射到EncodingFilter過(guò)濾器下,如果這個(gè)路徑下還有子路徑,那么子路徑下的請求也會(huì )被EncodingFilter過(guò)濾。所以 /*這種寫(xiě)法就會(huì )過(guò)濾應用下所有的請求。
如果像第 7.2 節 “用filter控制用戶(hù)訪(fǎng)問(wèn)權限”中那樣把映射配置成/admin/*,就會(huì )只處理/admin/路徑下的請求,不會(huì )處理根路徑下的/index.jsp和/failure.jsp。
需要注意的是,這種寫(xiě)法必須以/開(kāi)頭,寫(xiě)成與絕對路徑的形式,即便是映射所有請求也要寫(xiě)成/*,不能簡(jiǎn)化成*。
映射結尾相同的一類(lèi)請求。
<servlet-mapping>
<servlet-name>ControllerServlet</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
具體效果請參考07-03的例子,index.jsp中有四個(gè)鏈接,分別指向/a1.do, /a2.do, /xx/b1.do, /xx/yy/c1.do。

web.xml中的ControllerServlet會(huì )接收以.do結尾的請求,并使用forward將請求轉發(fā)到/test.jsp。
點(diǎn)擊/a1.do的情況。

點(diǎn)擊/xx/yy/c1.do的情況。

這樣做的一個(gè)好處是語(yǔ)義更清楚,只要看到以.do結尾的請求就知道肯定是交給ControllerServlet處理了,不管這個(gè)請求是在根路徑還是子路徑下,都會(huì )準確無(wú)誤的找到對應的servlet。
缺點(diǎn)就是不同路徑之間進(jìn)行forward,jsp里就不能再使用相對路徑了,所以我們在test.jsp中使用request.getContextPath()獲得當前應用在服務(wù)器中的位置(例子中是/07-03)將相對路徑都組裝成絕對路徑,這種用法在以后也會(huì )經(jīng)常用到。
<%
pageContext.setAttribute("ctx", request.getContextPath());
%>
<p><a href="${ctx}/index.jsp">返回</a></p>
最后需要注意的是,這種請求映射就不能指定某一路徑了,它必須是以星號(*)開(kāi)始字母結尾,不能寫(xiě)成/*.do的形式。
現在咱們也發(fā)現java的請求映射有多傻了,靈活配置根本是不可能的任務(wù)。
想要獲得所有以user開(kāi)頭.do結尾的請求嗎?user*.do在url-pattern是無(wú)法識別的,只能配置成*.do,再去servlet中對請求進(jìn)行篩選。
想要讓一個(gè)servlet負責多個(gè)請求嗎?/user/*,/admin/*,*.do寫(xiě)在一起url-pattern也不認識,只能配成多個(gè)servlet-mapping。
<servlet-mapping> <servlet-name>ControllerServlet</servlet-name> <url-pattern>/user/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>ControllerServlet</servlet-name> <url-pattern>/admin/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>ControllerServlet</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
java的復雜性在此處顯露無(wú)疑。實(shí)際使用時(shí),最好不要依賴(lài)web.xml中的配置,在自己的類(lèi)中實(shí)現靈活配置才是正途。
其實(shí)在07-02這個(gè)例子里,我們使用了兩個(gè)過(guò)濾器,EncodingFilter負責設置編碼,SecurityFilter負責控制權限,那這兩個(gè)過(guò)濾器是怎么起作用的呢?它們兩個(gè)同時(shí)過(guò)濾一個(gè)請求時(shí)誰(shuí)先誰(shuí)后呢?
下面這個(gè)圖會(huì )告訴我們答案。

所有的奧秘就在Filter中的FilterChain中。服務(wù)器會(huì )按照web.xml中過(guò)濾器定義的先后循序組裝成一條鏈,然后一次執行其中的doFilter()方法。執行的順序就如上圖所示,執行第一個(gè)過(guò)濾器的chain.doFilter()之前的代碼,第二個(gè)過(guò)濾器的chain.doFilter()之前的代碼,請求的資源,第二個(gè)過(guò)濾器的chain.doFilter()之后的代碼,第一個(gè)過(guò)濾器的chain.doFilter()之后的代碼,最后返回響應。
因此在07-02中執行的代碼順序是:
執行EncodingFilter.doFilter()中chain.doFilter()之前的部分:request.setCharacterEncoding("gb2312");
執行SecurityFilter.doFilter()中chain.doFilter()之前的部分:判斷用戶(hù)是否已登錄。
如果用戶(hù)已登錄,則訪(fǎng)問(wèn)請求的資源:/admin/index.jsp。
如果用戶(hù)未登錄,則頁(yè)面重定向到:/failure.jsp。
執行SecurityFilter.doFilter()中chain.doFilter()之后的部分:這里沒(méi)有代碼。
執行EncodingFilter.doFilter()中chain.doFilter()之后的部分:這里也沒(méi)有代碼。
過(guò)濾鏈的好處是,執行過(guò)程中任何時(shí)候都可以打斷,只要不執行chain.doFilter()就不會(huì )再執行后面的過(guò)濾器和請求的內容。而在實(shí)際使用時(shí),就要特別注意過(guò)濾鏈的執行順序問(wèn)題,像EncodingFilter就一定要放在所有Filter之前,這樣才能確保在使用請求中的數據前設置正確的編碼。
我們已經(jīng)了解了filter的基本用法,還有一些細節配置在特殊情況下起作用。
在servlet-2.3中,Filter會(huì )過(guò)濾一切請求,包括服務(wù)器內部使用forward轉發(fā)請求和<%@ include file="/index.jsp"%>的情況。
到了servlet-2.4中Filter默認下只攔截外部提交的請求,forward和include這些內部轉發(fā)都不會(huì )被過(guò)濾,但是有時(shí)候我們需要forward的時(shí)候也用到Filter,這樣就需要如下配置。
<filter> <filter-name>TestFilter</filtername> <filter-class>anni.TestFilter</filter-class> </filter> <filter-mapping> <filter-name>TestFilter</filtername> <url-pattern>/*</url-pattern> <dispatcher>REQUEST</dispatcher> <dispatcher>FORWARD</dispatcher> <dispatcher>INCLUDE</dispatcher> <dispatcher>EXCEPTION</dispatcher> </filter-mapping>
這樣TestFilter就會(huì )過(guò)濾所有狀態(tài)下的請求。如果我們沒(méi)有進(jìn)行設置,默認使用的就是REQUEST。而EXCEPTION是在isErrorPage="true"的情況下出現的,這個(gè)用處不多,看一下即可。
這里FORWARD是解決request.getDispatcher("index.jsp").forward(request, response);無(wú)法觸發(fā)Filter的關(guān)鍵,配置上這個(gè)以后再進(jìn)行forward的時(shí)候就可以觸發(fā)過(guò)濾器了。
Filter還有一個(gè)有趣的用法,在filter-mapping中我們可以直接指定servlet-mapping,讓過(guò)濾器只處理一個(gè)定義在web.xml中的servlet。
<filter-mapping> <filter-name>TestFilter</filter-name> <servlet-name>TestServlet</servlet-name> </filter-mapping> <servlet> <servlet-name>TestServlet</servlet-name> <servlet-class>anni.TestServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>TestServlet</servlet-name> <url-pattern>/TestServlet</url-pattern> </servlet-mapping>
聯(lián)系客服