7Filter配置细节

1.

<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>

（1）<filter-name>用于为过滤器指定一个名字，该元素的内容不能为空。
（2）<filter-class>元素用于指定过滤器的完整的限定类名。
（3）<init-param>元素用于为过滤器指定初始化参数，它的子元素<param-name>指定参数的名字，<param-value>指定参数的值。在过滤器中，可以使用FilterConfig接口对象来访问初始化参数。

 

2.<filter-mapping>

（1）<filter-mapping>元素用于设置一个 Filter 所负责拦截的资源。一个Filter拦截的资源可通过两种方式来指定：Servlet 名称和资源访问的请求路径
（2）<filter-name>子元素用于设置filter的注册名称。该值必须是在<filter>元素中声明过的过滤器的名字
（3）<url-pattern>设置 filter 所拦截的请求路径(过滤器关联的URL样式)
（4）<servlet-name>指定过滤器所拦截的Servlet名称。
（5）<dispatcher>指定过滤器所拦截的资源被 Servlet 容器调用的方式，可以是REQUEST,INCLUDE,FORWARD和ERROR之一，默认REQUEST。用户可以设置多个<dispatcher> 子元素用来指定 Filter 对资源的多种调用方式进行拦截。

 

3.<dispatcher>

<dispatcher> 子元素可以设置的值及其意义：
（1）REQUEST：当用户直接访问页面时，Web容器将会调用过滤器。如果目标资源是通过RequestDispatcher的include()或forward()方法访问时，那么该过滤器就不会被调用。
（2）INCLUDE：如果目标资源是通过RequestDispatcher的include()方法访问时，那么该过滤器将被调用。除此之外，该过滤器不会被调用。
（3）FORWARD：如果目标资源是通过RequestDispatcher的forward()方法访问时，那么该过滤器将被调用，除此之外，该过滤器不会被调用。
（4）ERROR：如果目标资源是通过声明式异常处理机制调用时，那么该过滤器将被调用。除此之外，过滤器不会被调用。

 

4.例子

<filter-mapping>
     <filter-name>testFilter</filter-name>
    <url-pattern>/test.jsp</url-pattern>
</filter-mapping>

 

<filter-mapping>
    <filter-name>testFilter</filter-name>
   <url-pattern>/index.jsp</url-pattern>
   <dispatcher>REQUEST</dispatcher>
   <dispatcher>FORWARD</dispatcher>
</filter-mapping>