作者：sonymusic
email: sonymusic@china.com
日期：2000-12-6 23:50:12
將 Microsoft 的 Internet Information Server 用作 Java servlet 引擎
用 Microsoft 的 IIS 運行 Java servlet -- 而不犧牲可移植性

Thomas E. Davis 
Nutrio.com 首席技術(shù)官
2000 年 7 月

內(nèi)容： 
 
 
 IIS 
 適配器設(shè)計模式 
 Servlet 
 ASP 
 Java SDK 
 請求適配器 
 會話適配器 
 響應(yīng)適配器 
 結(jié)論 
 正式請求 
 參考資料 
 作者簡介 
 


您是陷在僅有 Microsoft 產(chǎn)品的商店中的 Java 狂熱分子嗎？僅使用 Microsoft 的 Internet Information Server 和純 Java，您就可以運行 Java servlet，而無須任何第三方產(chǎn)品的幫助。請不要馬上就放棄 Microsoft 產(chǎn)品 -- 不妨試試本文中說明的方法，并仍然保持為無專有權(quán)的可移植代碼。

您知不知道，無須第三方產(chǎn)品，就可以用 Microsoft 的 Internet Information Server (IIS) 運行 JavaServlet？您的全部所需僅僅是簡明的舊式 IIS 和純 Java。盡管您需要使用 Microsoft 的 Java SDK（原因我將在下面解釋），但盡可放心，您的代碼將不需要任何專用權(quán)擴展，同時又保持對其它 servlet 引擎的完全可移植性。

Microsoft 的 Internet Information Server 
但您為什么要做這樣的傻事，讓 Java servlet 運行在并非為它設(shè)計的環(huán)境中呢？首先，由于我們無法控制的情況，許多像我們這樣頑固的 Java 狂熱分子都陷在了僅有 Microsoft 產(chǎn)品的商店里。我們?nèi)及?Linux 軟件盒子藏在桌子下面，運行 IBM 最新的 JDK 和 Apache 最新的 servlet 引擎，但是，要是老板不讓我們在這樣一個系統(tǒng)上部署一些產(chǎn)品，這時可就真的不好過了。您當(dāng)然可以找到運行于 Microsoft 平臺上的商業(yè)性 servlet 引擎，但購買它們要花大把大把的錢。試一試向您的老板解釋：您需要幾千美金購買一種新的 Web 服務(wù)器，因為您想要廢棄操作系統(tǒng)附帶的那個免費產(chǎn)品（或者只將它用作簡單的傳遞代理，這正是許多產(chǎn)品目前的工作方式）。然后，等您的老板詛咒完畢，您就不妨問一問自己，您是不是有點太急于放棄 Microsoft 的產(chǎn)品了？Microsoft 和 Sun 都有他們的問題，但這并不能改變這樣一個事實：IIS 是一種值得尊敬的軟件。并且既然您知道它可以運行 Java servlet，它的吸引力也就更大了一點。

適配器設(shè)計模式 
將這兩種技術(shù)粘合在一起的魔法是適配器設(shè)計模式的一種簡單的應(yīng)用程序。不妨引用一下一個不大出名的四人團伙（Erich Gamma、Richard Helm、Ralph Johnson 和 John Vlissides）所寫的書《Design Patterns: Elements of Reusable Object-Oriented Software》（參考資料），里面說：適配器模式的意圖就是將一個類的接口轉(zhuǎn)換為客戶機期望的另一種接口。但哪些類是您必須改編的呢？答案是 Java Servlet 用來與其環(huán)境交互的幾個核心類 -- 尤其是 Request、Response 和 Session 對象。幸運的是，您不必改編 Cookie 類 -- 這一轉(zhuǎn)換將由其它適配器內(nèi)部處理。

IIS，或者更具體地說，它的 Active Server Page (ASP) 環(huán)境，包含了一組核心類，它們實際上反映了 Java Servlet 規(guī)范的類。事實上我應(yīng)該說，servlet 反映了 ASP 的框架，因為 IIS 在 servlet 規(guī)范制定以前早就有了產(chǎn)品，但我不想在 Microsoft 與 Sun 之間的爭論中推波助瀾。

兩種框架中都存在 Request、Response、Session 和 Cookie 對象。唯一的問題是，這些對象的接口在兩種環(huán)境之間不兼容。這正是適配器設(shè)計模式起作用的地方。您必須改編（或包裝）對象的 IIS 版本，使它們的外觀和行為都類似于 servlet 版本。

一個快捷而不夠清晰的 servlet 概覽 
按最低要求，servlet 只須實現(xiàn)單個方法： public void doGet( HttpServletRequest request, HttpServletResponse response );

 


從技術(shù)上講，如果 servlet 希望處理的客戶機請求，使用的是 HTTP 的 POST 命令而不是 GET 命令，則 servlet 還必須實現(xiàn) doPost 方法。但為了使本文保持簡潔，您可以假定所有客戶機請求都屬于 GET 類型。

doGet 方法取得兩個對象：請求和響應(yīng)。請求對象將客戶機發(fā)送給服務(wù)器的所有數(shù)據(jù)，以及有關(guān)客戶機本身的一些元信息，都封裝在一起。使用響應(yīng)對象將數(shù)據(jù)發(fā)回客戶機。這是非常抽象的說明，但本文并不是 servlet 的引論，所以我不想涉及更多的細節(jié)。有關(guān) servlet 的優(yōu)秀初級讀本，我推薦 Jason Hunter，William Crawford 和 Paula Ferguson 合著的《Java Servlet Programming》 (O'Reilly & Associates)。

Active Server Page 
當(dāng)您從 ASP 中調(diào)用 servlet 時，您正是在調(diào)用 doGet 方法，并傳入適當(dāng)?shù)恼埱蠛晚憫?yīng)對象。從這時起，servlet 就具有了完全的控制權(quán)。ASP 腳本用作 servlet 的引導(dǎo)程序。但在您可以傳入請求和響應(yīng)對象之前，您必須用相應(yīng)的適配器類來包裝它們（稍后我對此將有詳細分析）。

我將從頭開始講下去。客戶機要請求的 URL 看起來與 http://localhost/servlet.asp 類似。.asp 擴展名意味著所請求的文檔是一個 Active Server Page 腳本。下面就是完整的 servlet.asp 腳本：

dim requestAdapter
set requestAdapter = getObject( "java:com.nutrio.asp.RequestAdapter" )

dim responseAdapter
set responseAdapter = getObject( "java:com.nutrio.asp.ResponseAdapter" )

dim servlet
set servlet = getObject( "java:com.nutrio.servlet.HelloWorldServlet" )

servlet.doGet requestAdapter, responseAdapter

 

分析上一段腳本，您將發(fā)現(xiàn)，它是從聲明一個稱為 requestAdapter 的變量入手的。dim 是 Visual Basic 中對變量進行聲明的命令。在 Visual Basic 中，變量沒有固定類型，各種變量實際上是由 Variant 對象進行包裝的，這可使變量以調(diào)用代碼所要求的任何一種類型（例如，數(shù)字、字符串，等等）出現(xiàn)。這樣做確實非常方便，但有可能使代碼容易混淆，而且也不安全。這正是為什么要發(fā)明“匈牙利表示法”(Hungarian Notation) 的原因（請參閱參考資料）。不過，這完全是另外一場爭論。

聲明變量以后，就應(yīng)該使用 ASP 的 getObject 方法實例化您的第一個適配器類，并相應(yīng)地為其賦值。getObject 方法是 IIS 版本 4 中新增的。它被稱為 moniker （一種 COM 對象，用于創(chuàng)建其它對象的實例，請參閱參考資料），但它使您能夠訪問 Java 對象，而沒有注冊任何組件對象模型（COM，請參閱參考資料）這類令人頭痛的事。然后，您依次聲明、實例化響應(yīng)封裝并為其賦值，然后對 servlet 做同樣的事情。最后，您調(diào)用 servlet 的 doGet 方法，并傳入改編了的請求和響應(yīng)對象。 

這個特定的腳本具有相當(dāng)大的局限性，因為它只啟動一個特定的 servlet。您很可能希望將其擴展，以啟動一整套 servlet，這樣您就需要做幾處小小的修改。假定您的所有 servlet 都在同一個包內(nèi)，您就可以將目標(biāo) servlet 的類名作為變量傳遞給 URL，例如 http://localhost/servlet.asp?class=HelloWorldServlet。然后您必須更改腳本的末尾來加載指定的類。下面是新的代碼：


dim className
set className = Request.QueryString( "class" )

dim servlet
set servlet = getObject( "java:com.nutrio.servlet." & className )

servlet.doGet requestAdapter, responseAdapter
 

這就行了！您已經(jīng)將 Microsoft 的 Internet Information Server 變成了 Java Servlet 引擎。正如您將在下面看到的那樣，它雖然不是一個完美的引擎，但已相當(dāng)接近完美。剩下要討論的全部內(nèi)容就是適配器類的本質(zhì)了。

為簡潔起見，在每種適配器中，我將只討論如何實現(xiàn)那些較流行的方法。對流行程度的度量是以我的個人經(jīng)驗和看法為依據(jù)的；沒有比這更科學(xué)的了（這是我引用的原話）。

Microsoft 的 Java SDK 
從請求的封裝開始，對象必須做的第一件事情就是，獲取其 ASP 對應(yīng)物的一個引用。這是通過 com.ms.iis.asp 包中的 AspContext 對象完成的。您問是什么包嗎？對了，這里我正要解釋您為什么需要安裝 Microsoft 的 Java SDK。

Microsoft 的 Java SDK 可以免費下載（請參閱參考資料）。要確保您獲得的是最新版本，我寫這篇文章時為 4.0。按照簡單的安裝說明進行操作，并在出現(xiàn)提示時重新啟動（令人嘆息！）。安裝 SDK 之后，相應(yīng)調(diào)整您的 PATH 和 CLASSPATH 環(huán)境變量。采取點聰明的小技巧，在您的系統(tǒng)中搜索 jview.exe 的全部實例，然后確保最新版本在您的 PATH 中最先解析。 

不幸的是，Microsoft 的 Java SDK 附帶的文檔和樣例代碼中涉及 IIS/ASP 集成的內(nèi)容非常少。當(dāng)然有許多夸夸其談 -- 您得到了有關(guān)這一主題的整個已編譯的 HTML 文檔，但在大多數(shù)地方，它給人的感覺與其說是說明性的，不如說是自相矛盾的和含混不清的。謝天謝地，SDK 的 Samples 目錄中有一個 aspcomp 包，它實際上反映了 com.ms.iis.asp 包，并提供了源代碼。您在安裝 SDK 時確實安裝了這些樣例文件，對嗎？這個 aspcomp 包幫助我反向設(shè)計出許多 API 邏輯。

請求適配器 
既然您有了可隨意使用的 Microsoft 的 SDK，您就可以回頭繼續(xù)實現(xiàn)適配器類了。下面是請求適配器的最基本的版本。我已省略了包聲明和 import 語句，以便您可將注意力集中在代碼的實質(zhì)部分。

public class RequestAdapter implements HttpServletRequest
{
    private Request request;

    public RequestAdapter()
    {
        this.request = AspContext.getRequest();
    }
 

請注意，該類引出了一個單一的 public 構(gòu)造函數(shù)，它不帶任何參數(shù)。這是 ASP 腳本將該類實例化為一個 moniker 所必需的（通過 getObject 方法）。此構(gòu)造函數(shù)只須從 AspContext 對象取得 ASP 的請求對象的一個引用，并存儲指向它的一個指針。此適配器實現(xiàn) HttpServletRequest 接口，它允許您在一種真實的 servlet 環(huán)境的外觀之下，將其傳遞給您的 servlet。

請求對象的最常用方法是 getParameter。此方法用于檢索客戶機預(yù)計要提供的一段數(shù)據(jù)。例如，如果客戶機剛填好了一個表單并將其提交給服務(wù)器，則 servlet 將調(diào)用 getParameter 來檢索每個表單項的值。

在請求對象的 ASP 版本中，Microsoft 將區(qū)分通過 GET 到達的參數(shù)和通過 POST 到達的參數(shù)，您必須分別調(diào)用 getQueryString 或 getForm。在 servlet 版本中，在請求級別上不存在這種差別，因為用 GET 模式還是用 POST 模式，是在調(diào)用 doGet 或 doPost 時才規(guī)定的。因此，當(dāng)您改編 getParameter 方法時，對于所需的值，您必須既查看查詢字符串，又查看表單集合。

還有一點需要注意，當(dāng)參數(shù)不存在時，Microsoft 版本中將返回一個空字符串，而 Sun 版本中將返回 null。考慮到這一點，您必須檢查空字符串并在相應(yīng)位置使返回值為 null。


public String getParameter( String str )
{
    String result = request.getQueryString().getString( str );

    if( ( result != null ) && result.trim().equals( "" ) )
    {
        result = request.getForm().getString( str );

        if( ( result != null ) && result.trim().equals( "" ) )
        {
            return( null );
        }
    }

    return( result );
}
 

這樣做相當(dāng)簡單，但期望值不要太高，因為事情即將變得更為復(fù)雜。這是因為，在 servlet 中，請求對象也引出一個稱為 getParameterNames 的方法，對于客戶機提供的每段數(shù)據(jù)，它都會返回關(guān)鍵字的一個 Enumeration。如上所述，就 servlet 而論，它是一個單一入口點，但是 ASP 則要區(qū)分 GET 提供的數(shù)據(jù)和 POST 提供的數(shù)據(jù)。為了向 servlet 返回單一的 Enumeration，必須將 ASP 請求對象的查詢字符串和表單集合這兩種 Enumeration 組合起來。下面是我為了解決這個問題臨時編寫的一個方便的小工具。此工具稱為 EnumerationComposite（請不要將它與 Composite 設(shè)計模式相混淆），它使用一個 RequestDictionary（ASP 版本的 Hashtable）數(shù)組，并將這兩種 Enumeration 連接起來，形成一個大的 Enumeration。下面是完整的代碼：

public class EnumerationComposite implements Enumeration
{
    private RequestDictionary[] array;
    private int stackPointer = 0; 

    public EnumerationComposite( RequestDictionary[] array )
    {
        this.array = array;
    }

    public boolean hasMoreElements()
    {
        if( this.stackPointer >= this.array.length ) 
        {
            return( false );
        }
        else if( this.array[ this.stackPointer ].hasMoreItems() )
        {
            return( true );
        }
        else
        {
            this.stackPointer += 1;
            return( this.hasMoreElements() );
        }
    }

    public Object nextElement()
    {
        return( this.array[ this.stackPointer ].nextItem() );
    }
}

未完.....