JSP過濾器

在本章中，我們將討論JSP中的過濾器。Servlet和JSP過濾器是可以在Servlet和JSP編程中用於以下目的的Java類：

在客戶端訪問後端的資源之前攔截請求。
在服務器發送回客戶端之前操縱響應。

有各種類型的過濾器由規格建議 -

驗證過濾器
數據壓縮過濾器
加密過濾器
觸發資源訪問事件的過濾器
圖像轉換過濾器
記錄和審覈過濾器
MIME類型鏈式過濾器
令牌過濾器
轉換XML內容的XSL/T過濾器

過濾器部署在部署描述符文件web.xml中，然後映射到應用程序部署描述符中的servlet或JSP名稱或URL模式。部署描述符文件web.xml可以在<Tomcat-installation-directory>\conf目錄中或在項目的WEB-INF目錄下找到。

Servlet過濾器方法

過濾器只是一個實現javax.servlet.Filter接口的Java類。javax.servlet.Filter接口定義了三種方法 -

編號

方法

描述

public void doFilter (ServletRequest, ServletResponse, FilterChain)

由於是在鏈末端的客戶端請求，所以每當通過鏈路傳遞請求/響應對時，容器就會調用此方法。

public void init(FilterConfig filterConfig)

該方法由Web容器調用，向過濾器指示它正在投入使用。

public void destroy()

該方法由Web容器調用以向過濾器指示它正在停用服務。

JSP過濾器示例

以下示例顯示瞭如何在客戶訪問任何JSP文件時，打印客戶端的IP地址和當前日期時間。這個例子將讓您對JSP過濾器有一個基本的瞭解，基於這個示例，您可以使用相同的概念編寫更復雜的過濾器應用程序。

打開Eclipse，創建一個動態Web項目：Filter，其項目的結構如下所示 -

JSP過濾器

下面來看看這個應用的具體實現。

文件：LogFilter.java

package com.yiibai;

//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記錄器記錄以上日誌在單獨的文件中。

JSP過濾器

在終端輸出結果如下 -

......
信息: 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>

JSP教程

高級部分

Servlet過濾器方法

JSP過濾器示例