Servlet 編寫(xiě)過(guò)濾器

Servlet 過(guò)濾器是可用于 Servlet 編程的 Java 類(lèi)，有以下目的：

• 在客戶(hù)端的請(qǐng)求訪(fǎng)問(wèn)后端資源之前，攔截這些請(qǐng)求。

• 在服務(wù)器的響應(yīng)發(fā)送回客戶(hù)端之前，處理這些響應(yīng)。

根據(jù)規(guī)范建議的各種類(lèi)型的過(guò)濾器：

• 身份驗(yàn)證過(guò)濾器（Authentication Filters）。

• 數(shù)據(jù)壓縮過(guò)濾器（Data compression Filters）。

• 加密過(guò)濾器（Encryption Filters）。

• 觸發(fā)資源訪(fǎng)問(wèn)事件過(guò)濾器。

• 圖像轉(zhuǎn)換過(guò)濾器（Image Conversion Filters）。

• 日志記錄和審核過(guò)濾器（Logging and Auditing Filters）。

• MIME-TYPE 鏈過(guò)濾器（MIME-TYPE Chain Filters）。

• 標(biāo)記化過(guò)濾器（Tokenizing Filters）。

• XSL/T 過(guò)濾器（XSL/T Filters），轉(zhuǎn)換 XML 內(nèi)容。

過(guò)濾器被部署在部署描述符文件 web.xml 中，然后映射到您的應(yīng)用程序的部署描述符中的 Servlet 名稱(chēng)或 URL 模式。

當(dāng) Web 容器啟動(dòng) Web 應(yīng)用程序時(shí)，它會(huì)為您在部署描述符中聲明的每一個(gè)過(guò)濾器創(chuàng)建一個(gè)實(shí)例。該過(guò)濾器執(zhí)行的順序是按它們?cè)诓渴鹈枋龇新暶鞯捻樞颉?/p>

Servlet 過(guò)濾器方法

過(guò)濾器是一個(gè)實(shí)現(xiàn)了 javax.servlet.Filter 接口的 Java 類(lèi)。javax.servlet.Filter 接口定義了三個(gè)方法：

Servlet 過(guò)濾器實(shí)例

以下是 Servlet 過(guò)濾器的實(shí)例，將輸出客戶(hù)端的 IP 地址和當(dāng)前的日期時(shí)間。本實(shí)例讓您對(duì) Servlet 過(guò)濾器有基本的了解，您可以使用相同的概念編寫(xiě)更復(fù)雜的過(guò)濾器應(yīng)用程序：

// 導(dǎo)入必需的 java 庫(kù)
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;

// 實(shí)現(xiàn) Filter 類(lèi)
public class LogFilter implements Filter  {
   public void  init(FilterConfig config) 
                         throws ServletException{
      // 獲取初始化參數(shù)
      String testParam = config.getInitParameter("test-param"); 

      // 輸出初始化參數(shù)
      System.out.println("Test Param: " + testParam); 
   }
   public void  doFilter(ServletRequest request, 
                 ServletResponse response,
                 FilterChain chain) 
                 throws java.io.IOException, ServletException {

      // 獲取客戶(hù)機(jī)的 IP 地址   
      String ipAddress = request.getRemoteAddr();

      // 記錄 IP 地址和當(dāng)前時(shí)間戳
      System.out.println("IP "+ ipAddress + ", Time "
                                       + new Date().toString());

      // 把請(qǐng)求傳回過(guò)濾鏈
      chain.doFilter(request,response);
   }
   public void destroy( ){
      /* 在 Filter 實(shí)例被 Web 容器從服務(wù)移除之前調(diào)用 */
   }
}

以通常的方式編譯 LogFilter.java，把您的類(lèi)文件放入 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 中。

Web.xml 中的 Servlet 過(guò)濾器映射（Servlet Filter Mapping）

定義過(guò)濾器，然后映射到一個(gè) URL 或 Servlet，這與定義 Servlet，然后映射到一個(gè) URL 模式方式大致相同。在部署描述符文件 web.xml 中為 filter 標(biāo)簽創(chuàng)建下面的條目：

<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>

上述過(guò)濾器適用于所有的 Servlet，因?yàn)槲覀冊(cè)谂渲弥兄付?/* 。如果您只想在少數(shù)的 Servlet 上應(yīng)用過(guò)濾器，您可以指定一個(gè)特定的 Servlet 路徑。

現(xiàn)在試著以常用的方式調(diào)用任何 Servlet，您將會(huì)看到在 Web 服務(wù)器中生成的日志。您也可以使用 Log4J 記錄器來(lái)把上面的日志記錄到一個(gè)單獨(dú)的文件中。

使用多個(gè)過(guò)濾器

Web 應(yīng)用程序可以根據(jù)特定的目的定義若干個(gè)不同的過(guò)濾器。假設(shè)您定義了兩個(gè)過(guò)濾器 AuthenFilter 和 LogFilter。您需要?jiǎng)?chuàng)建一個(gè)如下所述的不同的映射，其余的處理與上述所講解的大致相同：

<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>

過(guò)濾器的應(yīng)用順序

web.xml 中的 filter-mapping 元素的順序決定了 Web 容器應(yīng)用過(guò)濾器到 Servlet 的順序。若要反轉(zhuǎn)過(guò)濾器的順序，您只需要在 web.xml 文件中反轉(zhuǎn) filter-mapping 元素即可。

例如，上面的實(shí)例將先應(yīng)用 LogFilter，然后再應(yīng)用 AuthenFilter，但是下面的實(shí)例將顛倒這個(gè)順序：

<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>