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

 

現(xiàn)在這個(gè)工具極大地簡(jiǎn)化了您的工作。而 getParameterNames 方法就具有了類(lèi)似下面的形式：

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

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

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

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

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 );
}

 

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

響應(yīng)適配器 
下一個(gè)主要的難題是響應(yīng)適配器。正像請(qǐng)求適配器一樣，響應(yīng)適配器也需要幾個(gè)巧妙的辦法。但是在討論較難的內(nèi)容之前，我先偏離正題討論一點(diǎn)較容易的內(nèi)容。下面是兩個(gè)較流行的響應(yīng)方法的極簡(jiǎn)單的代碼： 

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

public void setContentType( String str )
{
    // ASP 自動(dòng)設(shè)置內(nèi)容的類(lèi)型！
}
 

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

正如前面提到的那樣，您并不需要一個(gè)適配器來(lái)處理 cookie。響應(yīng)對(duì)象的 addCookie 方法只須根據(jù)所提供的 Sun 的 cookie 的內(nèi)容，來(lái)創(chuàng)建 Microsoft 的 cookie 的實(shí)例。Microsoft 和 Sun 都同意，cookie 只不過(guò)是將數(shù)據(jù)的名稱(chēng)和值配成對(duì)而已。但是，雙方對(duì)于 API 中應(yīng)如何表示 cookie 有效期的方式，則意見(jiàn)不同。

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

Microsoft 版本表示 cookie 有效期的方式有所不同。缺省情況下，Microsoft 的 cookie 設(shè)置為在用戶瀏覽器退出時(shí)到期。因此，如果 Sun 版本中 cookie 具有負(fù)的有效期，轉(zhuǎn)為 Microsoft 版本時(shí)不做修改；如果 Sun 版本中 cookie 的最長(zhǎng)有效期大于或等于零，須將此有效期轉(zhuǎn)換為 Microsoft 的 Time 對(duì)象，并將其傳遞給 Microsoft 版本的 cookie 對(duì)象，作為有效期。請(qǐng)注意，月份值在 Java 的 Calendar 類(lèi)中是從零開(kāi)始的，而在 Microsoft 的 Time 類(lèi)中是從 1 開(kāi)始的，所以在轉(zhuǎn)換時(shí)必須將此值加 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 );
    }
}
 

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

考慮到以上情況，您就必須再創(chuàng)建一個(gè)適配器類(lèi)。這個(gè)新的適配器將封裝 PrintWriter 對(duì)象。它將把它的所有內(nèi)容都存入緩沖區(qū)中，直到調(diào)用了 close 方法為止。下面是相應(yīng)的響應(yīng)方法： 


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() );
    }
}

 

結(jié)論 
Microsoft 的 Internet Information Server 沒(méi)有創(chuàng)造出完美的 servlet 引擎，但它已經(jīng)相當(dāng)接近完美了。根據(jù)我有關(guān) servlet 的全部經(jīng)驗(yàn)，IIS 和這些適配器類(lèi)的組合已表明足以滿足開(kāi)發(fā)和部署商業(yè)性應(yīng)用程序的需要。如果您碰巧被鎖進(jìn)只能選 Microsoft 產(chǎn)品的商店，這些工具能幫您另辟蹊徑，領(lǐng)略 Java servlet 的奇妙之處。同時(shí)，我將一如既往地樂(lè)意傾聽(tīng)您的評(píng)論、批評(píng)以及改進(jìn)這些代碼的comments。 

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

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