J2EE提供了一种特殊的Servlet,就是Filter。它不是一种单独的网络组件,因为它不产生请求和响应信息,它必须依附于其他的网络组件存在。所以我们利用它完成信息的编码转化、数据加密、身份验证、数据压缩、日志记录等很多种工作。下面我们共同看一下Filter的结构和具体的应用方法,并且结合实例进行讲解。 一、Filter的结构 我们自己编写的Filter必须要实现javax.servlet.Filter接口,这个接口只要包含了三个主要的方法: init()-初始化过滤器,它的输入参数javax.servlet.FilterConfig的一个实例,可以这里初始化过滤要使用到的FilterConfig。这个方法由Web容器自动调用。 doFilter()-进行具体的过滤操作,这个方法以javax.servlet.ServletRequest请求信息,javax.servlet.ServletResponse响应信息,javax.servlet.FilterChain过滤链。过滤链,在Web应用程序中所有的过滤器会构成一个链状,符合过滤条件的程序将会根据定义的顺序执行所有链中的过滤器。在这个方法中调用FilterChain的doFilter(javax.servlet.ServletRequest, javax.servlet.SerletResponse)方法就可以传递到链中的下一个过滤器。 destory()-销毁过滤器,可以在这里释放使用完的资源,例如设置过滤器中FilterConfig为null。 二、在Web程序中建立过滤器 1、建立实现javax.servlet.Filter接口的自定义Filter程序。下面是一个进行请求信息编码转化的Filter: import java.io.IOException; import java.util.Enumeration;
import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse;
public class EncodeFilter implements Filter{ private FilterConfig filterConfig = null; private String encoding = null;
//默认构造函数 public EncodeFilter() { }
//初始化过滤器 public void init(FilterConfig filterConfig) throws ServletException { this.filterConfig = filterConfig; this.encoding = filterConfig.getInitParameter("encoding"); }
//得到编码 private String getEncoding() { return this.encoding; }
//执行过滤操作 public void doFilter(ServletRequest request, ServletResponse response, FilterChain filterChain) throws IOException, ServletException { //设置编码格式 if(request.getCharacterEncoding() == null) { String encoding = getEncoding();
if(encoding != null) { request.setCharacterEncoding(encoding); }
//传递过滤器 filterChain.doFilter(request, response); } }
public void destroy() { filterConfig = null; encoding = null; } } 2、配置web.xml文件。要想让Filter在程序其他作用必须要在web.xml配置,上面过滤器对应配置文件: <filter> <filter-name>Set Encoding Filter</filter-name> <filter-class>cn.mblogger.mydeman.EncodeFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>GBK</param-value> </init-param> </filter> <filter-mapping> <filter-name>Set Encoding Filter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <filter>元素是配置Filter相关信息,<filter-name>:指定这个Filter的名字,可以任意指定,其实相当于对Filter的描述。<filter-class>:Filter完整的类路径(包路径.类)。<init-param>:指定Filter用到的参数的初始值,其中
<param-name>是参数名,<param-value>
是参数值。在Filter中我们可以使用FilterConfig.getInitParameter(String)获得,其中String代表参数名也就是
的值,例如在上面的Filter中获得encoding的值:filterConfig.getInitParameter("encoding"); <filter-mapping>用来指定经过该Filter的URL样式。<filter-name>是Filter的名字,这个要和相对应的<filter>中<filter-name>一致。<url-pattern>是URL的样式,它定义所有经过这个Filter的URL所应该满足的样式,例如<url-pattern>/*</url-pattern>就是指定了所有的url都会经过这个Filter。 完成了以上过程后,就定义了一个完成的Filter,我们可以添加辅助代码进行测试。 在上面我们提到了过滤链的概念,它有一个执行顺序的问题,那么这个顺序的设置也是在web.xml中完成的,其中的先后顺序指定了这个顺序。在范例中,一共包含了两个过滤器,并且包含了测试代码,我们可以通过调整两个过滤器的先后顺序,查看调整前后结果的不同。
范例程序可以在这里下载。http://www./Article/UploadFiles/200508/20050810220850674.rar
|