本文共 3626 字,大约阅读时间需要 12 分钟。
Filter可认为是Servlet的“加强版”,主要用于对用户请求进行预处理,也可以对HttpServletResponse进行后处理,是个典型的处理链。Filter也可以对用户请求生成相应,这一点与Servlet相同,但实际上很少会这样使用。使用Filter的完整流程是:Filter对用户的请求进行预处理,接着将请求交给Servlet进行处理并响应生成,最后Filter在对服务器响应进行后处理。
1. Filter有如下几个用处:
在HttpServletRequest到达Servlet之前,拦截客户的HttpServletRequest
根据需要,检查HttpServletRequest,也可以修改HttpServletRequest的头和数据
在HttpServletResponse到达客户端之前,拦截HttpServletResponse
根据需要,检查HttpServletResponse,也可以修改HttpServletResponse的头和数据
2. Filter有如下几个种类:
用户授权的Filter:Filter负责检查用户请求,根据请求过滤用户的非法请求,通常用于权限管理。
日志Filter:详细记录某些特殊的用户请求
负责解码的Filter:包括对非标准编码的请求解码
能改变XML内容的XSLT Filter等
3. 创建一个Filter只需两个步骤:
1). 创建Filter处理类 2). 在web.xml文件中配置Filter
3.1 创建Filter处理类
创建Filter必须实现javax.servlet.Filter接口,在该接口中定义了如下三个方法:
void init(FilterConfig config):用于完成Filter的初始化
void destroy():用于Filter销毁钱,完成某些资源的回收
void doFilter(ServletRequest request, ServletResponse response, FilterChain chain):实现过滤功能,该方法就是对每个请求及响应增加的额外处理
下面是一个日志Filter,它负责拦截所有的用户请求,并将请求的信息记录在日志中。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | @WebFilter (filterName= "log" , urlPatterns={ "/*" }, initParams={ //这里使用注解的方式配置Filter @WebInitParam (name= "encoding" value= "UTF-8" ), @WebInitParam (name= "loginPage" value= "/login.jsp" ) }) public class LogFilter implements Filter { private FilterConfig config; //FilterConfig可用于访问Filter的配置信息 public void init(FilterConfig config) { this .config = config; } public void destroy(){ this .config = null ;} public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException{ //下面的代码用于对用户请求执行预处理 ServletContext context = this .config.getServletContext(); //获取ServletContext对象,用于记录日志 long before = System.currentTimeMillis(); System.out.println( "开始过滤..." ); HttpServletRequest request = (HttpServletRequest)req; System.out.println( "已经拦截到用户的请求地址:" + request.getServletPath()); chain.doFilter(req, resp); //Filter只是链式处理,请求依然放行到目的地址 //下面的代码用于对服务器响应执行后处理 long after = System.currentTimeMillis(); System.out.println( "过滤结束" ); System.out.println( "请求被定位到:" + request.getRequestURI() + " 耗时:" + (after - before)); //这里只是输出提示信息 } } |
上面的代码实现了doFilter()方法,实现该方法可以实现对用户请求的预处理,也可实现对服务器响应的后处理,它们的分界线为是否调用了chain.doFilter()方法,在这之前的是对用户请求的预处理,在这之后的,是对服务器响应的后处理。当Filter对请求过滤后,依然将请求发送到目的地址。如果需要检查权限,可以在Filter中根据用户请求的HttpSession,判断用户权限是否足够。如果权限不足,直接调用重定向即可,无需调用chain.doFilter()方法。
3.2 配置Filter
Filter在web.xml中的配置和Servlet在web.xml中的配置很相似,区别在于:一个Servlet通常只配置一个URL,而Filter可以同时拦截多个请求的URL,因此在配置Filter的urlPatterns时,通常会使用模式字符串,使得Filter可以拦截多个请求。和Servlet相似的是,配置Filter同样有两种方式:1). 在Filter类中通过注解进行配置 2). 在web.xml文件中进行配置
@WebFilter支持的常用属性介绍:
asyncSupported:指定该Filter是否支持异步操作模式
dispatcherTypes:指定该Filter仅对那种dispatcher模式的请求进行过滤。该属性支持ASYNC, ERROR, FORWARD, INCLUDE, REQUEST这5个值的任意组合,默认值为同时过滤这5中模式的请求
displayName:指定该Filter的显示名
filterName:指定该Filter的名称
initParams:用于为该Filter配置参数
servletNames:该属性可以指定多个Servlet名称,用于指定该Filter仅对这些Servlet进行过滤
urlPatterns/value:这两个属性的作用完全相同,用于指定该Filter所拦截的URL
下面是一个在web.xml中配置Filter的例子:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | < filter > < filter-name >log</ filter-name > <!-- 此属性相当于@WebFilter中的filterName属性 --> < filter-class >com.abc.LogFilter</ filter-class > <!-- Filter的实现类 --> < init-param > < param-name >encoding</ param-name > < param-value >UTF-8</ param-value > </ init-param > < init-param > < param-name >loginPage</ param-name > < param-value >/login.jsp</ param-value > </ init-param > </ filter > < filter-mapping > < filter-name >log</ filter-name > < url-pattern >/*</ url-pattern > <!-- 负责拦截所有的URL,相当于@WebFilter中的urlPatterns属性 --> </ filter-mapping > |
转载地址:http://jataa.baihongyu.com/