过滤器(Filter)是JavaWEB的一个重要组件,又称为拦截器。基本功能是对
Servlet
容器调用Servlet
的过程进行拦截,从而在Servlet
进行响应处理的前后实现一些特殊的功能。Filter
是一个实现了Filter
接口的Java类,与Servlet
程序相似,由Servlet
容器进行调用和执行。Filter程序需要在web.xml
中进行注册和设置它所能拦截的资源:Filter
程序可以拦截JSP
、Servlet
、静态图片和静态HTML文件。
过滤器的实现
创建一个过滤器,通过实现Filter
接口:
public class MyFilter implements Filter{
}
Filter
接口的方法:
init()
:在WEB应用程序启动时,WEB服务器将根据web.xml
文件中的配置信息来创建每个注册的Filter
对象。init()
在创建Filter
对象后被调用,且只被调用一次。用于对当前的Filter
进行初始化操作。该方法传入一个FilterConfig
参数,代表该Filter
对象在web.xml
中配置以及运行环境。doFilter()
:每次拦截调用的方法。该方法传入三个参数:请求对象、响应对象以及过滤器链条。可以在代码中调用过滤器链的doFilter()
方法将过滤器传入过滤器链的下一个。destroy()
:在WEB容器卸载Filter
对象之前被调用。该方法在Filter
的生命周期中仅执行一次。通过这个方法,可以释放过滤器使用的资源。
public class MyFilter implements Filter {
public void init(FilterConfig fConfig) throws ServletException {
System.out.println("初始化过滤器...");
}
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
System.out.println("过滤器进行拦截...")
chain.doFilter(request, response);
}
public void destroy() {
System.out.println("销毁过滤器...")
}
}
配置过滤器
在当前WEB应用的web.xml
文件中注册和配置:
<!-- 注册Filter -->
<filter>
<filter-name>MyFilter</filter-name>
<filter-class>com.javaweb.MyFilter</filter-class>
</filter>
<!-- 映射Filter -->
<filter-mapping>
<filter-name>MyFilter</filter-name>
<url-pattern>/test.jsp</url-pattern>
</filter-mapping>
配置初始化参数
<filter>
<!-- ... -->
<init-param>
<param-name>name</param-name>
<param-value>value</param-value>
</init-param>
</filter>
在配置映射时可以使用dispatcher
节点来设置过滤器在何时工作,dispatcher
节点可以设置多个
<filter-mapping>
<dispatcher>REQUEST</dispatcher>
<filter-name>MyFilter</filter-name>
<url-pattern>/test.jsp</url-pattern>
</filter-mapping>
dispatcher
的值及其含义
dispathcer | 含义 |
---|---|
REQUEST | 目标资源被用户直接访问时过滤器被调用 |
INCLUDE | 目标资源通过RequestDispatcher 的include() 方法访问时过滤器被调用 |
FORWARD | 目标资源通过RequestDispatcher 的forward() 方法访问时过滤器被调用 |
ERROR | 目标资源通过声明式异常处理机制被调用时过滤器被调用 |
过滤器链
对于同一个拦截的对象,可能存在着多个过滤器,这些过滤器形成一个过滤器链。多个过滤器之间的拦截顺序与Filter
在web.xml
中映射有关。例如:
<filter-mapping>
<filter-name>MyFilter2</filter-name>
<url-pattern>/test.jsp</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>MyFilter</filter-name>
<url-pattern>/test.jsp</url-pattern>
</filter-mapping>
此时MyFilter2
先进行拦截,之后MyFilter再
进行拦截。
多个Filter
之间通过chain.doFilter
进行传递。
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
/*
过滤器处理代码...
*/
chain.doFilter(request, response); // 传递过滤器链
}chain.doFilter(request, response);