ISAPI编程技术.docVIP

一.ISAPI简介 ISAPI（Internet Server Application Programming Interface）是Microsoft推出的运用在IIS内的一类基于HTTP协议的编程接口。通常将开发出的ISAPI应用模块称为ISA。简单地说，ISAPI是IIS提供的CGI替代技术。当然，ISAPI也可被认为是一种改良的CGI技术。ISAPI应用一般被开发为.dll的进程内DLL（In-process DLL），这使ISAPI应用的各实例在运行时同HTTP server位于相同的进程空间，所以各个ISAPI应用实例可以透明地访问HTTP server输出的资源。同传统的CGI相比，ISAPI应用具有更小的负荷。因为ISAPI应用在启动时无须申请创建自己的进程，而只需绑定到HTTP server的进程空间，所以其启动过程的速度要比传统的CGI程序快得多。从另一方面讲，ISAPI应用由于具有进程内属性，所以在其访问HTTP server的资源时，无须跨进程边界，这也使其运行效率大大提高。此外，IIS在管理进程内的线程时，实现了线程池（thread-pool）机制，这使ISAPI应用各实例的创建、释放和相应的资源分配更为有效。 ISA被分为两种类型：ISAPI Server Extension和ISAPI Filter。其中，ISAPI Server Extension可实现通常CGI程序的功能；而ISAPI Filter则可为IIS提供附加的功能。ISAPI Filter在Web server启动时被启动，在Web server停止时被卸载。用户对Web server的请求均会先通过ISAPI Filter过滤，而Web server返回浏览器的内容也会首先经ISAPI Filter过滤。由此可见，若要实现自定义的访问授权机制、数据压缩、数据加密和做日志等功能时，ISAPI Filter是一个合适的接口。 二.开发ISAPI Server Extension应用步骤 下面的例子描述了使用MFC和ISAPI Extension Wizard开发ISAPIServerExtension。 1.创建工程 ⑴标识Project Name为ISASample，确定存储路径。选择ISAPI Extension Wizard，点击OK按钮。 ⑵完成ISAPI Extension Wizard提供的各个选项，完成工程的创建。 2.探索ISAPI Extension Wizard生成的文件 ISAPI Extension Wizard自动生成了ISASample.cpp、ISASample.h、ISASample.DEF、ISASample.RC、Resource.h、StdAfx.cpp和StdAfx.h等一系列文件。 ⑴ISASample.h是CISASampleExtension类的声明。CISASampleExtension类的基类是MFC类库所提供的CHttpServer。基类CHttpServer被用作创建和管理ISAPI serverextensionDLL。我们的开发任务主要是通过CHttpServer的派生类CISASampleExtension来完成的。 ⑵生成的ISASample.DEF具有如下的定义： LIBRARYISASAMPLE EXPORTS HttpExtensionProc GetExtensionVersion TerminateExtension 以上的ISASample.DEF文件中定义了DLL将要输出的3个函数：HttpExtensionProc、GetExtensionVersion和TerminateExtension。程序员可以重写这些被派生来的成员函数内容。Web server在接到ISA的调用请求时将调用HttpExtensionProc方法，HttpExtensionProc可以通过回调函数读取用户数据并完成其他功能。GetExtensionVersion可用来获得ISAPIserverextensionDLL的版本号。GetExtensionVersion及HttpExtensionProc均在CHttpServer中有默认的实现。TerminateExtension为卸载提供了一个安全的途径。 3.定义parsemap ⑴什么是parse map? 通过parse map，可以将用户(浏览器)请求映射到CISASampleExtension类的成员方法。顺便提一句，别忘了CISASampleExtension类是从CHttpServer类派生出来的。MFC为ISAPI的parse map定义了一套宏，具体描述请参阅附表。 ⑵声明parse map 在ISASample.cp