过滤器(filter)在web 中的应用

 过滤器（Filter）在Web开发中的应用：

 

Filter是从Servlet2.3规范开始新增的功能，并在Servlet2.4规范中得到增强。以下是

Filter在Web开发中的应用。

 

过滤器概述：

过滤器就是在源数据和目的数据之间起过滤作用的中间组件。对Web应用来说，过滤器

是一个驻留在服务器端的Web组件，它可以截取客户端和资源之间的请求与响应信息，

并对这些信息进行过滤。

 

当Web容器接受到一个对资源的请求时，它将判断是否有过滤器与这个资源相关联。如

果有，那么容器将把请求交给过滤器进行处理。在过滤器中，你可以改变请求的内容，

或者重新设置请求的报头信息，然后再将请求发送给目标资源。当目标资源对请求作出

响应时候，容器同样会将响应先转发给过滤器，再过滤器中，你可以对响应的内容进行

转换，然后再将响应发送到客户端。

 

过滤器在Web开发中的一些主要应用：

 

·对用户请求进行统一认证。

 

·对用户的访问请求进行记录和审核。

 

·对用户发送的数据进行过滤或替换。

 

·转换图象格式。

 

·对响应内容进行压缩，减少传输量。

 

·对请求或响应进行加解密处理

 

·触发资源访问是事件。

 

·对XML的输出应用XSLT。

 

Filter API ：

 

与过滤器开发相关的接口与类都包含在javax.serlvet和javax.servlet.http包中，主

要有下面的接口和类。

 

·javax.servlet.Filter接口

 

·javax.servlet.FilterConfig接口

 

·javax.servlet.FilterChain接口

 

·javax.servlet.ServletRequestWrapper类

 

·javax.servlet.ServletResponseWrapper类

 

·javax.servlet.http.HttpServletRequestWrapper类

 

·javax.servlet.http.HttpServletResponseWrapper类

 

Filter接口：

 

开发过滤器要实现javax.servlet.Filter接口，与开发servlet要实现

javax.servlet.Servlet接口类似。提供了一个公开的不带参数的构造方法。在Filter

接口中，定义了下面的三个方法：

 

·public void init(FilterConfig filterConfig)throws ServletException

 

Web容器调用该方法该方法来初始化过滤器。容器在调用该方法时，向过滤器传递

FIlterConfig对象，FilterConfig的用法和ServletConfig（参见以前相关内容）类似

。利用FilterConfig对象可以得到ServletContext对象，以及部署描述符中配置的过滤

器的初始化参数。在这个方法中，可以抛出ServletException异常，通知容器该过滤器

不能正常工作。

 

·public void doFilter(ServletRequest request,ServletResponse

response,FilterChain chain)throws java.io.IOException,ServletException

 

doFilter()方法类似于Servlet接口的service()方法。当客户端请求目标资源的时候，

容器就会调用与这个目标资源相关联的过滤器的doFilter()方法。在特定的操作完成后

，可以调用chain.doFilter(request,response)将请求传给下一个过滤器（或目标资源

），也可以直接向客户端返回响应信息，或者利用RequestDispatcher的forward()和

include()方法，以及HttpServletResponse的sendRedirect()方法将请求转向到其他资

源。需要注意的是，这个方法的请求和响应参数的类型是ServletRequest和

ServletResponse，也就是说，过滤器的使用并不依赖于具体的协议。

 

·public void destroy()

 

Web容器调用该方法指示过滤器的生命周期结束。在这个方法中，可以释放过滤器使用

的资源。

与开发Servlet不同的是，Filter接口并没有相应的实现类可供继承，要开发过滤器，

只能直接实现Filter接口。

 

FilterConfig接口：

javax.servlet.FilterConfig接口类似于javax.servlet.ServletConfig接口，用于在

过滤器初始化时，向其传递信息。FilterConfig接口有容器实现，容器将其作为参数传

入过滤器对象的init()方法中。在FilterConfig接口，定义了4个方法：

 

·public java.lang.String getFilterName()

 

得到描述符中指定的过滤器的名字。

 

·public java.lang.String getInitParameter(java.lang.String name)

  返回在部署描述中指定的名字为name的初始化参数的值。如果不存在返回null.

 

·public java.util.Enumeration getInitParameterNames()

  返回过滤器的所有初始化参数的名字的枚举集合。

 

·public ServletContext getServletContext()

  返回Servlet上下文对象的引用。

 

 

 

FilterChain接口：

 

FilterChain接口由容器实现，容器将其实例作为参数传入过滤器对象的doFilter()方

法中。过滤器对象使用FilterChain对象调用过滤器链中的下一个过滤器，如果该过滤

器是链中最后一个过滤器，那么将调用目标资源。FilterChain接口只有一个方法，如

下：

 

·public void doFilter(ServletRequest request,ServletResponse response)

throws java.io.IOException

 

调用该方法将使过滤器链中的下一个过滤器被调用。如果是最后一个过滤器，会调用目

标资源。

 

过滤器的部署：

 

在实现一个过滤器后，需要在部署描述符中对过滤器进行配置，这是通过<filter>和

<filter-mapping>元素来完成的。

<filter>元素用于在Web应用程序中声明一个过滤器。

在<filter>元素内，<description>、<display-name>、<icon>元素和以往servlet的配

置中的相同。<filter-name>用于为过滤器指定一个名字，该元素的内容不能为空。

<filter-class>元素用于指定过滤器的完整的限定类名。<init-param>元素用于为过滤

器指定初始化参数，它的子元素<param-name>指定参数的名字，<param-value>指定参

数的值。在过滤器中，可以使用FilterConfig接口对象来访问初始化参数。

 

 

 

下面是<filte>元素的一个小例子：

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

 

Servlet容器对部署描述符中声明的每一个过滤器，只创建一个实例。与Servlet类似，

容器将在同一个过滤器实例上运行多个线程来同时为多个请求服务，因此，开发过滤器

时，也要注意线程安全的问题。

 

<filter-mapping>元素用于指定过滤器关联的url样式或者Servlet。

其中<filter-name>子元素的值必须是在<filter>元素中声明过的过滤器的名字。<url-pattern>元素和<servlet-name>元素可以选择一个；<url-pattern>元素指定过滤器关联的URL样式；<servlet-name>元素指定过滤器对应的Servlet。用户在访问<url-pattern>元素指定的URL上的资源或<servlet-name>元素指定的Servlet时，该过滤器才会被容器调用。<filter-mapping>元素还可以包含0到4个<dispatcher>，指定过滤器对应的请求方式，可以是REQUEST,INCLUDE,FORWARD和ERROR之一，默认REQUEST.

 

·REQUEST
  当用户直接访问也面时，Web容器将会调用过滤器。如果目标资源是通过RequestDispatcher的include()或forward()方法访问时，那么该过滤器就不会被调用。

 

·INCLUDE
  如果目标资源是通过RequestDispatcher的include()方法访问时，那么该过滤器将被调用。除此之外，该过滤器不会被调用。

 

·FORWARD
  如果目标资源是通过RequestDispatcher的forward()方法访问时，那么该过滤器将被调用，除此之外，该过滤器不会被调用。

 

·ERROR
  如果目标资源是通过声明式异常处理机制调用时，那么该过滤器将被调用。除此之外，过滤器不会被调用。

例子：

<filter-mapping>
 <filter-name>testFilter</filter-name>
 <url-pattern>/test.jsp</url-pattern>
</filter-mapping>
当用户访问test.jsp页面时，容器就会调用testFilter过滤器。

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

当用户直接访问index.jsp页面，或者通过RequestDispatcher的forward()方法访问时，容器就会调用testFilter过滤器。