使用MFC开发ISAPI Extensions程序Word文档格式.docx
《使用MFC开发ISAPI Extensions程序Word文档格式.docx》由会员分享，可在线阅读，更多相关《使用MFC开发ISAPI Extensions程序Word文档格式.docx（13页珍藏版）》请在冰豆网上搜索。
----ISAPI使用动态链接库DLL而不是可执行代码。
这些DLLs被装
入到服务器的内存空间。
由于代码在内存中缓存起来了，而
不是每次接收到请求时再装入到内存中，因此这一技术极
大地提高了交互式的Web应用程序的性能。
----ISAPI程序分为两种：
一种就是我们要介绍的ISAPIExtensions，
它提供了一种比CGI更好的实现方法；
另一种称作ISAPIFilter，
它可以对服务器上进入或出去的数据进行过滤。
----总的来说，ISAPI优于CGI之处包括：
----①速度快：
ISAPI在性能上有很大的提高；
----②功能强：
ISAPI还可以创建Filter以对数据进行预处理。
并且它完全与MFC集成在一起了。
----相反，ISAPI的不足之处有：
----①标准化不够：
目前只有一部分服务器支持ISAPI；
----②开发困难：
相关资料很少，并且调试很麻烦。
----1．2ISAPI基础
----ISAs开发主要基于MFC的CHttpServer类。
该类控制了所有与
服务器的交互操作，同时还包含了用于客户请求的所有函
数。
尽管一个ISA只能有CHttpServer类的一个实例，但每个ISA仍
然可以同时处理多个请求。
这是通过CHttpServer类为每个请求
创建一个CHttpServerContext类来实现的。
CHttpServerContext类包含
了每个特定请求的所有数据以及由ISA返回到客户的所有HTML
代码。
----ISAPIDLLs的调用方法和CGI一样：
在客户端使用GET或POST方
法。
例如，当客户作出下列请求时：
----
----"
name"
域和"
id"
域以及与它们相关的数据都被传递给ISA。
ISAPI在使用这些相关的数据之前把它们存放在相应的数据
结构中，这是通过一个请求映射系统来实现的。
----每一个请求都有一个解析映射表。
通过定义服务器从
客户接收的数据的类型和顺序，该解析映射表可以把数据
传递到合适的数据结构中。
例如，对于请求"
name=fisherman&
id=12345"
，
解析映射表将显示一个字符串和一个整型数，并且
"
fisherman"
and"
12345"
将被解析出来存放到各自的数据结构中。
----解析映射系统还有另外一个功能：
ISAPI可以把请求传递
给ISA内特定的成员函数。
请求字符串可以包含一个命令，解
析映射表就使用该命令把请求传递给ISA内正确的成员函数。
----由于ISAPI使用命令驱动机制来处理请求，因此在开始开
发ISA程序时可能会觉得有些麻烦，但是一旦学会了，用户
就会发现这是一个非常强大的处理请求的方法。
----2．使用MFC开发ISA程序
----2．1建立工程
----开发ISA的第一步工作是建立一个工程。
和创建其
它VisualC++（VC++）工程一样，创建ISA也有一个wizard来指导用
户完成初始的步骤。
打开VC++，在File菜单中选择New，然后在
对话框中选择Projects面板，在下面的列表中选择"
ISAPIExtension
Wizard"
工程类型，选择适当的路径，并把它命名为"
HelloWeb"
，
如图1所示。
图１ New对话框
----接着选择Ok按钮，于是出现一个对话框让用户选择预创
建的ISAPI程序类型，缺省情况下是ISA程序，同时MFC被设置为
动态链接。
如果用户开发的服务器上有了这些MFCDLLs，这当
然是可以的。
但是如果没有安装DeveloperStudio，通常情况下
这些DLLs是没有的，这样用户的ISA将无法运行。
此时应该把
工程设置为静态链接。
我们建议用户这样设置，如图2所示。
图２ ISAPIExtensionwizard对话框
----接着选择Finish按钮。
VC++将显示一个对话框给用户一些
关于新工程的提示信息。
在此对话框中选择OK。
----现在工程已经创建好了，现在该处理一些复杂点的问题了。
我们在前面提到过，ISA在运行时是IIS的一部分，而IIS又
作为NT的一个服务而运行。
这一事实使用调试过程变得复
杂了，因为在IIS运行时，VC++的调试器不能够接管ISA。
为了
解决这个问题，微软公司以两种形式发行了IIS：
作为一项
服务，以及作为一个单独的可执行程序。
对于后一种情况，
我们就可以在命令行上来控制服务器。
虽然这样可以解决
上述问题并使得开发过程变得容易一些，但实现起来显得
很繁琐。
下面我们来介绍这个过程。
----当用户处于debug调试模式时，VC++（以及IIS）将在用户的
帐号和权限下运行。
由于通常IIS完成的一些工作是不允许
大多数用户有相应的权限的，因此用户（或用户的系统管
理员）需要做以下工作：
----①在桌面上选择“开始\程序\管理工具（公用）\域用户
管理器”,打开域用户管理器；
----②在“规则”菜单中选择“用户权限”；
----③选择“显示高级用户权限”检查框；
----④在“权限”下拉列表中选择“以操作系统方式操作”；
----⑤选择“添加”按钮得到“添加用户及组”对话框，选
择“显示用户”按钮，并在“名称”列表中选择用户使用
的帐号，然后选择“添加”按钮；
----⑥选择“确定”按钮；
----⑦对“产生安全审核”权限重复上述步骤。
----为了使这些设置生效，用户必须先退出登录，然后再登录回来。
----IIS中包含了三项服务：
FTPPublishingService,GopherPublishing
Service和WorldWideWeb。
由于调试器要在命令行上运行IIS，所以
所有这三项服务都必须停止。
这可以通过“控制面板”中的
“服务”程序或者使用IIS的“Internet服务管理器”来实现。
如
果需要进行大量的调试工作，我们建议用户通过“控制面板”
中的“服务”程序来关闭IIS服务并禁止它们自动启动，这样可
以避免用户每次启动计算机时都要进行关闭服务的操作。
----接下来就必须对工程进行一些配置了：
----①在Project菜单中选择Settings菜单项；
----②选择Debug面板，并在Category下拉列表中选择General；
----③在Executablefordebugsession框中输入或者寻找IIS执行文件
的路径（通常情况下位于WINNT\system32\inetsrv\inetinfo.exe）；
----④在Programarguments框中输入-ew3svc，如图3所示；
图３ Debug
面板设置
----⑤选择Link面板；
----⑥在Outputfilename框中输入被编译后的DLL将被放置的路
径和文件名。
这个路径必须位于Web服务器的根目录下或者
某个虚拟目标下，以便客户可以通过URL来访问。
例如，我们
的Web服务器的根目录是c:
\InetPub\wwwroot\，我们把helloweb.dll放
置在该目录下，这样客户就可以使用下面的URL来访问它：
----如果用户现在还没有退出登录以改变权限，请现在行
动，然后再登录回来。
----ISAPIExtensionWizard所产生的缺省代码已经包含了一个
可工作的ISA所需要的一切，虽然该ISA还没有任何功能，
但我们不妨先试着进行编译一下。
----按下F5键以运行ISA，如果弹出对话框问是否创建工程
时选择Yes。
几秒钟之后调试器就已经工作了，此时IIS应该
运行在后台。
现在一切就绪了，用户可以在自己喜欢的浏
览器中输入上面所提到的URL，并在最后面加上一个问号？
如下所示：
----请注意把域名换成正确的值。
----第一次连接到ISA时可能要花几秒钟的时间，此后该DLL
被缓存到了内存中，连接速度就会显著提高。
当DLL被装入
后，在浏览器中应该显示如下信息：
----ThisdefaultmessagewasproducedbytheInternetServerDLLWizard.EdityourCHelloWebExtension:
:
Default（）implementationtochangeit.
----我们的第一个ISA已经工作了。
----2．2分析源代码
----一个ISA包含两个主要组成部分：
解析映射表和命令处
理函数。
----当一个请求来自EXTENSION_CONTROL_BLOCK（此结构用于在服
务器和ISA之间进行通信）时，它被传递到命令解析映射表。
解析映射表由一些宏组成，如HelloWeb工程（HELLOWEB.CPP）中的：
BEGIN_PARSE_MAP（CHelloWebExtension,CHttpServer）
//TODO:
insertyourON_PARSE_COMMAND（）and
//ON_PARSE_COMMAND_PARAMS（）heretohookupyourcommands.
//Forexample:
ON_PARSE_COMMAND（Default,CHelloWebExtension,ITS_EMPTY）
DEFAULT_PARSE_COMMAND（Default,CHelloWebExtension）
END_PARSE_MAP（CHelloWebExtension）
----BEGIN_PARSE_MAP宏标志着解析映射表的开始，它以ISA
的CHttpServer类和基类作为参数；
ON_PARSE_COMMAND宏则把一个
特定的请求或命令映射到一个命令处理函数中。
它的参数
包括命令处理函数名、函数的类以及请求的格式；
DEFAULT_PARSE_COMMAND宏确定了当请求为空或者与解析映射
表不匹配时调用的函数。
它的参数包括函数名和函数的类。
----命令处理函数是解析映射表中调用的主CHttpServer类
的成员函数。
下面就是HelloWeb工程中的Default命令处理函数：
voidCHelloWebExtension:
Default（CHttpServerContext*pCtxt）
{
StartContent（pCtxt）;
WriteTitle（pCtxt）;
*pCtxt<
<
_T（"
ThisdefaultmessagewasproducedbytheInternet"
）;
_T
（"
ServerDLLWizard.EdityourCHelloWebExtension:
Default（）"
implementationtochangeit.\r\n"
EndContent（pCtxt）;
}
----当请求为空或者包含Default时此函数被调用。
首先它
通过参数得到请求的CHttpServerContext（命令处理函数的第
一个参数必须是一个CHttpServerContext），StartContent把<
HTML>
<
BODY>
标志放到pCtxt中，然后WriteTitle放置<
TITLE>
标志。
紧接着下面
的三行语句把缺省的消息写入pCtxt，后者指向一个CHtmlStream类。
当ISA结束时，该HTML流缓冲区被发送到客户端。
----2．3修改HelloWeb
----下面我们将把缺省的消息换成"
我会编ISAPI程序了！
。
----找到CHelloWebExtension类的成员函数Default，修改成如下形式：
voidCHelloWebExtension:
----然后按照前面方法编译并运行该DLL，并在浏览器中重装
或者刷新URL，用户即可看到显示的消息已经变了。
----然而，如果用户看到"
ServerError500:
Specifiedmodulenotfound."
这样的错误信息，则表示用户的工程是动态链接的，而所必
需的DLLs不存在。
为了修正这个错误，需要到Project菜单中选
择Settings命令，然后选择General面板，在MicrosoftFoundationClasses
下拉列表种选择UseMFCinaStaticLibrary，然后重新编译该工程。
----３．深入理解ISA编程
----３．１ 进一步分析解析映射表
----在解析映射表中使用了五个宏：
----BEGIN_PARSE_MAP：
开始解析映射表的定义；
----ON_PARSE_COMMAND：
解析客户的命令；
----ON_PARSE_COMMAND_PARAMS：
把请求的数据映射到相应的数
据结构中；
----DEFAULT_PARSE_COMMAND：
定义缺省命令；
----END_PARSE_MAP：
结束解析映射表的定义。
----我们在来看一看HelloWeb中的解析映射表：
BEGIN_PARSE_MAP（CHelloWebExtension,CHttpServer）
//TODO:
insertyourON_PARSE_COMMAND（）and
//ON_PARSE_COMMAND_PARAMS（）heretohookupyourcommands.
//Forexample:
ON_PARSE_COMMAND（Default,CHelloWebExtension,ITS_EMPTY）
DEFAULT_PARSE_COMMAND（Default,CHelloWebExtension）
END_PARSE_MAP（CHelloWebExtension）
----此映射表定义了两个命令：
一个空的请求和缺省
的Default命令。
空的请求格式如下：
----它是由DEFAULT_PARSE_COMMAND宏处理的。
----然而，如果Default命令放在了问号
升级会员 