作者：sonymusic
email: sonymusic@china.com
日期：2000-12-6 23:51:09

 

現(xiàn)在這個工具極大地簡化了您的工作。而 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 版本中則返回一個數(shù)組，這樣就可以使用 Vector 類中一個不常用的方法 copyInto，來實現(xiàn)這種轉換，這是唯一的小竅門。另外請注意，由于在 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 );
}

 

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

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

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

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

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

正如前面提到的那樣，您并不需要一個適配器來處理 cookie。響應對象的 addCookie 方法只須根據(jù)所提供的 Sun 的 cookie 的內容，來創(chuàng)建 Microsoft 的 cookie 的實例。Microsoft 和 Sun 都同意，cookie 只不過是將數(shù)據(jù)的名稱和值配成對而已。但是，雙方對于 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 );
    }
}
 

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

考慮到以上情況，您就必須再創(chuàng)建一個適配器類。這個新的適配器將封裝 PrintWriter 對象。它將把它的所有內容都存入緩沖區(qū)中，直到調用了 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 沒有創(chuàng)造出完美的 servlet 引擎，但它已經(jīng)相當接近完美了。根據(jù)我有關 servlet 的全部經(jīng)驗，IIS 和這些適配器類的組合已表明足以滿足開發(fā)和部署商業(yè)性應用程序的需要。如果您碰巧被鎖進只能選 Microsoft 產(chǎn)品的商店，這些工具能幫您另辟蹊徑，領略 Java servlet 的奇妙之處。同時，我將一如既往地樂意傾聽您的評論、批評以及改進這些代碼的comments。 

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

對 Microsoft 或有幫助的讀者的一項正式請求 
我已將本文中說明的技術成功地部署到我實驗室的大多數(shù)系統(tǒng)上。但它在幾臺機器上卻就是不能工作。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)，但徒勞無益，我已無計可施了。如果您知道問題所在并有解決辦法，請拿出來與我分享。謝謝。