teach_sp_13.htm

VC专题教程 -- 第一章 Internet相关开发 打包下载 --- 1.1 如何编写CGI程序 ------ 1.2 一种更亲切的CGI开发系统WinCGI ------ 1.3 利用ISAPI开

<!-- LANGUAGE='JavaScript'>write_body();<-->
<!-- LANGUAGE='JavaScript'>write_bar();<-->


<table width=98% cellspacing="0" cellpadding="0" align=center><!--整体框架-->
<tr><td>

<table border=0 width="100%" cellspacing="0" cellpadding="2"><!--标记放置区域-->
<tr>
	<td width="30%" align="center" bgcolor="#8E8E8E" valign=middle><img src=../../img/brand_200_60.gif width=200 height=60 alt="LOGO1"></td>
	<td width="70%" align="center" bgcolor="#8E8E8E" valign=middle><!-- LANGUAGE='JavaScript'>write_ban();<--></td>
</tr>
<tr>
	<td colspan="2" bgcolor="#939393" align=center><font color=white>您当前位置</font> <a href=../../index.htm><font color=white>首页</font></a> <a href=../index.htm><font color=white>开发教程</font></a> <a href=index.htm><font color=white><font class=engul>Visual C++/MFC</font>专题讲座</font></a> <font color=white>1.3 利用<font class=eng>ISAPI</font>开发<font class=eng>CGI</font>程序</font> <font color=white><!-- LANGUAGE='JavaScript'>write_command();<--></font></td>
</tr>
</table><!--标记放置区域 END-->

<table border=0 width=100% cellspacing="0" cellpadding="0">
<tr bgcolor="#F4F4F4">
<td><!-- article title begin here-->
<br>
<p align=center><big>1.3 利用<font class=eng>ISAPI</font>开发<font class=eng>CGI</font>程序</big></p>
	<table border=0 align=center width=100%>
	<tr><td><small>
<!-- article content begin here-->
<p>ISAPI（Internet Server API）最初是微软为IIS服务器所提供的一种CGI应用开发接口，其主要的目的也是为CGI开发提供好的开发接口，如果不负责的讲ISAPI也可以认为是类似WinCGI的一种开发模式，只不过ISAPI通过映射宏来取得用户表单传送的参数。这一点上和MFC消息映射宏很相似。</p>
<p>当然ISAPI的推出同时还具备了很多其他的特性：
<ul>
<li>ISAPI以DLL动态连接库的方式实现，所以加载较普通的EXE运行程序快，而且系统不会在使用完后马上清除掉DLL在内存中的空间，所以再次使用时会获得更快的速度。</li>
<li>ISAPI在调用者的内部以线程方式运行，所以和CGI进程相比较需要的运行空间也更小。</li>
<li>在同一个DLL中可以集中多个处理函数，并且通过映射宏来指明不同的函数分别对什么样的请求来进行处理。</li>
<li>由于与IIS的集成，所以可以利用ISAPI开发ISAPI过滤器。通过过滤器可以完成例如用户权限检测，数据加密，压缩，日志等功能，IIS服务器的功能也可以通过ISAPI过滤器来得到增强。</li>
</ul>
到目前为止，很多非M$的WEB服务器也都添加了对ISAPI的支持。
</p>
<p>在同一个DLL中可以集中多个处理函数，所以执行ISAPI的请求和执行普通CGI的请求有一点区别，在URL中需要填写如下形式http://.../cgi-bin/test.dll?function_name&name=xxx&email=yyy，function_name表示的就是功能名称，为了能够正确处理你必须将其映射到DLL中的一个处理函数上。对与未映射的功能都将由一个默认函数处理。</p>

<p>VC4.2以上版本为创建一个ISAPI程序提供了向导程序，在新建工程时选择ISAPI Extension Wizard并在以后的对话框中选择创建服务器扩展和输入相关的信息就可以了。</p>
<p>一个最简单的ISAPI程序至少包含了一个由CHttpServer类所派生的新类，并且在该类中进行了基本的映射，重载了BOOL GetExtensionVersion(HSE_VERSION_INFO* pVer)函数和提供了形式如void Default(CHttpServerContext* pCtxt)的成员函数。幸运的是向导程序已经为我们做好了这一切并创建了最基本的代码。</p>
<p>Default函数用于处理没有带参数首先我们修改Default函数中的代码，首先我们该写其中的相关代码成为如下：
<pre>
void CTestisaExtension::Default(CHttpServerContext* pCtxt)
{
	//Print the &ltHTML> &ltBODY> tags.
	StartContent(pCtxt);

	//Print the title.
	WriteTitle(pCtxt);

	*pCtxt << _T("&ltp>演示&lt/p>");
	*pCtxt << _T("&ltp>目前是Default成员函数其作用&lt/p>");

	//Print &lt/HTML> &lt/BODY> tags.
	EndContent(pCtxt);
}
</pre>
然后用以下方式调用：http://.../cgi-bin/test.dll?Default或http://.../cgi-bin/test.dll?。你就会看到输出的HTML页面了。
</p>
<p>
<pre>
&ltFORM ACTION="test.dll?Add" METHOD=POST&gt
&ltINPUT NAME="name"&gt
&ltINPUT NAME="id"&gt
&ltINPUT TYPE=SUBMIT&gt
&lt/FORM&gt
</pre>
上面表单要求用户输入了用户名和ID号，所以传送的数据形式形式应该如同：http://.../test.dll?Add&name=xxx&id=yyy，我们可以通过处理命令映射宏来指明处理命令的函数，然后通过参数映射宏对数据进行分解，分解后的数据将会存放入指定的变量。使用方法为：
<pre>
ON_PARSE_COMMAND(Add, CTestExtension, ITS_PSTR ITS_I4)
ON_PARSE_COMMAND_PARAMS("name id")
</pre>
ON_PARSE_COMMAND宏中需要指明函数名，类名和参数类型列表，ON_PARSE_COMMAND_PARAMS宏中需要根据前一个宏中所列出的参数列表来指明表单中的变量名称列表。最后一步就是定义一个名称与请求URL中?后命令名称相同的成员函数，参数的设置要与ON_PARSE_COMMAND宏中的参数列表定义相符合，在这个例子中为：<br>
void CTestExtension::Add(CHttpServerContext* pCtxt,LPTSTR pszName,int iID)。参数类型列表中可以使用下面的类型后面为该类型的说明：<ul>
<li>ITS_EMPTY 无数据</li>
<li>ITS_PSTR 字符串LPCSTR</li>
<li>ITS_I2 short</li>
<li>ITS_I4 long</li>
<li>ITS_R4 float</li>
<li>ITS_R8 double</li>
</ul>
</p>
<p>下面我们看一个更复杂的表单，表单定义如下：
<pre>
&ltFORM ACTION="test.dll?Delete" METHOD=POST&gt
&ltINPUT NAME="name"&gt
&ltINPUT NAME="month"&gt
&ltSELECT NAME="mode"&gt
	&ltOPTION VALUE=1&gtAll
	&ltOPTION VALUE=2&gtBefore
	&ltOPTION VALUE=3&gtAfter
&ltINPUT TYPE=HIDDEN NAME=pwd VALUE=xxx&gt
&ltINPUT TYPE=SUBMIT&gt
&lt/FORM&gt
</pre>
定义映射和处理函数如下：<pre>
ON_PARSE_COMMAND(Add, CTestExtension, ITS_PSTR ITS_I4 ITS_I4 ITS_PSTR)
ON_PARSE_COMMAND_PARAMS("name month mode pwd")
void CTestExtension::Add(CHttpServerContext* pCtxt,LPTSTR pszName,int iMonth,int iMode,LPTSTR pszPwd)。
</pre>
</p>
<p>ISAPI程序的输出：在所有的命令处理函数中第一个参数都是CHttpServerContext*指针，我们所有的输出都要通过它进行，在CHttpServerContext类中定义了&lt&lt操作符，通过该操作符我们可以方便的输出字符串，数字，二进制数据。输出的方法为：
<pre>
*pCtxt<<"this is a string";
*pCtxt<<'c';
*pCtxt<<10;
</pre>
可以看得出输出是很简单的，一个完整的输出过程应该是如同下面的形式：
<pre>
	StartContent(pCtxt);//开始输出
	WriteTitle(pCtxt);//输出头部信息，相当于输出&ltTITLE&gt
	*pCtxt << "your string";
	EndContent(pCtxt);//结束输出

</pre>
</p>
<p>我们所使用的ISAPI扩展类是由CHttpServer所派生，可以调用CHttpServer::AddHeader来指明返回数据的类型，例如下面的代码演示了输出纯文本：
<pre>
void CTestisaExtension::Default(CHttpServerContext* pCtxt)
{
	AddHeader(pCtxt, "Content-type = text/plain\r\n");
	(*pCtxt) << "Hello world!\r\n"; 
}
</pre>
我们可以重载某些函数来达到加强控制的目的，可重载的函数有以下这些：<ul>
<li>virtual LPCTSTR CHttpServer::GetTitle( ) const;返回&ltTITLE&gt部分信息</li>
<li>virtual BOOL CHttpServer::OnParseError( CHttpServerContext* pCtxt, int nCause );错误处理</li>
<li>virtual void CHttpServer::StartContent( CHttpServerContext* pCtxt ) const;输出&ltHTML&gt&ltBODY&gt部分信息</li>
<li>virtual void CHttpServer::EndContent( CHttpServerContext* pCtxt ) const;输出&lt/BODY&gt&lt/HTML&gt部分信息</li>
<li>virtual void CHttpServer::WriteTitle( CHttpServerContext* pCtxt ) const;输出&ltTITLE&gt&lt/TITLE&gt部分信息</li>
</ul>
</p>
<p>此外我们可以在命令处理函数中利用CHttpServerContext指针来得到CGI中的相关环境变量，在CHttpServerContext中有一个成员变量m_pECB为下面的结构指针。
<PRE>
typedef struct _EXTENSION_CONTROL_BLOCK {
    DWORD     cbSize;                              //IN 该结构长度
    DWORD     dwVersion                            //IN 版本
    HCONN     ConnID;                              //IN 连接上下文
    DWORD     dwHttpStatusCode;                   //OUT 状态码
    CHAR      lpszLogData[HSE_LOG_BUFFER_LEN];    //OUT
    LPSTR     lpszMethod;                          //IN 环境变量REQUEST_METHOD
    LPSTR     lpszQueryString;                     //IN QUERY_STRING
    LPSTR     lpszPathInfo;                        //IN PATH_INFO
    LPSTR     lpszPathTranslated;                  //IN PATH_TRANSLATED
    DWORD     cbTotalBytes;                        //IN CONTENT_LENGTH
    DWORD     cbAvailable;                         //IN
    LPBYTE    lpbData;                             //IN
    LPSTR     lpszContentType;                     //IN CONTENT_TYPE
...其他信息在此忽略
} EXTENSION_CONTROL_BLOCK, *LPEXTENSION_CONTROL_BLOCK;</PRE>
</p>
<!-- article content end-->
<p align=center><a href=index.htm#charpter1>返回</a></p>
	</td></tr>
	</table>
<p align=center><small>版权所有 闻怡洋 <a href=http://www.vchelp.net/><font class=engul>http://www.vchelp.net/<font></a></small></p>
</td>
</tr><!-- article title end-->
</table>

</td></tr></table><!--整体框架 END-->




<!-- LANGUAGE='JavaScript'>write_tail();<-->