009.htm

Delphi书籍--Delphi网上教程

MAXLENGTH=&quot;25&quot; SIZE=25&gt; <br> 
&lt;P&gt; <br> 
&lt;INPUT TYPE=SUBMIT VALUE=&quot;Submit&quot; NAME=&quot;GetSquare&quot;&gt; <br> 
&lt;/FORM&gt; <br> 
<br> 
&nbsp;&nbsp;&nbsp; 
这段代码会产生一个包含一个供您输入数字的文本区和一个叫做“submit”按钮的窗体，按钮的名字叫做“GetSquare”。如果有了这个窗体，接着您可以预计上面的两段程序会返回如下的字符串，假设用户在窗体中的文本区输入了数字23： 
<br> 
<br> 
lpbData = GetSquare=23&amp;GetSquare=Submit <br> 
<br> 
&nbsp;&nbsp;&nbsp; 
为了理解这时究竟发生了什么，注意一下从上面函数中摘录HTML语句中的主体部分， 
这部分语句驻留在服务器上，反映如下： <br> 
<br> 
'&lt;BODY&gt;lpbData = %s &lt;/BODY&gt;' + <br> 
<br> 
&nbsp;&nbsp;&nbsp; 如果您研究过上面 HttpExtensionProc 
函数中的代码，您会发现就在这句之前，它使用了 Format 语句中的 %s 
参数来代替了 ECB.lpbData 中的值。（如果您不清楚语句Format 
是怎样工作的，请参阅有关的 Delphi 文档）[注：在作者所著的 Delphi2 
编程大全（Delphi2 <br> 
Unleashed）中的第三章《字符串与文本文件》中有详细说明（译者）] <br> 
<br> 
&nbsp;&nbsp;&nbsp; 
假设上面所示的窗体中，当用户按下“确认”按钮时，lpbData 传递给ISAPI 
DLL的值是： <br> 
<br> 
GetSquare=23&amp;GetSquare=Submit <br> 
<br> 
&nbsp;&nbsp;&nbsp; 
为了让您有清晰的概念，让我重复一下上面两个语句传回给浏览器的信息是下面的字符串，您已经看过了： 
<br> 
<br> 
<br> 
lpbData = GetSquare=23&amp;GetSquare=Submit <br> 
<br> 
&nbsp;&nbsp;&nbsp; 观看这个过程的最好办法试运行下面列出的 ISAPI2 
程序。 ISAPI2 和ISAPI1 差不多，但他包含了上面显示的新的 
HttpExtensionProc 函数，并且它还包含了SetUpResString 这个实用函数。 <br> 
<br> 
library Isapi2; <br> 
<br> 
uses <br> 
Windows, SysUtils, HTTPExt; <br> 
<br> 
function GetExtensionVersion( var Ver: THSE_VERSION_INFO ): <br> 
BOOL; stdcall; <br> 
begin <br> 
Ver.dwExtensionVersion := $00010000; // 1.0 support <br> 
Ver.lpszExtensionDesc := 'DLL written in Delphi 2.0'; <br> 
Result := True; <br> 
end; <br> 
<br> 
function SetUpResString: string; <br> 
begin <br> 
Result := '&lt;HTML&gt;' + <br> 
'&lt;TITLE&gt;Test server result&lt;/TITLE&gt;' + <br> 
'&lt;H1&gt;Test server results&lt;/H1&gt;' + <br> 
'&lt;BODY&gt;lpbData = %s &lt;/BODY&gt;' + <br> 
'&lt;/HTML&gt;'; <br> 
end; <br> 
<br> 
function HttpExtensionProc( var ECB: TEXTENSION_CONTROL_BLOCK ): <br> 
DWORD; stdcall; <br> 
var <br> 
ResStr: string; <br> 
StrLen: Integer; <br> 
S, S1: string; <br> 
Len: Integer; <br> 
begin <br> 
ECB.lpszLogData := 'Delphi DLL Log'; <br> 
ECB.dwHTTPStatusCode := 200; <br> 
ResStr := SetUpResString; <br> 
S := PChar(ECB.lpbData); <br> 
ResStr := Format(ResStr, [S]); <br> 
StrLen := Length(ResStr); <br> 
ECB.WriteClient(ECB.ConnID, Pointer(ResStr), StrLen, 0); <br> 
Result := HSE_STATUS_SUCCESS; <br> 
end; <br> 
<br> 
<br> 
exports <br> 
GetExtensionVersion, <br> 
HttpExtensionProc; <br> 
<br> 
begin <br> 
end. <br> 
<br> 
&nbsp;&nbsp;&nbsp; 一旦您从窗体中获得了由 lpbData 
变量传来的信息，您就能分析这些信息或者把它们返回给用户。比如说，您可以从上面例子中把数字23抽出来，做平方后返回用户。通过这样做可以使您从用户中获得信息，在这里是数字，对数字进行一些数学运算，最后把结果返回给用户。这意味着您可以在电波中创建互动的网页，这可是现在因特网编程中最流行的哦！ 
<br> 
&nbsp;&nbsp;&nbsp; 
以下是一个通过网络提交数字平方给浏览器的完整的程序代码： <br> 
<br> 
library Isapi3; <br> 
<br> 
{ This code shows how to take input from the user via a browser, parse that information, 
and then return an answer to the user. In particular, the user submits a number, this code 
squares it, and then sends the result back to user. Here is the form from the browser that 
submits the information for parsing: <br> 
<br> 
&lt;FORM ACTION=&quot;/scripts/mystuff/isapi2.dll&quot; METHOD=&quot;POST&quot; <br> 
ENCTYPE=&quot;application/x-www-form-urlencoded&quot;&gt; <br> 
<br> 
&lt;P&gt; <br> 
Enter Number to Square: &lt;INPUT NAME=&quot;GetSquare&quot; VALUE=&quot;&quot; <br> 
MAXLENGTH=&quot;25&quot; SIZE=25&gt; <br> 
&lt;P&gt; <br> 
&lt;INPUT TYPE=SUBMIT VALUE=&quot;Submit&quot; NAME=&quot;GetSquare&quot;&gt; <br> 
&lt;/FORM&gt; <br> 
<br> 
} <br> 
<br> 
uses <br> 
Windows, SysUtils, HTTPExt, <br> 
StrBox; <br> 
<br> 
function GetExtensionVersion( var Ver: THSE_VERSION_INFO ): <br> 
BOOL; stdcall; <br> 
begin <br> 
Ver.dwExtensionVersion := $00010000; // version 1.0 support <br> 
Ver.lpszExtensionDesc := 'ISAPI3.DLL'; <br> 
Result := True; <br> 
end; <br> 
<br> 
// Parse lpbData and retrieve the number the user passed to us. <br> 
function ParseData(S: string): Integer; <br> 
begin <br> 
S := StripLastToken(S, '&amp;'); <br> 
S := StripFirstToken(S, '='); <br> 
Result := StrToInt(S); <br> 
end; <br> 
<br> 
function SetUpResString: string; <br> 
begin <br> 
Result := '&lt;HTML&gt;' + <br> 
'&lt;TITLE&gt;Test server result&lt;/TITLE&gt;' + <br> 
'&lt;H1&gt;Test server results&lt;/H1&gt;' + <br> 
'&lt;BODY&gt;Answer = %d &lt;/BODY&gt;' + <br> 
'&lt;/HTML&gt;'; <br> 
end; <br> 
<br> 
function HttpExtensionProc( var ECB: TEXTENSION_CONTROL_BLOCK ): <br> 
DWORD; stdcall; <br> 
var <br> 
ResStr: string; <br> 
StrLen: Integer; <br> 
S, S1: string; <br> 
Num: Integer; <br> 
begin <br> 
ECB.lpszLogData := 'Delphi DLL Log'; <br> 
ECB.dwHTTPStatusCode := 200; <br> 
ResStr := SetUpResString; <br> 
S := PChar(ECB.lpbData); <br> 
Num := ParseData(S); <br> 
Num := Sqr(Num); <br> 
ResStr := Format(ResStr, [Num]); <br> 
StrLen := Length(ResStr); <br> 
ECB.WriteClient(ECB.ConnID, Pointer(ResStr), StrLen, 0); <br> 
Result := HSE_STATUS_SUCCESS; <br> 
end; <br> 
<br> 
<br> 
exports <br> 
GetExtensionVersion, <br> 
HttpExtensionProc; <br> 
<br> 
begin <br> 
end. <br> 
<br> 
<br> 
这段代码从按下确认按钮的用户那里接受下面的字符串，用户要求平方后的数字： 
<br> 
<br> 
<br> 
GetSquare=5&amp;GetSquare=Submit <br> 
<br> 
假设这样输入，这段代码会通过因特网返回用户下面的字符串： <br> 
<br> 
Answer = 25 <br> 
<br> 
&nbsp;&nbsp;&nbsp; 一句话，用户输入数字5，你返回用户数字25。如果用户提交数字10，那么您返回数字100。这看起来微不足道，但在这里重要的是因特网上发生的行为[注：指互动网页（译 
<br> 
者）] <br> 
<br> 
分析用户传来的函数像这样： <br> 
<br> 
// Parse lpbData and retrieve the number the user passed to us. <br> 
<br> 
function ParseData(S: string): Integer; <br> 
begin <br> 
S := StripLastToken(S, '&amp;'); <br> 
S := StripFirstToken(S, '='); <br> 
Result := StrToInt(S); <br> 
end; <br> 
<br> 
<br> 
&nbsp;&nbsp;&nbsp; 
这两个语句在单元中，在本文开头提到过，也包含在我的站点上。［注:这个文件在网络上几乎到处可见,您也可以向译者索取(译者)］[ 
在本篇文章中,关于ISAPI我只想谈这么多了。这些内容对于启发您利用这项优越的技术并获得乐趣来说应该是够用的了。接下来我要谈一下 
GetServerVariable 、 ReadClient 
这两个语句，在这方面我只进行了极其有限的试验。在本文中，我附加了HTTPEXT.PAS 
文件，因为除了这分关键文档，在其他地方您不会找到它。 <br> 
<br> 
GetServerVariable 和 ReadClient 语句 <br> 
<br> 
&nbsp;&nbsp;&nbsp; 正如您的CGI应用程序中的请求信息一样，您可以使用语句来从服务器上获得信息。 
下面是呼叫这个语句的例子： <br> 
<br> 
Len := HseMaxExtDllNameLen; <br> 
SetLength(S1, Len); <br> 
Dec(Len); <br> 
ECB.GetServerVariable(ECB.ConnID, <br> 
'CONTENT_LENGTH', <br> 
PChar(S1), <br> 
Len); <br> 
<br> 
&nbsp;&nbsp;&nbsp; 
首先，这段代码设定了保留从服务器上取得的信息的缓冲区的长度。接着它呼叫服务 
器并发出请求，在本例中，它要求获得服务器传来的信息的&quot;CONTENT_LENGTH&quot;。 
<br> 
<br> 
&nbsp;&nbsp;&nbsp; 微软公司的文献告诉我们，您可以通过 GetServerVariable 
的第二个参数来传递跟 着的字符串： <br> 
<br> 
&nbsp;&nbsp;&nbsp; AUTH_TYPE 
它包含了使用授权的类型。比如，如果使用的是基本（basic）授权，那么 
<br> 
字符串就是&quot;basic&quot;；如果是 NT challenge 回应，字符串就是&quot;NTLM&quot;。其他的授权属尤其对应的字符串。因为不断有新的授权类型被增添到服务器上，列出所有可能的字符串是不可行的。如果字符串为空，那么并没有使用任何授权。 
<br> 
<br> 
CONTENT_LENGTH 脚本预计从客户端回收到的字节数。 <br> 
CONTENT_TYPE 由请求布告的主体部分提供的信息的内容类型。[注：小弟才疏学浅，a 
<br> 
POST request 暂译作&quot;请求布告&quot;，望方家指正（译者）] <br> 
PATH_INFO 
附加的路由信息，由客户机提供。它包含了跟在脚本名字之后的URL的漫游路 
<br> 
由。如果有的话，它在请求字符串的前面。 <br> 
PATH_TRANSLATED 它是 PATH_INFO 
的值，但包含了扩充到一个路径标志的所有虚拟路由的名字。 <br> 
QUERY_STRING 跟在参考这个脚本的URL中的&quot;？&quot;后面的信息。 <br> 
REMOTE_ADDR 发出请求的客户机或其代理商（例如，网关或防火墙）的IP地址。 
<br> 
REMOTE_HOST 
发出请求的客户机或其代理商（例如，网关或防火墙）的主机名。 <br> 
REMOTE_USER 
它包含了由客户机提供并且由服务器授权的用户名。如果返回空串那么用户 
<br> 
使你名的（但是经过授权）。 <br> 
UNMAPPED_REMOTE_USER 它是有如下特征的用户的名称：该用户向NT用户帐目发出请求（这是他以身份出现），在此之前ISAPI应用程序过滤起映射了该用户。 
<br> 
REQUEST_METHOD 是 HTTP 请求方法。 <br> 
SCRIPT_NAME 执行的脚本程序名称。 <br> 
SERVER_NAME 当它以自参考URLs形式出现时的主机名或IP地址。 <br> 
SERVER_PORT 接受请求的TCP/IP的端口。 <br> 
SERVER_PORT_SECURE 一个非0即1的字符串。当请求由安全端口处理时，它是1；否则是0 
<br> 
。 <br> 
SERVER_PROTOCOL 
接受与这个请求相关的协议的信息的名称和版本。他通常是 HTTP/1.0 <br> 
。 <br> 
SERVER_SOFTWARE 是ISAPI应用DLL程序运行时所在的网页服务器的名称和版本。 
ALL_HTTP 先前的变量并没有分析全部的HTTP字段头。这些变量从HTTP_&lt;字段头名&gt;中得出 
。字段头（由行标分离）包含了各自的字符串，这些字符串并不会终止。 
<br> 
<br> 
HTTP_ACCEPT HTTP字段头的特例。接受的值是：字段由逗号（，）分离。例如：如果下 
<br> 
面的几行是HTTP头的一部分： <br> 
接受：*/*，q=0.1 <br> 
则URL（2.0新版本的特性）给出它的基础部分。 <br> 
<br> 
&nbsp;&nbsp;&nbsp; 要注意的是，上面给出的信息片是由 TExtensionControlBlock 
纪录自动传递的。因 <br> 
此您不需要调用GetServerVariable。不过，如果您确有需要，特别是您要从ReadClient 
中获得信息和需要知道要读入多少信息时，您可以调用它。 <br> 
<br> 
&nbsp;&nbsp;&nbsp; 在很多时候，您不需要调用 ReadClient 
。但是，您浏览器发出的信息量大于48KB <br>的时候，您需要调用 ReadClient 来获取其余的信息。<p>&nbsp; </p> 
<hr color="#EE9B73" size="1" width="94%"> 
 
</TD> 
 
</TR> 
</table> 
</BODY></HTML>