chain.doFilter(request, response);
    }

												
										

隨后，我們粗略地執(zhí)行該過濾器中的 init() 和 destroy() 方法：

												
														   public void destroy() {
    }
   
 public void init(FilterConfig filterConfig) {
    this.filterConfig = filterConfig;
    }
}

												
										

回頁首

測(cè)試 IEFilter

假設(shè)您安裝了 Tomcat 4 beta 3 （或更新版本）并能使用，請(qǐng)按下列步驟啟動(dòng) IEFilter 并運(yùn)行：

1. 在 $TOMCAT_HOME/conf 目錄下的 server.xml 文件里創(chuàng)建一個(gè)新的應(yīng)用程序上下文，如下所示：

   <!-- Tomcat Examples Context --> <Context path="/examples" docBase="examples" debug="0" reloadable="true"> ... </Context> <Context path="/devworks" docBase="devworks" debug="0" reloadable="true"> <Logger className="org.apache.catalina.logger.FileLogger" prefix="localhost_devworks_log." suffix=".txt" timestamp="true"/> </Context>

   
   
   

2. 編輯代碼區(qū)的 devworks/WEB-INF 下的 web.xml 文件，以包括下列的過濾器定義及映射：

   <web-app> <filter> <filter-name>IE Filter</filter-name> <filter-class>com.ibm.devworks.filters.IEFilter</filter-class> </filter> <filter-mapping> <filter-name>IE Filter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

   
   
   

3. 在 $TOMCAT_HOME/webapps 目錄下創(chuàng)建一個(gè)叫做 devworks 的新目錄，并將所有 devworks 目錄下的東西（包括所有子目錄）從源代碼區(qū)復(fù)制到該位置。現(xiàn)在就準(zhǔn)備好啟動(dòng) Tomcat 4 了。

4. 使用下面的 URL 來訪問一個(gè)簡(jiǎn)單的 index.html 頁面： http://<hostname>/devworks/index.html

   如果您使用的是 Internet Explorer，就能看見如圖 2 所示的定制的“拒絕訪問”信息。

   
   圖 2. IEFilter 在遇到 Internet Explorer 的運(yùn)行效果
   
   

   如果您使用的是 Netscape，那就能看見如圖 3 所示的確切的 HTML 頁面。

   
   圖 3. IEFilter 用 Netscape 瀏覽器的瀏覽效果
   
   

回頁首

編寫轉(zhuǎn)換資源的過濾器

現(xiàn)在該來試一下更復(fù)雜的過濾器了。該過濾器：

• 從過濾器定義的實(shí)例初始化參數(shù)中讀取一組 "search" 及 "replace" 文本
• 過濾被訪問的 URL，將出現(xiàn)的第一個(gè) "search" 文本替代為 "replace" 文本

在我們深入研究這個(gè)過濾器的過程中，您將對(duì)內(nèi)容轉(zhuǎn)換/替代過濾器的架構(gòu)加深了解。相同的架構(gòu)能用于任何加密、壓縮及轉(zhuǎn)換（如由 XSLT 轉(zhuǎn)換來的 SML）過濾器。

核心機(jī)密是在鏈?zhǔn)教幚淼倪^程中傳遞一個(gè)定制的響應(yīng)對(duì)象的包裝版本。該定制的包裝響應(yīng)對(duì)象須隱藏原響應(yīng)對(duì)象（從而對(duì)其實(shí)現(xiàn) 包裝），并提供一個(gè)定制的流以供后續(xù)處理器寫入。如果工作（文本替換、轉(zhuǎn)換、壓縮、加密…等）能迅速完成，定制流的執(zhí)行就能中止后續(xù)記錄并完成需要的工作。然后定制的流就會(huì)將經(jīng)轉(zhuǎn)換的數(shù)據(jù)寫入包裝的響應(yīng)對(duì)象（也就是說，簡(jiǎn)單的字符替換加密）。如果工作無法迅速完成，定制的流就需等待，直到后續(xù)處理器完成對(duì)流的寫入（也就是說，當(dāng)其關(guān)閉或刷新流時(shí)）。然后它才完成轉(zhuǎn)換工作，并將經(jīng)轉(zhuǎn)換的輸出結(jié)果寫入“真正的”響應(yīng)中。

在我們的過濾器（ ReplaceTextFilter ）中，定制的包裝響應(yīng)對(duì)象叫作 ReplaceTextWrapper 。定制流的執(zhí)行叫做 ReplaceTextStream 。您能在 com.ibm.devworks.filters 包中的 ReplaceTextFilter.java 文件里找到源代碼。（請(qǐng)參閱 參考資料 ）。現(xiàn)在就讓我們來研究一下源代碼吧。

														
																class ReplaceTextStream extends ServletOutputStream {
     private OutputStream intStream;
     private ByteArrayOutputStream baStream;
     private boolean closed = false;
     
     private String origText;
     private String newText;
     
     public ReplaceTextStream(OutputStream outStream, 
                              String searchText, 
                              String replaceText) {
          intStream = outStream;
          baStream = new ByteArrayOutputStream();
          origText = searchText;
          newText = replaceText;
     }

														
												

這是定制的輸出流代碼。 intStream 變量包含了對(duì)來自響應(yīng)對(duì)象的實(shí)際流的引用。 baStream 是我們輸出流的緩沖版本，后續(xù)處理器就寫入這里。 closed 標(biāo)記標(biāo)明了 close() 是否在此實(shí)例流中被調(diào)用。構(gòu)造器將來自響應(yīng)對(duì)象的流引用存儲(chǔ)起來并創(chuàng)建了緩沖流。它還將文本字符串存儲(chǔ)起來供以后的替代操作使用。

														
																   public void write(int i) throws java.io.IOException {
         baStream.write(i);
     }

														
												

我們須提供自己的源于 ServletOutputStream 的 write() 方法。在此，我們當(dāng)然是寫入緩沖流。所有來自后續(xù)處理器的更高級(jí)輸出方法都將以最低級(jí)別使用該方法，以保證所有的寫入都指向緩沖流。

														
																   public void close() throws java.io.IOException {
          if (!closed) {
            processStream();
            intStream.close();
            closed = true;
          }
       }
    
    public void flush() throws java.io.IOException {
        if (baStream.size() != 0) {
             if (! closed) {
              processStream();           // need to synchronize the flush!
              baStream = new ByteArrayOutputStream();
              }
           }
        }

														
												

close() 及 flush() 方法是我們完成轉(zhuǎn)換的語句。根據(jù)后續(xù)處理器不同，其中的一個(gè)或兩個(gè)程序都有可能被調(diào)用。我們使用布爾型的 closed 標(biāo)識(shí)來避免異常情況。請(qǐng)注意，我們將實(shí)際的替代工作委托給了 processStream() 方法。

														
																   public void processStream() throws java.io.IOException {
         intStream.write(replaceContent(baStream.toByteArray()));
         intStream.flush();
     }

														
												

processStream() 方法將經(jīng)轉(zhuǎn)換的輸出結(jié)果從 baStream 寫入其已經(jīng)配有的 intStream 中去。轉(zhuǎn)換工作獨(dú)立于 replaceContent() 方法。

														
																 public byte []  replaceContent(byte [] inBytes) {
          String retVal ="";
          String firstPart="";
        
          String tpString = new String(inBytes);
          String srchString = (new String(inBytes)).toLowerCase();
          int endBody = srchString.indexOf(origText);
 
          if (endBody != -1) {
               firstPart = tpString.substring(0, endBody);
           retVal = firstPart + newText + 
                  tpString.substring(endBody + origText.length()); 
     
            } else {
              retVal=tpString;
            }
                       
          return retVal.getBytes();
    }
}

														
												

replaceContent() 是發(fā)生搜索與替換的語句。它將一個(gè)字節(jié)數(shù)組作為輸入并返回一個(gè)字節(jié)數(shù)組，創(chuàng)建一個(gè)原始的概念接口。事實(shí)上，我們能通過替換該方法中的邏輯部分來完成任何形式的轉(zhuǎn)換。這里，我們進(jìn)行非常簡(jiǎn)單的文本替換。

														
																class ReplaceTextWrapper extends HttpServletResponseWrapper {
    private PrintWriter tpWriter; 
    private ReplaceTextStream tpStream;
    public ReplaceTextWrapper(ServletResponse inResp, String searchText,
                              String replaceText) 
                              throws java.io.IOException { 
         super((HttpServletResponse) inResp);
         tpStream = new ReplaceTextStream(inResp.getOutputStream(), 
                                          searchText, 
                                          replaceText);
         tpWriter = new PrintWriter(tpStream);
    }
    public ServletOutputStream getOutputStream() throws java.io.IOException {
            return tpStream;
     }
    public PrintWriter getWriter() throws java.io.IOException {
            return tpWriter;
     }
}

														
												

我們定制的包裝響應(yīng)能方便地從幫助類 HttpServletResponseWrapper 中導(dǎo)出。這一類粗略地執(zhí)行許多方法，允許我們簡(jiǎn)單地覆蓋 getOutputStream() 方法以及 getWriter() 方法，提供了定制輸出流的實(shí)例。

														
																public final class ReplaceTextFilter implements Filter {
    private FilterConfig filterConfig = null;
    private String searchText = ".";
    private String replaceText = ".";
    public void doFilter(ServletRequest request, ServletResponse response,
                         FilterChain chain)
    throws IOException, ServletException {
     
      ReplaceTextWrapper myWrappedResp = new ReplaceTextWrapper( response, 
        searchText, replaceText);
         chain.doFilter(request,  myWrappedResp);
         myWrappedResp.getOutputStream().close();  
    }
    public void destroy() {
    }

														
												

最后，還有過濾器本身。它所做的不過是使用 FilterChain 為遞交響應(yīng)后續(xù)創(chuàng)建一個(gè)定制的包裝響應(yīng)實(shí)例，如下所示：

														
																   public void init(FilterConfig filterConfig) {
      String tpString;
      if (( tpString = filterConfig.getInitParameter("search") ) != null)
           searchText = tpString;
      if (( tpString = filterConfig.getInitParameter("replace") ) != null)
           replaceText = tpString;
    this.filterConfig = filterConfig;
    }
}

														
												

在 init 方法中，我們?nèi)』亓诉^濾器定義中指定的初始參數(shù)。 filterConfig 對(duì)象中的 getInitParameter() 方法便于用來實(shí)現(xiàn)這個(gè)目的。

回頁首

測(cè)試 ReplaceTextFilter

假如您使用先前提及的步驟測(cè)試了 IEFilter ，并將所有文件復(fù)制到了 $TOMCAT/webapps/devworks 下，您就能用以下的步驟來測(cè)試 ReplaceTextFilter ：

1. 編輯 $TOMCAT/wepapps/devworks/WEB-INF 目錄下的 web.xml 文件，以包含下列過濾器的定義及映射：

   <web-app> <filter> <filter-name>Replace Text Filter</filter-name> <filter-class>com.ibm.devworks.filters.ReplaceTextFilter</filter-class> <init-param> <param-name>search</param-name> <param-value>cannot</param-value> </init-param> <init-param> <param-name>replace</param-name> <param-value>must not</param-value> </init-param> </filter> <filter-mapping> <filter-name>Replace Text Filter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

   
   
   

2. 重新啟動(dòng) Tomcat。

3. 現(xiàn)在，請(qǐng)用下面的 URL 來訪問 index.html 頁面： http://<host name>:8080/devworks/index.html

請(qǐng)注意， ReplaceTextFilter 是如何迅速地將 cannot變?yōu)?must not 的。想確信過濾使用了所有資源，您可以嘗試編寫輸出結(jié)果含有字符串 cannot的 JSP 頁或 servlet。

回頁首

過濾器鏈排列順序的重要性

過濾器鏈?zhǔn)脚帕械捻樞蛉Q于 web.xml 描述信息內(nèi) <filter-mapping> 語句的順序。在大多數(shù)情況下，過濾器鏈?zhǔn)脚帕械捻樞蚴欠浅Ｖ匾摹Ｒ簿褪钦f，在應(yīng)用 A 過濾器前使用 B 過濾器與在使用 B 過濾器前使用 A 過濾器所得到的結(jié)果是完全不同的。如果一個(gè)應(yīng)用程序中使用了一個(gè)以上的過濾器，那么在寫入 <filter-mapping> 語句的時(shí)候要小心。

我們能輕易地通過排列 web.xml 文件中 <filter-mapping> 的順序看到這一效果：

														
																<web-app>
<filter-mapping>
        <filter-name>IE Filter</filter-name>
    <url-pattern>/*</url-pattern>
    </filter-mapping>
<filter-mapping>
        <filter-name>Replace Text Filter</filter-name>
    <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

														
												

現(xiàn)在，用 Internet Explorer 載入 index.html 頁。您能看到由于 IE Filter 處于過濾器鏈中的第一位，所以 Replace Text Filter 沒有機(jī)會(huì)執(zhí)行。因此，輸出的信息是 "Sorry, page cannot be displayed!"

現(xiàn)在，將 <filter-mapping> 標(biāo)記的順序顛倒過來，變?yōu)椋?

														
																<web-app>
<filter-mapping>
        <filter-name>Replace Text Filter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
        <filter-name>IE Filter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>

														
												

再次用 Internet Explorer 載入 index.html 頁面。這次， Replace Text Filter 先執(zhí)行，將包裝的響應(yīng)對(duì)象提供給 IE Filter 。在 IE Filter 寫入了其定制的響應(yīng)后，專用的響應(yīng)對(duì)象在輸出結(jié)果到達(dá)最終用戶處以前完成轉(zhuǎn)換。故而，我們看到了這條信息：Sorry, page must not be displayed!

回頁首

在應(yīng)用程序中使用過濾器

寫這篇文章的時(shí)候， Tomcat 4 正處于 beta 周期的后期，正式發(fā)行的日子已為期不遠(yuǎn)。主要的 J2EE 容器廠商都準(zhǔn)備好了將 Servlet 2.3 規(guī)范整合到其產(chǎn)品中去。對(duì)于 Servlet 2.3 過濾器如何工作有一個(gè)基本的了解有助于您在設(shè)計(jì)及編寫基于 J2EE 的應(yīng)用程序時(shí)往自己的工具庫(kù)中再加入一件多功能的工具。

回頁首

參考資料

• 您可以參閱本文在 developerWorks 全球站點(diǎn)上的 英文原文 .
  
  
• 下載本文中用到的源代碼 。
  
  
  
• Tomcat 主頁 提供了關(guān)于 Tomcat 所有可獲得的發(fā)行版本信息。請(qǐng)定期查閱該頁上的文件鏈接以了解有關(guān)過濾的文檔更新信息。
  
  
  
• 請(qǐng)閱讀正式規(guī)范， Java Servlet 2.3 ，以了解關(guān)于過濾的詳細(xì)信息。
  
  
  
• 請(qǐng)加入官方的 Servlet 興趣郵件列表 來討論 Servlet 2.3 過濾的復(fù)雜問題。
  
  
  
• 更深入地了解 WebSphere 3.5 是如何處理 servlet 過濾的 。
  
  
  
• 該 IBM 紅皮書提供了關(guān)于 利用 servlet、JSP 頁和 EJB 組件的 Web 應(yīng)用程序設(shè)計(jì) 。
  
  
  
• "Developing JSP Tag Libraries with Apache Tomcat 4.0 and VisualAge for Java" 向您展示了如何將面向 Java 的 VisualAge 附加到已安裝的 Apache Tomcat 4.0 服務(wù)器上，以及如何在標(biāo)記代碼中設(shè)置斷點(diǎn)。
  
  
  
• 在 專業(yè) JSP 第 2 版 （Wrox 出版社，2000 年 5 月）中，有許多過濾器編寫示例，包括一個(gè)壓縮過濾器和一個(gè) XSLT 轉(zhuǎn)換過濾器。
  
  
  
• 對(duì) servlet 編程感興趣嗎？來試試該免費(fèi)的 dW 專用教程，它描述了 利用 servlet 和 JSP 技術(shù)建立因特網(wǎng)應(yīng)用程序的技巧 （developerWorks，2000 年 12 月）。
  
  
  
• 了解一下 JSP 技術(shù)為滿足開發(fā)人員的需要而在不斷改變 （developerWorks，2001 年 6 月）。
  
  
  
• 在 developerWorks Java 技術(shù)專區(qū) 中尋找更多的 Java 參考資料。