在编写完一个Filter类后, 需要对其进行部署,此Filter才能生效。通常都是在web.xml文件中对其进行配置。配置Filter的过程,也可以说是Filter的部署。Filter的部署分具体包括:Filter的注册,Filter的映射。
对Filter的注册
其形式如下:
<filter>
<filter-name>testFitler</filter-name>
<filter-class>org.test.TestFiter</filter-class>
<init-param>
<param-name>word_file</param-name>
<param-value>/WEB-INF/word.txt</param-value>
</init-param>
</filter>
其中filter-name是用于对给filter指定一个名字,且不能为空。
filter-class是指定实现filter类的完整类名,即过滤器完整的限定类名。
init-param为过滤器指定初始化参数,它有两个子元素param-name和param-value,param-name为参数指定一个名字,param-value则为参数指定一个值。在过滤器中,init-param指定的参数可以在FilterConfig类中来获取。
对Filter的映射
其形式如下:
<filter-mapping>
<filter-name>testFilter</filter-name>
<url-pattern>/index.jsp</url-pattern>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
</filter-mapping>
filter-mapping是用于设定过滤器所拦截的资源,一个Filter过滤器所拦截的资源可以通过如下两种方式来指定,servlet名称和资源访问的请求路径。filter-mapping有如下几个子元素:
filter-name:用于设置filter的注册名称,该名称必须是此<filter>元素中指定的名称
url-pattern:用于设定过滤器所拦截资源的请求路径
servlet-name:用于指定过滤器所拦截的servlet的名称
dispatcher:指定过滤器所拦截的资源被 Servlet 容器调用的方式,可以是REQUEST,INCLUDE,FORWARD和ERROR之一,默认REQUEST。用户可以设置多个<dispatcher> 子元素用来指定 Filter 对资源的多种调用方式进行拦截.
dispatcher: 子元素可以设置的值及其意义:
REQUEST:当用户直接访问页面时,Web容器将会调用过滤器。如果目标资源是通过RequestDispatcher的 include()或forward()方法访问时,那么该过滤器就不会被调用。
INCLUDE:如果目标资源是通过RequestDispatcher的include()方法访问时,那么该过滤器将被调用。除此之外,该过滤器不会被调用。
FORWARD:如果目标资源是通过RequestDispatcher的forward()方法访问时,那么该过滤器将被调用,除此之外,该过滤器不会被调用。
ERROR:如果目标资源是通过声明式异常处理机制调用时,那么该过滤器将被调用。除此之外,过滤器不会被调用