部署描述文件web.xml解析(五) 声明过滤器

简介

过滤器的基本概念是拦截和修改servlet或JSP页面的输入请求和输出响应。本文将介绍如何在web.xml中配置过滤器。

过滤器实例

在一个servlet或JSP页面执行之前，第一个关联的过滤器的doFilter方法率先执行。该过滤器调用FilterChain对象doFilter方法之后，下一个过滤器将被执行。如果没有其它过滤器，就执行servlet或JSP页面。过滤器已经完全访问进入ServletRequest对象，所以他们可以查找客户端的主机名，查找进入的cookie等。为访问servlet或者JSP页面的输出，过滤器可以将响应对象封装到一个替代的对象中，如将内容输出集中到缓存中。在调用FilterChain对象的doFilter方法之后，这个过滤器可以检查缓存，并在必要时修改，然后将输出到客户端。

package coreservlets;

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;

/**
 * Simple filter that prints a report on the standard output whenever the
 * associated servlet or JSP page is accessed.
 */

public class ReportFilter implements Filter {
	public void doFilter(ServletRequest request, ServletResponse response,
			FilterChain chain) throws ServletException, IOException {
		HttpServletRequest req = (HttpServletRequest) request;
		System.out.println(req.getRemoteHost() + " tried to access "
				+ req.getRequestURL() + " on " + new Date() + ".");
		chain.doFilter(request, response);
	}

	public void init(FilterConfig config) throws ServletException {
	}

	public void destroy() {
	}
}

声明过滤器

一旦创建好了过滤器，就需要在web.xml文件中使用filter元素和filter-name(任意名)、filter-class(完全限定类名)、可选的init-param子元素来声明过滤器。

	<!-- Register the name "Reporter" for ReportFilter. -->
	<filter>
		<filter-name>Reporter</filter-name>
		<filter-class>coreservlets.ReportFilter</filter-class>
	</filter>

一旦为过滤器命名，就可以通过filter-mapping元素将它与一个或多个servlet或JSP页面相关联。此时有两个选择：
第一种，可以使用filter-name和servlet-name子元素将过滤器与一个指定的servlet名（必须在同一个web.xml文件中使用servlet元素声明）相关联。

	<!-- Apply the Reporter filter to the servlet named "PageName".
       -->
	<filter-mapping>
		<filter-name>Reporter</filter-name>
		<servlet-name>SomeServletName</servlet-name>
	</filter-mapping>

第二种，可以使用filter-name和url-pattern子元素与一组servlet，JSP页面或静态内容相管理。

	<!-- Apply the Reporter filter to the servlet named "PageName".
       -->
	<filter-mapping>
		<filter-name>Reporter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

参考资料

1.  Servlet与JSP核心编程 卷2