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