ISAPI 擴展開發：高效能 Web 應用的 DLL 架構與 MFC 實作

ISAPI 核心優勢

• DLL 進程內執行： 載入一次長駐記憶體，避免 CGI 每請求建立行程開銷。
• 執行緒模型： IIS 以執行緒處理請求，單一 DLL 實例服務多請求，**必須撰寫執行緒安全程式碼**。
• 多功能映射： 單一 DLL 透過對應巨集 (HTTP_MAP) 將不同 URL 對應至不同處理函式。
• 濾波器支援： ISAPI Filter 可攔截所有 HTTP 請求/回應，實現認證、壓縮、日誌、URL 重寫等横切關注點。

MFC ISAPI Extension Wizard 產生架構

VC++ 專案精靈產生核心類別：

• CHttpServer 派生類（如 CTestisaExtension）：DLL 進入點，實作 GetExtensionVersion、HttpExtensionProc（由 MFC 實作分派）。
• 對應巨集：

  BEGIN_HTTP_MAP(CTestisaExtension)
      HTTP_HANDLER("MyFunction", OnMyFunction)  // /test.dll?MyFunction¶m=...
      HTTP_HANDLER_DEFAULT(Default)             // 未匹配路由
  END_HTTP_MAP()
  

• 處理函式簽名： void OnMyFunction(CHttpServerContext* pCtxt)，透過 pCtxt 存取請求/回應。

CHttpServerContext 關鍵操作

URL 格式與路由

https://host/scripts/test.dll?FunctionName&param1=value1&param2=value2

• FunctionName 對應 HTTP_HANDLER 第一參數。
• 參數自動解析可用 pCtxt->GetServerVariable 或手動剖析 QUERY_STRING。

關鍵開發守則

• 執行緒安全： 成員變數僅限唯讀/常數，請求狀態全在 CHttpServerContext 或堆疊區域變數。
• 無阻塞： 避免同步 I/O、Sleep、資料庫同步呼叫，否則阻塞 IIS 執行緒池導致拒絕服務。
• 錯誤處理： 使用 try/catch 捕獲所有例外，回傳 500 錯誤頁，防止 DLL 當機拖垮 IIS。
• 版本資訊： GetExtensionVersion 填寫 HSE_VERSION_INFO，lpszExtensionDesc 顯示於 IIS 管理介面。

部署與除錯

1. 編譯 Release DLL，複製至 IIS Scripts 目錄（需執行權限）。
2. IIS 管理員→虛擬目錄→應用程式對應→新增 .dll 對應至 ISAPI DLL。
3. 除錯：VS 附加至 inetinfo.exe 或 w3wp.exe 行程，設中斷點。