將 Microsoft 的 Internet Information Server 用作 Java servlet 引擎

 

現在這個工具極大地簡化了您的工作。而 getParameterNames 方法就具有了類似下面的形式：

public Enumeration getParameterNames()
{
    return(
        new EnumerationComposite(
            new RequestDictionary[] {
                request.getQueryString(),
                request.getForm() } ) );
}


響應對象的下一個最常用的方法是 getSession。會話對象是另一個核心對象，它在 ASP 和 servlet 之間互為映像。因此，您提供的會話就必須擁有自己的適配器，稍后我會對此加以說明。但在我說明之前，請先看這個請求方法：

public HttpSession getSession( boolean flag )
{
    return( new SessionAdapter() );
}


在本文中，需要改寫的請求對象的最后一個方法是 getCookies。顧名思義，它返回客戶機所提供的 cookie 的集合。ASP 版本的 cookie 對象使我感到為難，它似乎用作自身的一個集合，但又引出了許多具有莫明其妙的功能的方法。但是我能夠對腳本進行充分的剖析來改寫 servlet。由于 ASP 版本中返回 Enumeration，而 servlet 版本中則返回一個數組，這樣就可以使用 Vector 類中一個不常用的方法 copyInto，來實現這種轉換，這是唯一的小竅門。另外請注意，由于在 com.ms.iis.asp 包和 javax.servlet.http 包中，類名是完全相同的，因此我們不得不明確指明每個 Cookie 對象的包名。代碼如下：

public javax.servlet.http.Cookie[] getCookies()
{
    Vector tmpList = new Vector();

    CookieDictionary aspCookies = this.request.getCookies();

    IEnumerator e = aspCookies.keys();

    while( e.hasMoreItems() )
    {
        String key = (String) e.nextItem();
        String val = aspCookies.getCookie( key ).getValue();
        tmpList.addElement( new javax.servlet.http.Cookie( key, val ) );
    }

    javax.servlet.http.Cookie[] cookies = new javax.servlet.http.Cookie
         [ tmpList.size() ];
    tmpList.copyInto( cookies );

    return( cookies );
}



會話適配器
現在，既然完成了請求適配器，就需要退回去討論會話適配器。無論在 ASP 中還是在 servlet 中，會話實際上是一個散列表，您只是將對象置入會話或者從會話獲取對象。這些值的用法幾乎就等同于相應的響應參數規則，這些規則上面已有討論。會話適配器的實現很復雜，這里就不介紹了。完整的源代碼可從參考資料中獲得。

響應適配器
下一個主要的難題是響應適配器。正像請求適配器一樣，響應適配器也需要幾個巧妙的辦法。但是在討論較難的內容之前，我先偏離正題討論一點較容易的內容。下面是兩個較流行的響應方法的極簡單的代碼：

public void sendRedirect( String str )
{
    this.response.redirect( str );
}

public void setContentType( String str )
{
    // ASP 自動設置內容的類型！
}


setContentType 用來干什么？它什么事情也沒做！沒錯，IIS 畢竟沒有創建出完美的 servlet 引擎。到執行 servlet 時，ASP 引擎已定義了內容類型以及其它標準的 HTTP 標頭。但是按經驗來講，多數 servlet 不需要將內容類型設置為純文本或 HTML 以外的任何其它類型。

正如前面提到的那樣，您并不需要一個適配器來處理 cookie。響應對象的 addCookie 方法只須根據所提供的 Sun 的 cookie 的內容，來創建 Microsoft 的 cookie 的實例。Microsoft 和 Sun 都同意，cookie 只不過是將數據的名稱和值配成對而已。但是，雙方對于 API 中應如何表示 cookie 有效期的方式，則意見不同。

Sun 版本中表示 cookie 有效期的方法是使用一個整型值，它指定 cookie 的最長壽命（以秒為單位）。此值被傳遞給 Cookie 對象的 setMaxAge 方法。零值表示立即到期，而負值（一種特殊情況）表示 cookie 應在用戶瀏覽器退出時廢棄。

Microsoft 版本表示 cookie 有效期的方式有所不同。缺省情況下，Microsoft 的 cookie 設置為在用戶瀏覽器退出時到期。因此，如果 Sun 版本中 cookie 具有負的有效期，轉為 Microsoft 版本時不做修改；如果 Sun 版本中 cookie 的最長有效期大于或等于零，須將此有效期轉換為 Microsoft 的 Time 對象，并將其傳遞給 Microsoft 版本的 cookie 對象，作為有效期。請注意，月份值在 Java 的 Calendar 類中是從零開始的，而在 Microsoft 的 Time 類中是從 1 開始的，所以在轉換時必須將此值加 1。

public void addCookie( javax.servlet.http.Cookie cookie )
{
    com.ms.iis.asp.Cookie aspCookie = this.response.getCookies().getCookie
        ( cookie.getName() );
    aspCookie.setValue( cookie.getValue() );

    int age = cookie.getMaxAge();

    if( age < 0 )
    {
        // expire on browser exit
    }
    else
    {
        GregorianCalendar date = new GregorianCalendar();
        Date time = new Date( System.currentTimeMillis() + ( 1000 * age ) );
        date.setTime( time );

        Time aspTime = new Time(
            date.get( Calendar.YEAR ),
            1 + date.get( Calendar.MONTH ),
            date.get( Calendar.DAY_OF_MONTH ),
            date.get( Calendar.HOUR ),
            date.get( Calendar.MINUTE ),
            date.get( Calendar.SECOND )
        );

        aspCookie.setExpires( aspTime );
    }
}


最流行的響應方法碰巧也是最難以實現的，這正是我將它留到最后的原因。我所指的方法就是 getWriter。此方法返回 PrintWriter 對象，它讓 servlet 將信息寫到客戶機的顯示屏上。在大多數情況下，servlet 只是編制 HTML，HTML 在全部被發送到客戶機之前將被存入緩沖區中。為什么要存入緩沖區呢？因為 servlet 在將大量信息轉儲到 PrintWriter 以后，servlet 可能通過調用 sendRedirect 方法判斷出有某種出錯和異常終止的情況。重定向代碼一定是瀏覽器接收的第一條信息；顯然，一旦發出了重定向，就再不需要將任何緩沖的信息發送給客戶機了。

考慮到以上情況，您就必須再創建一個適配器類。這個新的適配器將封裝 PrintWriter 對象。它將把它的所有內容都存入緩沖區中，直到調用了 close 方法為止。下面是相應的響應方法：


public PrintWriter getWriter()
{
    return( new PrintWriterAdapter() );
}


而下面是 PrintWriter 適配器的完整代碼：

public class PrintWriterAdapter extends PrintWriter
{
    private static final String CR = "\n";

    private StringBuffer sb = new StringBuffer();

    public PrintWriterAdapter()
    {
        super( System.err );
    }

    public void print ( String str ){ sb.append( str ); }//response.write
        ( str ); }
    public void println( String str ){ print ( str + CR ); }

    public void print ( Object obj ){ print ( obj.toString() ); }
    public void println( Object obj ){ println( obj.toString() ); }

    public void print ( char[] chr ){ print ( new String( chr ) ); }
    public void println( char[] chr ){ println( new String( chr ) ); }

    public void close()
    {
        AspContext.getResponse().write( sb.toString() );
    }
}



結論
Microsoft 的 Internet Information Server 沒有創造出完美的 servlet 引擎，但它已經相當接近完美了。根據我有關 servlet 的全部經驗，IIS 和這些適配器類的組合已表明足以滿足開發和部署商業性應用程序的需要。如果您碰巧被鎖進只能選 Microsoft 產品的商店，這些工具能幫您另辟蹊徑，領略 Java servlet 的奇妙之處。同時，我將一如既往地樂意傾聽您的評論、批評以及改進這些代碼的comments。

我在本文中引入的所有類的源代碼，包括一些我沒有談及的功能，都可以在參考資料中找到。請注意，許多方法（尤其是那些我還不需要的方法）仍未實現。如果您敢于完成這一工作，請給我發一份副本（眨眼）。

對 Microsoft 或有幫助的讀者的一項正式請求
我已將本文中說明的技術成功地部署到我實驗室的大多數系統上。但它在幾臺機器上卻就是不能工作。ASP 頁對于對適配器對象的任何引用都報告這一條錯誤： "No object for moniker"。這無疑是由 Microsoft 的 Java SDK 4.0、 Microsoft 的 Internet Information Server (Windows NT Option Pack 4)、Visual J++ 和某個 Service Pack 的莫明其妙的組合引起的。我搜索了 Microsoft Developer@#s Network (MSDN)，但徒勞無益，我已無計可施了。如果您知道問題所在并有解決辦法，請拿出來與我分享。謝謝。

原文轉自：http://www.kjueaiud.com