在本章中,我們將討論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
介面定義了三種方法 -
編號 | 方法 | 描述 |
---|---|---|
1 | public void doFilter (ServletRequest, ServletResponse, FilterChain) |
由於是在鏈末端的客戶端請求,所以每當通過鏈路傳遞請求/回應對時,容器就會調用此方法。 |
2 | public void init(FilterConfig filterConfig) |
該方法由Web容器調用,向篩檢程式指示它正在投入使用。 |
3 | public void destroy() |
該方法由Web容器調用以向篩檢程式指示它正在停用服務。 |
JSP篩檢程式示例
以下示例顯示了如何在客戶訪問任何JSP檔時,列印客戶端的IP地址和當前日期時間。 這個例子將讓您對JSP篩檢程式有一個基本的瞭解,基於這個示例,您可以使用相同的概念編寫更複雜的篩檢程式應用程式。
打開Eclipse,創建一個動態Web專案:Filter,其專案的結構如下所示 -
下麵來看看這個應用的具體實現。
檔:LogFilter.java
package com.zaixian;
//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>