1. WIKI教程
2. 学习JSP
3. JSP - 写过滤器( Writing Filters)

JSP - 写过滤器( Writing Filters)

在本章中，我们将讨论JSP中的Filters。 Servlet和JSP过滤器是可用于Servlet和JSP编程的Java类，用于以下目的 -

• 在客户端访问后端资源之前拦截客户端的请求。

• 在将服务器发送回客户端之前操纵服务器的响应。

规格建议有各种类型的过滤器 -

• 验证过滤器
• 数据压缩过滤器
• 加密过滤器
• 触发资源访问事件的过滤器
• 图像转换滤镜
• 记录和审核过滤器
• MIME-TYPE链过滤器
• 标记过滤器
• 转换XML内容的XSL/T过滤器

过滤器部署在部署描述符文件web.xml ，然后映射到应用程序部署描述符中的servlet或JSP名称或URL模式。 部署描述符文件web.xml可以在《Tomcat-installation-directory》\conf目录中找到。

当JSP容器启动Web应用程序时，它会创建您在部署描述符中声明的每个过滤器的实例。 过滤器按照在部署描述符中声明的顺序执行。

Servlet过滤方法

过滤器只是一个实现javax.servlet.Filter接口的Java类。 javax.servlet.Filter接口定义了三个方法 -

S.No.	方法和描述
1	public void doFilter (ServletRequest, ServletResponse, FilterChain) 每次由于客户端请求链末端的资源而请求/响应对通过链时，容器都会调用此方法。
2	public void init(FilterConfig filterConfig) Web容器调用此方法以向过滤器指示它正在投入使用。
3	public void destroy() Web容器调用此方法以向过滤器指示它正在停止服务。

JSP过滤器示例

以下示例显示了每次访问任何JSP文件时如何打印客户端的IP地址和当前日期时间。 此示例将为您提供对JSP过滤器的基本了解，但您可以使用相同的概念编写更复杂的过滤器应用程序 -

// Import required java libraries
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// Implements Filter class
public class LogFilter implements Filter  {
   public void  init(FilterConfig config) throws ServletException {
      // Get init parameter 
      String testParam = config.getInitParameter("test-param"); 
      //Print the init parameter 
      System.out.println("Test Param: " + testParam); 
   }
   public void  doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
      throws java.io.IOException, ServletException {
      // Get the IP address of client machine.   
      String ipAddress = request.getRemoteAddr();
      // Log the IP address and current timestamp.
      System.out.println("IP "+ ipAddress + ", Time "+ new Date().toString());
      // Pass request back down the filter chain
      chain.doFilter(request,response);
   }
   public void destroy( ) {
      /* Called before the Filter instance is removed 
      from service by the web container*/
   }
}

以通常的方式编译LogFilter.java并将LogFilter.class文件放在《Tomcat-installation-directory》/webapps/ROOT/WEB-INF/classes 。

Web.xml中的JSP过滤器映射

定义过滤器，然后映射到URL或JSP文件名，其方式与定义Servlet的方式非常相似，然后映射到web.xml文件中的URL模式。 在部署描述符文件web.xml为filter标记创建以下条目

<filter>
   <filter-name>LogFilter</filter-name>
   <filter-class>LogFilter</filter-class>
   <init-param>
      <param-name>test-param</param-name>
      <param-value>Initialization Paramter</param-value>
   </init-param>
</filter>
<filter-mapping>
   <filter-name>LogFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

上面的过滤器将适用于所有servlet和JSP，因为我们在配置中指定了/* 。 如果要在少数servlet或JSP上应用过滤器，则可以指定特定的servlet或JSP路径。

现在尝试调用任何servlet或JSP，您将在Web服务器日志中看到生成的日志。 您可以使用Log4J logger将上面的日志记录在单独的文件中。

使用多个过滤器

您的Web应用程序可能会定义具有特定用途的多个不同过滤器 考虑一下，您定义了两个过滤器AuthenFilter和LogFilter 。 除了您需要创建如下所述的不同映射外，其余过程将保持如上所述 -

<filter>
   <filter-name>LogFilter</filter-name>
   <filter-class>LogFilter</filter-class>
   <init-param>
      <param-name>test-param</param-name>
      <param-value>Initialization Paramter</param-value>
   </init-param>
</filter>
<filter>
   <filter-name>AuthenFilter</filter-name>
   <filter-class>AuthenFilter</filter-class>
   <init-param>
      <param-name>test-param</param-name>
      <param-value>Initialization Paramter</param-value>
   </init-param>
</filter>
<filter-mapping>
   <filter-name>LogFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
   <filter-name>AuthenFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

筛选应用程序订单

web.xml中filter-mapping元素的顺序决定了Web容器将过滤器应用于servlet或JSP的顺序。 要反转过滤器的顺序，您只需要反转web.xml文件中的过滤器映射元素。

例如，上面的示例将首先应用LogFilter然后将AuthenFilter应用于任何servlet或JSP; 以下示例将颠倒顺序 -

<filter-mapping>
   <filter-name>AuthenFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
   <filter-name>LogFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>