java框架010——Filter(过滤器)

一、Filter(过滤器)简介

1、Filter 过滤器它是JavaWeb的三大组件之一。三大组件分别是: Servlet 程序、Listener 监听器、Filter 过滤器。
2、Filter 过滤器它是JavaEE的规范。也就是接口。
3、Filter 过滤器它的作用是:拦截请求，过滤响应。
4、在 Servlet API 中定义了三个接口类来供开发人员编写 Filter 程序：Filter, FilterChain, FilterConfig。
5、Filter 程序是一个实现了 Filter 接口的 Java 类，与 Servlet 程序相似，它由 Servlet 容器进行调用和执行。
6、Filter 程序需要在 web.xml 文件中进行注册和设置它所能拦截的资源：Filter 程序可以拦截 Jsp, Servlet, 静态图片文件和静态 html 文件。

拦截请求常见的应用场景有:
1、权限检查
2、日记操作
3、事务管理
… …等等

Filter 的过滤过程

二、Filter 的基本工作原理

1、当在 web.xml 中注册了一个 Filter 来对某个 Servlet 程序进行拦截处理时，这个 Filter 就成了 Servlet 容器与该 Servlet 程序的通信线路上的一道关卡，该 Filter 可以对 Servlet 容器发送给 Servlet 程序的请求和 Servlet 程序回送给 Servlet 容器的相应进行拦截，可以决定是否将请求继续传递给 Servlet 程序，以及对请求和相应信息是否进行修改
2、在一个 web 应用程序中可以注册多个 Filter 程序，每个 Filter 程序都可以对一个或一组 Servlet 程序进行拦截。
3、若有多个 Filter 程序对某个 Servlet 程序的访问过程进行拦截，当针对该 Servlet 的访问请求到达时，web 容器将把这多个 Filter 程序组合成一个 Filter 链(过滤器链)。Filter 链中各个 Filter 的拦截顺序与它们在应用程序的 web.xml 中映射的顺序一致

三、Filter的生命周期

Filter的生命周期包含几个方法
1、构造器方法
2、init 初始化方法
第1，2步，在web工程启动的时候执行(Filter 已经创建)
3、doFilter 过滤方法
第3步，每次拦截到请求，就会执行
4、destroy销毁
第4步，停止web工程的时候，就会执行(停止web工程，也会销毁Filter 过滤器)

四、过滤器的部署

在实现一个过滤器后，需要在 web.xml 中进行注册和设置它所能拦截的资源。这可以通过<filter>和<filter-mapping>元素来完成的。

五、<filter> 元素（注册Filter）

Servlet容器对部署描述符中声明的每一个过滤器，只创建一个实例。与Servlet类似，容器将在同一个过滤器实例上运行多个线程来同时为多个请求服务，因此，开发过滤器时，也要注意线程安全的问题。

<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

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

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

在同一个 web.xml 文件中可以为同一个 Filter 设置多个映射。若一个 Filter 链中多次出现了同一个 Filter 程序，这个 Filter 程序的拦截处理过程将被多次执行

七、实例解析

Filter过滤器的使用步骤:
1、编写一个类去实现Filter接口
2、实现过滤方法doFilter()
3、到web.xml中去配置Filter的拦截路径

配置拦截


不同拦截结果