JSP - 过滤器


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

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

  • 在将来自服务器的响应发送回客户端之前对其进行操作。

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

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

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

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

Servlet 过滤方法

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

编号 方法及说明
1

公共无效doFilter(ServletRequest,ServletResponse,FilterChain)

每次由于客户端请求链末端的资源而导致请求/响应对通过链时,容器都会调用此方法。

2

公共无效初始化(FilterConfig过滤器配置)

Web 容器调用此方法来向过滤器指示它正在投入使用。

3

公共无效销毁()

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-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 记录器将上述日志记录在单独的文件中。

使用多个过滤器

您的 Web 应用程序可能会为特定目的定义多个不同的过滤器。考虑一下,您定义了两个过滤器AuthenFilterLogFilter。其余过程将按照上面的说明进行保留,除非您需要创建一个不同的映射,如下所述 -

<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 中过滤器映射元素的顺序决定了 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>