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è)簡單的 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ì)象（也就是說，簡單的字符替換加密）。如果工作無法迅速完成，定制的流就需等待，直到后續(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)行非常簡單的文本替換。

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í)行許多方法，允許我們簡單地覆蓋 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í)往自己的工具庫中再加入一件多功能的工具。