一个过滤器链(FilterChain)包括多个Filter。
客户端请求request在抵达Servlet之前会经过FilterChain里所有的Filter,服务器响应response在从sevlet抵达客户端浏览器之前也会经过FilterChain里的所有Filter。
一个Filter必须实现javax.servlet.Filter接口。该接口中有3个方法:
- init()和destroy()方法只会被调用一次,分别在web程序加载或者卸载的时候调用;
- doFilter()每次有客户端请求都会被调用一次;在该方法中需要执行chain.doFilter(request,response)语句,作用是将request递交给FilterChain中的下一个Filter,如果所有的Filter都走完了则交给Servlet处理,如果在方法中不执行这个语句,则request不会交给后面的Filter或者Servlet。
在web.xml中配置:
<filter>
<filter-name>filterName</filter-name>
<filter-class>com.fyk.filter.MyFilter</filter-class>
<init-param>
<param-name>paramName</param-name>
<param-value>paramValue</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>filterName</filter-name>
<url-pattern>/jsp/*</url-pattern>
<url-pattern>*.do</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
- <filter>配置filter名称,实现类以及初始化参数(如果有的话)。可同时配置多个初始化参数。
- <filter-mapping>配置什么规则下使用该Filter。<filter>的filterName与<filter-mapping>的filterName必须匹配。
- <dispatcher>配置到达Servlet的方式,有4种取值:
- REQUEST:表示仅当直接请求Servlet时才生效;这个是默认值;
- FORWOARD:表示仅当某Servlet通过FORWARD到该Servlet时才生效;
- INCLUDE:JSP中可以通过<jsp:include/>请求某Servlet。仅这种情况下有效;
- ERROR:JSP中可以通过<%@page errorPage="error.jsp"%>指定的错误处理页面。仅在这种情况下才有效。
- <url-pattern>与<dispatcher>的关系是“且”的关系。只有满足<url-pattern>的条件,且满足<dispatcher>的条件时,该Filter才能生效。
可以配置多个Filter,<filter-mapping>配置在前面的Filter执行要早于配置在后面的。注意:多个Filter可能会互相影响。
也可以在filter-mapping中指定<servlet-name>springmvc</servlet-name>,相当于把指定的servlet对应的url-pattern作为filter的匹配模式
Filter的创建:
Filter的创建和销毁由WEB服务器负责。web应用程序启动时,web服务器将创建Filter的实例对象,并调用其init方法,完成对象的初始化功能,从而为后续的用户请求作好拦截的准备工作,filter对象只会创建一次,init方法也只会执行一次。通过init方法的参数,可获得代表当前filter配置信息的FilterConfig对象。
用户在配置filter时,可以使用<init-param>为filter配置一些初始化参数,当web容器实例化Filter对象,调用其init方法时,会把封装了filter初始化参数的filterConfig对象传递进来。因此开发人员在编写filter时,通过filterConfig对象的方法,就可获得:
- String getFilterName():得到filter的名称。
- String getInitParameter(String name): 返回在部署描述中指定名称的初始化参数的值。如果不存在返回null.
- Enumeration getInitParameterNames():返回过滤器的所有初始化参数的名字的枚举集合。
- public ServletContext getServletContext():返回Servlet上下文对象的引用。