ITPub博客

首页 > Linux操作系统 > Linux操作系统 > 创建ISAPI扩展(转)

创建ISAPI扩展(转)

原创 Linux操作系统 作者:jcszjswkzhou 时间:2019-03-11 13:45:04 0 删除 编辑
创建ISAPI扩展: 好了,现在让我们看一下我们的第一个ISA。这个例子中将利用ISAPIExtension Wizard(ISAPI扩展向导)来创建一个简单的ISAPI扩展。全部目的在于让你熟悉概念并介绍一些使用ISAPI的技术。例子程序接收来自客户机的一个串,稍作修改,然后用一个新页显示客户机发送来的这个串。下面介绍的过程将带着你一步步地创建示例ISA。你可以使用同样的过程来做需要创建的任何ISA扩展。我们假定你已经启动Visual C++ 并且使用的是6.0版。
WEB链接 在创建自己的ISAPI扩展或过滤器时,最好的资源就是其它程序员编写的免费软件。alt.comp.freeware新闻组中列出了相当多的这样的软件。例如,在写本书的时候,AAIT Incorporated就推出了一个新的免费软件,称为CGI Expert(CGI专家)。它同时支持CGI、Win-CGI、ISAPI以及NSAPI接口。显然谁都想用免费产品,但是就像使用其它产品一样,一定要小心。不过它们确实对如何创建自己的定制扩展提供了极好的想法(或者可以提供一种解决方案使得你自己不必去编程了)。
1. 使用File(文件)|New(新建)命令显示如下图所示的New(新建)对话框。请注意,我已经选择了ISAPI Extension Wizard(ISAPI 扩展向导)。

2. 在工程名称域中键入想创建的ISA的名字。这个例子中使用的是DispStr,不过可以使用你想使用的任何名称。
3. 单击OK,就会看到如下图所示的ISAPI Extension Wizard(ISAPI扩展向导)Step 1 of 1(第一步)对话框。在这里可以为你的ISA选择各种特性。注意对话框中有三个主要区域。选中第一个复选框,就可以创建过滤器;选中第二个复选框,就可以创建扩展。第三个区域定义如何将MFC与你的应用程序链接起来。

4. 选中扩展选项,而不是过滤器选项。在Extension Description (扩展描述)域中,你应对你的ISA提供简短扼要的说明。该说明将以一个字符串的形式出现,你可在DLL中需要时使用它。当某人打开你的ISA的Properties(属性)对话框时,该说明并不出现在对话框中,所以需要给DLL的版本信息再添加点附加文本。
5. 在Extension Description(扩展描述)域输入Display a string from the client(显示来自客户机的串)。
6. 单击Finish(完成)就会看到如下图所示的New Project Information (新建工程信息)对话框。

7. 单击OK,ISAPI Extension Wizard(ISAPI 扩展向导)就完成了所需的程序框架的创建。
现在,为了使扩展具有实用功能,还要对ISAPI Extension Wizard(ISAPI 扩展向导)创建的框架做三件事。首先是为添加的新函数创建一个分析映射 ( Parsemap) 。在DispStr.cpp文件的顶部可以找到该分析映射。程序列表13.1 列出了应该给该分析映射加入的代码,以便我们能够从HTML页面访问这个新增函数。

尽管只需要增加两行代码就能使这个例子工作,但我们真正关心的却是下面三行代码。ON_PARSE_COMMAND()宏允许定义一个新函数。注意,应提供函数名、所提供函数所在的类以及该函数使用的参数的类型。ON_PARSE_COMMAND()宏需要一个参数项,尽管你实际上可能并不需要任何参数就能使该函数正常运行。注意,因为缺省函数不需要任何参数,所以使用了ITS_EMPTY值。由于我们的新函数,DispStr棗需要一个字符串指针,所以它带有一个参数ITS_PSTR。
然后下一行是ON_PARSE_COMMAND_PARAMS()宏。你必须告诉VisualC++如何处理你的函数的参数。例如,如果我们想强制用户为函数提供一个串值,就应在ON_PARSE_COMMAND_PARAMS()宏中,简单的放上String。因为实际上并不一定要求用户提供一个字符串才能使用函数工作,所以这里提供了一个缺省值 。注意如果你需要一个参数而用户没有提供的话,查询就会失败。最后还要用DEFAULT_PARSE_COMMAND() 宏告诉Visual C++用哪个函数作为缺省函数。由于这个例子的Default函数挺合适,所以就没有更改这个缺省的设置。
其次,你需要给DispStr.H文件增加一个函数项。除非通过修改类说明来包含你的新函数,否则Visual C++对此将会一无所知,于是DLL也不会被编译。幸运的是,我们只要增加程序列表13.2中黑体显示的那一行代码就可以了。程序列表13.2列出了该行代码周围的代码行,以便于你知道新的一行应添加在什么地方。


可以看出,增加函数调用声明很简单。不过现在你可能还不清楚声明的CHttpServerContext* pCtxt部分是从哪里来的。我们确实没有在前面的任何分析映射宏中对它进行说明。实际上 pCtxt 参数是缺省地传递给函数的。记住前面已经介绍过CHttpServer类可以为每个用户请求创建一个CHttpServerContext对象,这就是该参数的来源。你得到的是指向与用户对函数的调用相联的CHttpServerContext对象的指针。这也是对函数的多个调用进行区分的办法──每个调用都有一个完全不同的对象与之相关联。
制作这个DLL函数还剩最后一件事──给DispStr.CPP文件添加函数代码。这个例子是将函数代码放在已有的Default()函数代码之后。程序列表13.3 显示的是这个例子使用的非常短的函数。这里没有什么花里胡哨的东西,其全部目的在于说明如何完成这件任务。


这个函数本身很容易理解。我们做的第一件事是告诉Visual C++启动一个Web页,这就像给文档加入和 标记一样。我们做的第二件事是输出一个标题,就像给文档加入标记一样。重载缺省标题的唯一途径是重载WriteTitle()函数,这是一件想干就能干成的事。现在有了标题,就该创建内容了。需要使用流操作符来发送信息。注意这个例子很轻松自如地使用了第8章介绍的所有标记。对标准HTML 文档能做的事也同样能够对ISAPI扩展做。待会儿将会说明这些标记是如何一起工作从而产生了Web页的。另外还应注意我们将从Web页得到的字符串发送回新Web页,甚至不必将值转换为文本,就可以使它们工作了。这个例子中使用的最后一个函数调用是EndContent(),它告诉Visual C++已经完成发送信息的任务了,这就象在文档末尾加上</HTML>一样。<br /> 现在你就可以编译我们创建的ISAPI扩展了。一旦编译成功,就可以将DLL移到Web 服务器上。有好几个逻辑位置可以存放该DLL,不过最常用的两个位置是Scripts目录或一个特殊的Controls目录。我通常将自己的所有控件都放在Controls目录中以便于查找,不过实际的存放位置并不重要。唯一的原则是用户应该能够通过Web站点来访问包含该DLL的目录,而且你应该用Web服务器提供的Internet服务管理器将该目录标记为可执行的。<br> <p style="clear:both;"></p> <p class="translate"> 来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/10294527/viewspace-123234/,如需转载,请注明出处,否则将追究法律责任。 </p> </div> </div> <div class="preview-footer clearfix"> <!--已点赞、收藏--> <div class="icon-praise" id="praise" onclick="blogObj.praise($(this),'/praise/')"><span class="text"></span><span class="num">0</span></div> <div class="icon-collect" id="collect" onclick="blogObj.praise($(this),'/favour/')"><span class="text"></span><span class="num">0</span></div> <div class="share-group fr"> <div class="bdsharebuttonbox bdshare-button-style0-16" data-bd-bind="1522216707615"> <span class="fl">分享到:</span> <a href="javascript:;" class="bds_tsina" data-cmd="tsina" title="分享到新浪微博"></a> <a href="javascript:;" class="bds_sqq" data-cmd="sqq" title="分享到QQ好友"></a> <a href="javascript:;" class="bds_qzone" data-cmd="qzone" title="分享到QQ空间"></a> <a href="javascript:;" class="bds_weixin" data-cmd="weixin" title="分享到微信"></a> </div> <script> window._bd_share_config = { "common": { "bdSnsKey": {}, "bdText": "", "bdDesc": "", "bdMini": "", "bdMiniList": false, "bdPic": "", "bdStyle": "0", "bdSize": "32" }, "share": {"bdSize": 16} }; with (document) 0[(getElementsByTagName('head')[0] || body).appendChild(createElement('script')).src = 'http://bdimg.share.baidu.com/static/api/js/share.js?v=89860593.js?cdnversion=' + ~(-new Date() / 36e5)]; if ($(window).width() < 1320) { if ($(window).width() < 1200) { $(".sideslip").css({ "left": "20px", "margin-left": 0 }) } else { $(".sideslip").css({ "margin-left": "-590px" }) } }</script> </div> </div> <div class="article-context"> <div class="fl"> <span class="color77">上一篇:</span> <a href="http://blog.itpub.net/10294527/viewspace-123232/">创建ISAPI过滤器(转)</a> </div> <div class="fr"> <span class="color77">下一篇:</span> <a href="http://blog.itpub.net/10294527/viewspace-123235/">ISAPI概述(转)</a> </div> </div> <input type="hidden" id="blogId" value="123234"> <!--评论开始--> <div class="blog-comment"> <div class="new-comment"> <input type="hidden" id="hid" name="hid" value="123234"> <input type="hidden" name="_token" value="72kapD6v09Q1kLyqLYs3nhZ5MtT6jcdrYEymiS4T"> <a class="avatar" href="javascript:;"> <img src="http://blog.itpub.net/images/user_pic_default.png"></a> <!--用户未登录--> <div class="sign-container"> <span>请登录后发表评论</span> <a class="btn btn-sign"> <a class="layui-btn ml30" onclick="blog.login(event)">登录</a> </a> </div> <!--用户已登录--> <textarea placeholder="请写下你的评论…" onfocus="blogObj.textareaFocus($(this),200)" maxlength=200></textarea> </div> <div class="comment-list"> <div class="top-title"><span class="all-comment">全部评论</span> <span class="colorbb ml20"></span> </div> <div class="comment-items" id="comment_items"> <script type="text/template" id='blog_template'> <%for(var i=0;i <items.length;i++){%> <div class="comment-item"> <div class="author"> <a target="_blank" href="/<%=items[i].uid%>" class="avatar"> <img src="<%=items[i].headimg%>" alt=""> </a> <div class="info"> <div class="name"><a target="_blank" href="/<%=items[i].uid%>"><%=items[i].username%></a> <span class="fr reply-btn" onclick="blogObj.newComment($(this),'<%=items[i].username%>',<%=items[i].id%>)">回复</span></div> <div class="time colorbb"><%=items[i].createtime%></div> </div> </div> <p class="comment-wrap"><%=items[i].content%></p> <%if(items[i].items.items.length) { %> <div class="sub-comment-list"> <%for(var j=0;j<items[i].items.items.length;j++){%> <div class="sub-comment"> <div class="color77 time-reply"> <span class="time"><%=items[i].items.items[j].createtime%></span> <span class="reply-btn fr" onclick="blogObj.newComment($(this),'<%=items[i].items.items[j].username%>',<%=items[i].items.items[j].id%>)">回复</span> </div> <p><a href="/<%=items[i].uid%>"><%=items[i].items.items[j].username%></a>   回复   <a href="/<%=items[i].touid%>"><%=items[i].items.items[j].tousername%></a>: <span class="content"><%=items[i].items.items[j].content%></span></p> </div> <%}%> <%if(items[i].items.total > 5) { %> <div class="more-comment"><span class="sub-comment-count">还有<i class="count"><%=items[i].items.total-5%></i>条评论</span><span class="more-comment-btn" onclick=blogObj.loadSubComment($(this),<%=items[i].id%>) data-count=1 data-flag=true>点击查看</span></div> <%}%> </div> <%}%> </div> <%}%> </script> </div> </div> </div> <!--评论结束--> </div> <script> </script> <div class="fr w290"> <!--作者信息开始--> <!--作者信息开始--> <div class="author-info right-fixed "> <div class="head-img"> <a href="http://blog.itpub.net/10294527/"><img src="http://account.itpub.net/api/avatar.php?uid=10294527" alt=""></a> </div> <div class="author-name"><a href="http://blog.itpub.net/10294527/">jcszjswkzhou</a></div> <div class="author-intro"> </div> <p class="register-time"><span class="color77">注册时间:</span>2007-08-29</p> <ul class="tree-list clearfix"> <li> <div class="item-tt">博文量</div> <a href="http://blog.itpub.net/10294527/"><span class="item-num blognum">3488</span></a> </li> <li> <div class="item-tt">访问量</div> <div class="item-num blogviewnum">2603049</div> </li> </ul> </div> <!--作者信息结束--> <script> var data = {uid: 10294527}; $._ajax({ url: '/getAuthorInfo/', data: data, type: 'get', dataType: 'json', success: function (data) { if (data.code == 200) { var data = data.data; $(".blognum").text(data.blognum); $(".blogviewnum").text(data.visitednum); } } }); </script> <!--作者信息结束--> <!--博文推荐开始--> <div class="blog-choice right-fixed"> <h3 class="choice-title">最新文章</h3> <ul class="newul"> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-127034/" class="clearfix"> MIDP对应的设备特性(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-122469/" class="clearfix"> Tomcat5配置Mysql JDBC数据库连接池 选择自 szmarx 的 Blog (转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-126233/" class="clearfix"> 手机游戏开发综述(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-123130/" class="clearfix"> Oracle数据库访问限制绕过漏洞(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-123452/" class="clearfix"> Windows XP安装盘中隐藏的安全工具(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-123201/" class="clearfix"> 在桌面部署中使用 Virtual Server 2005(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-124342/" class="clearfix"> Intel:没必要对Windows驱动程序缺陷恐慌(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-125121/" class="clearfix"> ADSL常见经典故障大全(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-123132/" class="clearfix"> ORACLE碎片整理(2)(转) </a> </li> <li class="new-item"> <a href="http://blog.itpub.net/10294527/viewspace-121607/" class="clearfix"> 网页中如何获取客户端系统已安装的所有字体?(转) </a> </li> <ul> </div> <!--大牛精选结束--> </div> </div> <div class="icon-back-top" onclick="$('html,body').animate({scrollTop:0},'slow');"></div> <!--main部分结束--> <!--百度推送--> <script> (function(){ var bp = document.createElement('script'); var curProtocol = window.location.protocol.split(':')[0]; if (curProtocol === 'https') { bp.src = 'https://zz.bdstatic.com/linksubmit/push.js'; } else { bp.src = 'http://push.zhanzhang.baidu.com/push.js'; } var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(bp, s); })(); </script> <!--2019-07-20 03:09:21--> <!--footer部分开始--> <div class="blog-footer"> <div class="w1200 pr"> <div class="footer-links"> <a class="icon-blog icon-wx mr30"> <div class="wx-qrcode"> <img src="http://edu.itpub.net/images/qrcode.jpg" alt=""> </div> </a> <a href="https://weibo.com/itpub2001?from=myfollow_all" class="icon-blog icon-wb" target="_blank"></a> </div> <p class="footer-nav"> <a href="http://www.it168.com/bottomfile/it168.shtml" target="_blank">支持我们</a> <a href="http://www.it168.com/bottomfile/tgzn.shtml" target="_blank">作者招募</a> <a href="http://www.it168.com/bottomfile/sytk.shtml" target="_blank">用户协议</a> <a href="http://blog.itpub.net/31509949/viewspace-2157750/" target="_blank">FAQ</a> <a href="http://edu.itpub.net/contactus.html" target="_blank">Contact Us</a> <script src="https://s22.cnzz.com/z_stat.php?id=1274521965&web_id=1274521965" language="JavaScript"></script> </p> <p>北京盛拓优讯信息技术有限公司. 版权所有  <a style="color:#777777;" target="_blank" href="http://beian.miit.gov.cn">京ICP备09055130号-4</a>  北京市公安局海淀分局网监中心备案编号:11010802021510</p> <p>广播电视节目制作经营许可证(京) 字第1234号 中国互联网协会会员</p> </div> </div> <!--footer部分结束--> <script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?5016281862f595e78ffa42f085ea0f49"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script> <!-- END STAT PV --> </body> </html>