山東移動通信公司 郭彬  

---- 本文通過對CGI和ISAPI的對比以及對ISAPI的工作原理的分析，闡述了使用MFC ISAPI編程的一般方法。

---- 一、ISAPI簡介：

---- 目前大多數網站提供信息的方式是由用戶通過客戶瀏覽器(如Netscape或Explorer等)與WWW服務器連接，然后用鼠標點按超級連接以瀏覽相關的主頁。在此過程中，基本上是服務器向客戶端單方向的信息傳遞，隨著服務需求的不斷擴大，這種單純的單方向傳遞信息的靜態主頁已不能滿足需求。不論是服務提供方還是客戶，都希望在瀏覽服務器將信息發送到用戶同時，用戶端也能將信息發送到服務器端，實現服務器與客戶的交互。典型的應用如：用戶登記表、用戶留言板以及用戶通過WWW檢索服務器端的數據庫等等。

---- 要實現一個可與用戶交互信息的服務系統，所需增加的有兩項：交互式主頁和用戶輸入信息處理程序。交互式主頁即有輸入信息的編輯框，選擇菜單按鈕之類的主頁，以供用戶輸入信息；用戶輸入的信息則交由用戶信息處理程序處理。實現該程序可以有多種途徑，該程序可以放在服務器端，也可以放在客戶機端，前者如CGI、ISAPI，后者如JAVA Applet、javascript等等。

---- ISAPI（即Internet Server Application Program Interface），是微軟提供的一套面向Internet 服務的API接口，它能實現CGI（Common Gateway Interface，公共網關接口）能提供的全部功能，并在此基礎上進行了擴展，如提供了過濾器應用程序接口。

---- 在Web服務器這個競爭激烈的領域里，微軟的IIS（Internet Information Server，Internet信息服務器）是當今Windows NT操作平臺上執行效率最高的Web服務器之一。IIS提供所有傳統的內容傳遞方式，它對靜態網頁有著良好的支持。對于更復雜的應用程序，IIS提供了功能更強的應用框架：使用ISAPI能夠創造出極高性能的應用程序。書寫良好的ISAPI擴展的性能可能超過類似的CGI一個數量級。此外，ISAPI的靈活性使一些事情變得簡單。

---- ISAPI提供了擴展支持WEB服務器的簡單而有效的方法。開發人員可以設計生成ISAPI 服務器擴展動態連接庫（ISAPI Server Extension DLL），它可以被HTTP服務器調用。例如，客戶端用戶填寫了一個表單，按下"提交"按鈕后，輸入的數據將被傳送至HTTP服務器，激活相應的ISAPI擴展應用程序，該應用程序可以處理用戶的輸入信息，進行相應的操作。或者，按照用戶的要求訪問數據庫，讀取用戶指定的數據，動態生成HTML文件，再傳回客戶端。

---- CGI很早就作為交互式的Web應用程序的一個標準廣泛應用在Internet之中。CGI腳本允許人們用多種編程語言如Basic、C、Perl、Shell 等等來編寫簡單的應用程序。這些腳本運行在Web服務器上，而在客戶的Web瀏覽器上輸出運行結果。客戶的輸入通過環境變量或者標準輸入設備來進行傳遞，然后CGI程序根據需要完成特定的功能，并通過標準輸出設備送回HTML格式的結果顯示在客戶的瀏覽器中。CGI的這一特性―設計簡單，再加上它支持多種編程語言，使得開發CGI應用程序非常簡單。盡管如此，人們在使用中還是發現了CGI應用程序的一個很大的缺點：性能不高。 雖然有不少辦法來使CGI應用程序運行得更快一些（如把它們變成編譯好的二進制代碼，而不用Perl腳本），但執行速度仍然是一個問題。每當通過Web訪問一個CGI程序時，CGI執行文件（或者腳本的解釋器）都要為每一個請求創建一個新的進程。對于一個信息量比較大的站點來說，這無疑給服務器增加了一個沉重的負擔。

---- 二、ISAPI的工作原理：

---- ISAPI的工作原理和CGI大體上是相同的，都是通過交互式主頁取得用戶輸入信息，然后交服務器后臺處理。但是二者在實現機制上大相庭徑。ISAPI與CGI最大的區別在于：在ISAPI下建立的應用程序是以動態連接庫（Dynamic Link Lib，DLL）的形式存在；而CGI的應用程序一般都是可執行程序。ISAPI應用的工作流程與CGI也有一些不同。ISAPI應用的DLL不僅可以象CGI程序一樣被用戶請求激活，還可以被系統預先激活來監視用戶輸入；對于被用戶激活的DLL，在處理完一個用戶請求后不會馬上消失，而是繼續駐留在內存中等待處理別的用戶輸入，直到過了一段時間后一直沒有用戶輸入。

---- 一個ISAPI的DLL，可以在被用戶請求激活后長駐內存，等待用戶的另一個請求，還可以在一個DLL里設置多個用戶請求處理函數，此外，ISAPI的DLL應用程序和WWW服務器處于同一個進程中，效率要顯著高于CGI。

---- 不過ISAPI的平臺兼容性較差，目前只能用于微軟自己的Windows 95和NT操作系統上，服務器平臺也僅限于IIS（Internet Information Server)和MS personal web server以及NT workstation上的peer web server。

---- ISAPI DLLs的調用方法和CGI一樣：在客戶端使用GET或POST方法。例如，當客戶作出下列請求時：

---- ---- http://www.mysite.com/myisa.dll?name=fisherman&id=12345 "name"域和"id"域以及與它們相關的數據都被傳遞給ISA。ISAPI在使用這些相關的數據之前把它們存放在相應的數據結構中，這是通過一個請求映射系統來實現的。

---- 每一個請求都有一個解析映射表。通過定義服務器從客戶接收的數據的類型和順序，該解析映射表可以把數據傳遞到合適的數據結構中。例如，對于請求"name=fisherman&id=12345"，解析映射表將顯示一個字符串和一個整型數，并且" fisherman " and "12345"將被解析出來存放到各自的數據結構中。

---- 解析映射系統還有另外一個功能：ISAPI可以把請求傳遞給ISA內特定的成員函數。請求字符串可以包含一個命令，解析映射表就使用該命令把請求傳遞給ISA內正確的成員函數。

---- 三、MFC的ISAPI編程方法：

---- 1、用戶輸入的方法：

---- Web表單：

---- Web表單（Form）提供了一種與用戶進行交互的方法。它使用"打包"的技術，以收集用戶的輸入，觸發網絡服務器的行為，獲取用戶的響應，功能類似于Windows中的對話框。

---- 表單使用
和
標識定義了一個組成表單的HTML網頁的區域。當選擇了表單中的Submit按鈕，兩個標識之間的數據輸入就被作為一組發送到服務器。典型的設計如下所示：

< form ACTION="input.dll" METHOD="POST" >
< input TYPE="hidden" NAME="MfcISAPICommand" value="Input" >
.
< input [attribute-list] >
.
  < input TYPE="submit" value="OK" >
  < input TYPE="reset"  value="Reset" >
< /form >

---- 其中"ACTION"屬性指定了ISAPI DLL在服務器上的存放位置。"METHOD"屬性指出了數據將被傳送到服務器的方式：如果是"GET"方式，數據就作為URL的一部分被編碼并發送到服務器；如果是"POST"方式，數據就作為消息的主體被發送。
---- < input >標識符用于從用戶收集輸入，輸入類型由"TYPE"屬性決定。由標識符支持的輸入類型如下：

¨ 文本輸入
¨ 口令輸入
¨ 單選按鈕
¨ 復選框
¨ 圖象輸入
¨ 隱藏域
¨ 提交按鈕
¨ 重置按鈕

---- 這些輸入單元都有以下的形式：
< input type="text" name="EquipName" value="MSC" >
   
---- "name"是給輸入單元一個標識，這個標識將作為ISAPI DLL中響應函數的參數。"type"是輸入單元的類型，用以區分以上幾種輸入單元。"value"設置輸入單元的初始值。
---- 注意上面的HTML源程序，在類型為"hidden"的輸入單元中，定義了服務器端響應此用戶輸入的函數名。而類型為"submit"和"reset"的兩個輸入單元是兩個按鈕，當用戶按下"submit"按鈕，系統就將輸入的內容發送到服務器端；當用戶按下"reset"按鈕，系統就將用戶輸入的內容重置為原來的默認值，以便重新輸入。

---- 超級連結：

---- 用戶也可以使用超級連結的方法來激活一個ISAPI DLL。如下所示：

< a href="browser.dll?mfcISAPICommand
=Browser" >Browser< /a >

---- 這里，隱含地采用了"GET"的方式。在href中指明了ISAPI DLL的模塊名和具體的函數名。當用戶點中了這個超級聯結，系統就會將用戶的請求發送到服務器。
---- 2、MFC中對用戶數據輸入的響應方法：

---- 從發布開始，MFC（Microsoft Foundamental Classes，微軟基礎類庫）就被認為是開發Windows應用程序的標準平臺。通過提供更清晰、更簡單的Windows API接口，MFC可以幫助開發者更快、更簡單地編寫程序。

---- MFC中支持ISAPI的類有：

¨ CHttpServer
¨ CHttpServerContext
¨ CHttpFilter
¨ CHttpFilterContext
¨ CHtmlStream

---- 用戶可以方便地使用"ISAPI Extention Wizard"來生成一個ISAPI DLL的基本框架，然后只要添加自己需要的函數就可以了。
---- HTML的用戶輸入和命令處理例程是通過一個叫做"MFC PARSEMAP"的數據結構來實現解析映射的。在生成的框架中，可以看到形如以下的源程序：

BEGIN_PARSE_MAP(Cbrowser
Extension, CHttpServer)
ON_PARSE_COMMAND(Browser,
CBrowserExtension, ITS_EMPTY)
DEFAULT_PARSE_COMMAND(Browser,
CBrowserExtension)

ON_PARSE_COMMAND(Query,
CBrowserExtension, ITS_PSTR)
ON_PARSE_COMMAND_PARAMS("OfficeName")
END_PARSE_MAP(CBrowserExtension)

它們的含義如下：
BEGIN_PARSE_MAP(Cbrowser
Extension, CHttpServer)和
END_PARSE_MAP(CBrowserExtension)：

---- 定義PARSEMAP的開始和結束。并且指出本DLL所使用的類名及其基類名（一般是CHttpServer）。
---- ON_PARSE_COMMAND(funcName,className,paramList)

---- 定義支持服務器側接收用戶輸入的一個函數，以及它所接受的參數。該函數與WEB表單的隱含輸入域中定義的"value"值要一致。用戶只要編寫此函數，就可以實現對用戶輸入的響應。必須要保證這里定義的參數與WEB表單中定義的輸入單元是一一對應的。

---- ParamList是一個或多個代碼定義的函數的參數列表，可用的代碼如下：

代碼   含義  C++中與之對應的數據類型
ITS_PSTR  字符串  LPCSTR或char * const
ITS_I2     2字節整數  Int
ITS_I4     4字節整數  long int
ITS_R4    4字節浮點數  Float
ITS_R8    8字節浮點數  Double
ITS_EMPTY  空的參數列表

ON_PARSE_COMMAND_PARAMS

---- 該宏定義參數的名稱，注意要與HTML的表單中各個輸入單元的"name"值保持一致。
---- DEFAULT_PARSE_COMMAND

---- 用于指定如果瀏覽器傳送的表單或超級連結中沒有包含一個函數名時，被DLL缺省調用的函數名。

---- 3、響應函數的結構：

---- 響應函數形如以下結構：

void CBrowserExtension::Browser
(CHttpServerContext* pCtxt,…)
{
StartContent(pCtxt);
*pCtxt << "< p >Hello World !< /p >";
//其它的處理。
  EndContent(pCtxt);
}

---- 響應函數總是以StartContent(pCtxt)函數開始，以EndContent(pCtxt)函數結束。*pCtxt的作用是向用戶端傳送數據。
---- 服務器可以對輸入參數進行相應處理，并將處理結果以HTML的形式發送回用戶端。所以要在此函數中，要將需要在用戶端顯示的整個網頁的HTML源代碼發送過去。雖然略顯麻煩，但增加了靈活性，可以按照用戶的輸入來動態地生成各式各樣的網頁。

---- 使用ISAPI，可以使得靜止的網頁立刻變得豐富多彩起來！