在本章中,我们将讨论JSP中的过滤器。Servlet和JSP过滤器是可以在Servlet和JSP编程中用于以下目的的Java类:
有各种类型的过滤器由规格建议 -
XSL/T
过滤器过滤器部署在部署描述符文件web.xml中,然后映射到应用程序部署描述符中的servlet或JSP名称或URL模式。部署描述符文件web.xml可以在<Tomcat-installation-directory>\conf
目录中或在项目的WEB-INF目录下找到。
过滤器只是一个实现javax.servlet.Filter
接口的Java类。javax.servlet.Filter
接口定义了三种方法 -
编号 | 方法 | 描述 |
---|---|---|
1 | public void doFilter (ServletRequest, ServletResponse, FilterChain) |
由于是在链末端的客户端请求,所以每当通过链路传递请求/响应对时,容器就会调用此方法。 |
2 | public void init(FilterConfig filterConfig) |
该方法由Web容器调用,向过滤器指示它正在投入使用。 |
3 | public void destroy() |
该方法由Web容器调用以向过滤器指示它正在停用服务。 |
以下示例显示了如何在客户访问任何JSP文件时,打印客户端的IP地址和当前日期时间。 这个例子将让您对JSP过滤器有一个基本的了解,基于这个示例,您可以使用相同的概念编写更复杂的过滤器应用程序。
打开Eclipse,创建一个动态Web项目:Filter,其项目的结构如下所示 -
下面来看看这个应用的具体实现。
文件:LogFilter.java
package com.zyiz; //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 */ } }
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记录器记录以上日志在单独的文件中。
在终端输出结果如下 -
...... 信息: Starting Servlet Engine: Apache Tomcat/8.5.23 十月 20, 2017 2:22:55 上午 org.apache.catalina.util.SessionIdGeneratorBase createSecureRandom 警告: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [110] milliseconds. Test Param: Initialization Paramter 十月 20, 2017 2:22:55 上午 org.apache.coyote.AbstractProtocol start 信息: Starting ProtocolHandler ["http-nio-8080"] 十月 20, 2017 2:22:55 上午 org.apache.coyote.AbstractProtocol start 信息: Starting ProtocolHandler ["ajp-nio-8009"] 十月 20, 2017 2:22:55 上午 org.apache.catalina.startup.Catalina start 信息: Server startup in 717 ms IP 0:0:0:0:0:0:0:1, Time Fri Oct 20 02:22:57 BOT 2017
使用多个过滤器
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中的过滤器映射元素的顺序确定了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>