filter功能.它使用戶能夠改變一個 request和修改一個response. Filter 不是一個servlet,它不能產生一個response,它可以在一個request到達servlet以前預處理request,也能夠在離開 servlet時處理response.換種說法,filter實際上是一個」servlet chaining」(servlet 鏈).一個filter 包括:java
1. 在servlet被調用以前截獲;web
2. 在servlet被調用以前檢查servlet request;tomcat
3. 根據須要修改request頭和request數據;服務器
4. 根據須要修改response頭和response數據;app
5. 在servlet被調用以後截獲.jsp
你可以配置一個filter 到一個或多個servlet;單個servlet或servlet組可以被多個filter 使用.幾個實用的filter 包括:用戶辨認filter,日誌filter,審覈filter,加密filter,符號filter,能改變xml內容的XSLT filter等.this
一個filter必須實現javax.servlet.Filter接口並定義三個方法:加密
1.void setFilterConfig(FilterConfig config) //設置filter 的配置對象;url
2. FilterConfig getFilterConfig() //返回filter的配置對象;spa
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