Filter的部署

来源:互联网 发布:2010表格找出重复数据 编辑:程序博客网 时间:2024/04/30 02:15

在编写完一个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:如果目标资源是通过声明式异常处理机制调用时,那么该过滤器将被调用。除此之外,过滤器不会被调用

0 0