DELPHI AND THE INTERNET
by Charlie Calvert
由Boen翻译，转载请注明： Translate by Boen.
中文译稿版权属Boen所有，使用权归 CNM 编程版
《第一》
--------------------------------------------------------------------------------
这篇文章主要讲述如何使DELPHI和因特网配合工作。本文中将详述两个专门技术：
WININET：构建 FTP，HTTP 和 Gopher 用户端程序
ISAPI：扩充因特网信息服务，例如，获得服务器上的信息并把它们显示在浏览器上。
现今的计算机世界中，由于微软公司的因特网战略而掀起了一个巨大发展潮流。那些制作CGI（公共网关接
口）和第三方工具（即使是最基本的因特网工具）的日子将最终一去不复返了。对复杂的第三方工具的需求
总是存在的，但现在程序员将会发现他们所需的大量的嵌入操作系统的因特网工具，简言之，并不需要进一
步的投资，你就能够使用免费的DELPHI资源来：
*开发 WEB 浏览器
*运行 FTP，HTTP 和 Gopher ，在两个DELPHI应用软件之间或DELPHI应用软件和基于TCP（传输控制协议）的
服务器之间操作TCP
因为DELPHI能够轻松地调用Windows API，并且它支持OCX/ActiveX，因此微软的新战略和我们的计划配合
的恰到好处。微软生产工具，而DELPHI程序员获得收成！
--------------------------------------------------------------------------------
在本篇中有些什么？
这篇文章中包含了三个大部分和一些小部分，有三个大主题：
*寻找资料： 那里能搞到本文中提及的技术资料，而且包含了关于您所需的运行文中代码的软硬件的简短
说明。
*ISAPI：怎样使用ISAPI
*WININET：怎样使用WININET
在大多数情况下，本文中的ISAPI和WININET部分是完全独立的，您可以自由地选择阅读时的顺序。
--------------------------------------------------------------------------------
查找资料，硬件和软件的要求
您需要一份Microsoft Windows NT 3.51 Server 或 NT 4.0 Server 的拷贝，其中应附有因特网信息服务
文档，因为您需要甬道其中所提到的技术。这份文档应随NT Server4.0 附送，NT 3.51的用户可从微软的
网址上下载。运行Windows NT，您的机器的最低配置应为486兼容，20兆以上内存。
您必须有另一台计算机装有网页浏览器。为使本文中的ISAPI部分能够顺利运行，第二台机器必须能够运行
所有支持网页浏览器的软件。如果在您的机器上运行的是Windows 95 或 Windows NT,那么本文中的WININET
代码片就能运行的最好。任何符合条件的网页浏览器在这种技术环境下都能够使用。
在1996年六月以后发布的Delphi2.0以上的版本中，有您所需的把Delphi连接到因特网上的几乎全部资源。
如果您没有最新的Delphi版本[注：此处作者指的是2.0版本（译者）]，那么您需要本文档中提到的特殊文
件，所有这些几乎都可以从万维网上免费获得[注：如果您正在使用Delphi2.0以上版本，则不许考虑
（译者）]。所有本文中提到的技术在Delphi2.0环境下都能顺利工作，但在16位Delphi环境下则不一定能
顺利工作。
如果您需要从万维网上下载信息，链接为：http://www.borland.com/TechInfo/delphi/index.html
[注：现在已经不存在了！:-(( （译者）]
Delphi2.0的新版本中附有 WININET.PAS 文档，如果你的拷贝中不包含它，那么上面那个万维网节点可以
为您提供。WININET.PAS包括为扩展微软视窗因特网所设计的变量清单、函数、类型和属性。这意味着您能
够轻而易举地为您的应用程序增添FTP、HTTP和Gopher支持。微软公司的WININET.DLL是免费发布的，如果
它不在您的Windows/System 或 Windows/System32 目录下的话，您可以从微软公司那里得到它。下面是可
获得WININET.H这个视窗帮助文件的万维网节点：
http://www.microsoft.com/intdev/sdk/docs/wininet/default.htm [注：好象也没了！:-( （译者）]
一般来说，微软因特网开发者的网上之家是微软节点的 INTDEV 部分。
除了WININET和ICP之外，另一个为Delphi支持的关键技术就是ISAP。正如微软公司文档中所描述的，这项技
术能使您“‘写入’服务器端的原本和过滤本，从而扩充微软因特网信息服务和其他ISAPI万维网服务”。
如果您需要找到关于ISAPI的描述，可以去：
http://www.microsoft.com/intdev/sdk/servapi.htm [注：上帝保佑您！;-) （译者）]
在本文最后，附加了一个名为HTTPEXT.PAS的关键的ISAPI文档的拷贝。
微软公司免费发布的因特网控制包（ICP）是一个OCX/ActiveX控制集，您可以在Delphi中把它们拖放到应用
程序上（Delphi2.0中包含这些控件）。他们提供了创建Delphi应用程序的即时支持，他们知道如何浏览网页、
如何应用FTP、WINSOCK和其他因特网技术。如果您的Delphi拷贝中没有包含这些控件，那么您在使用它们之
前您应该把这些文档添加进Delphi所在的目录中的Lib目录下。这些文档位于上面提及的链接中的Borland的
INDEX.HTML站点下。在本文中我没有提到ICP控件，但是任何对这项技术有兴趣的人应该明确确认他拥有这些
控件的拷贝。
您可以从我的站点下载我的Pascal应用文件，他们的名字是STRBOX.PAS 和 MATHBOX.PAS。
经常察看一下这个站点上的关于本文提到的信息的更新情况是很有好处的。
在这里我假设读者对于Delphi和Object Pascal都很熟悉，并且读者对于因特网，HTML，浏览器和万维网服
务器有基本的了解。
ISAPI
ISAPI是一项很容易使用然而功能强大的技术，它能够让您扩充因特网信息服务的功能。这项技术随WindowsNT
4.0附送，让您在您的服务器上建立WEB、FTP和GOPHER站点。同时这项技术与WindowsNT3.51 Server[注：指服
务器版本，另一个版本是工作站版本（译者）]兼容。
在过去，扩充网页服务器的最佳办法是建立CGI应用程序。它们是强有力的工具，但是也被他们的执行格式所
限制[注：如PERL是解释执行的（译者）]。当您从浏览其上发出一个基于CGI的请求到服务器上时，这个CGI
应用程序将极有可能先被强制装入内存中，这会消耗很多时间。而且，在某些环境下，CGI技术显得稍微难用
了一点。
ISAPI是一种通过写入DLLs[注：动态链结程序（译者）]从而替代CGI应用的方法。您也可以通过ISAPI来写
过滤文本，但这项技术我不会在本篇中提及。同CGI相比，ISAPI更容易使用，而且它更快，同时能更好地利
用系统资源。在下面几点中，我将详细地介绍为什么ISAPI DLLs比CGI应用要更为出色：
ISAPI DLLs与HTTP服务位于相同的地址，因此他们能够从服务器上直接存取HTTP服务。与CGI应用相比，它们
能更快地装入内存；当他们在服务器上发出请求时，所需的停悬的时间[注：指发出请求到接受服务器应答的
时间（译者）]要少的多。这点当服务器的负荷很重时更加重要。
您可以控制DLLs何时被装载和卸载。例如：您可以在第一次尝试请求时预先装载DLLs；当它们不被使用时卸载
这个ISAPI应用DLLs以便释放系统资源。
正如前文所述，您可以利用ISAPI写过滤文本[注：一般指C/S结构中的脚本（译者）]，更具微软的文档，您可
以通过ISAPI过滤文本做下面这些事情：
用户授权方案
压缩
加密
登入
通信分析或其他请求分析（例如，寻找 "../../etc/password" 中的请求）
在本文中，我会着重介绍如何编写返回数据集的DLLs，或者是如何与运行浏览器的用户进行简单的联系。
ISAPI 基础
HTTPEXT.PAS文件包含了使用ISAPI的关键声明。这个文件应随1996年6月以后发表的Delphi版本分发。它也可
以在Borland的站点上找到，在本文的ISAPI部分附有这份文档。因为这是基于NT的技术，您必须使用Delphi2.0
以上的版本来应用这项技术。您不可能在16位的编辑器上应用它。
HTTPEXT.PAS包含了微软公司创立的ISAPI技术的接口[注：指Delphi接口，ISAPI由C++编写（译者）]。在编写
Delphi的时候并没有提供ISAPI的用户接口，我会仅仅就如何使用微软公司的现有技术进行描述。不过，ISAPI
太容易使用了，而且对大多数用户来说，用户的Delphi对象的版本并不是必须的。
有三个函数可作为ISAPI DLLs的入口，前两个是必须的，第三个时可选的。
GetExtensionVersion: 进对最低版本做检查
HttpExtensionProc: 这是DLL的入口，就象是Delphi应用程序中的 begin...end 块
TerminateExtension: 这是个可选的程序，它可以用作清除其他内存分配的线程。
当您在创建ISAPI DLL的时候，您必须引用上面列出的三个函数中的头两个函数，执行这两个函数是所有ISAPI
编程的关键。
这三个语句都包含了“字输出”，使用这项术语是因为ISAPI DLLs扩充了因特网信息服务器。（记住，因特网
信息服务器指的是微软服务器。如果您要把一台NT服务器作为体格网页服务器的话，那么，这正是您所需的工
具。ISAPI DLLs随NT4.0分发，在安装操作系统是自动安装。）
ISAPI提供了一个制作服务器可遵循的标准。例如，它可以把网景公司的复杂的NSAPI接口压缩至相关的简练而
优美的ISAPI来对NSAPI接口进行操作。
下面是这两个重要函数的声明
function GetExtensionVersion(var Ver: THSE_VERSION_INFO): BOOL; stdcall;
function HttpExtensionProc(var ECB: TExtensionControlBlock): DWORD; stdcall;
您只要把GetExtensionVersion粘贴到您的DLLs救行了.当ISAPI向公众发布新版本时您只需要做轻微的改动。
function GetExtensionVersion(var Ver: THSE_VERSION_INFO):
BOOL; stdcall;
begin
Ver.dwExtensionVersion := $00010000; // 1.0 support
Ver.lpszExtensionDesc := 'Delphi 2.0 ISAPI DLL'; // Description
Result := True;
end;
The parameter passed to this function is declared in HTTPEXT.PAS as follows:
有关的参数在HTTPEXT.PAS中声明如下：
PHSE_VERSION_INFO = ^THSE_VERSION_INFO;
THSE_VERSION_INFO = packed record
dwExtensionVersion: DWORD;
lpszExtensionDesc: array[0..HseMaxExtDLLNameLen-1] of Char;
end;
常量 HseMaxExtDllNameLen 在声明中的值为256。纪录中的这两个变量是“自声明”的，前一个包含了
ISAPI的版本号[注：即变量dwExtensionVersion （译者）]，后一个则表示用户定义的一个用来描述
DLLs的字符串。
在您引用GetExtensionVersion语句的同时，您必须在您的DLL程序的DPR文件部分增添输出部分。在您写
这段语句时您还应该写下：
exports
GetExtensionVersion,
HttpExtensionProc;
这就是您在建立这两个重要ISAPI DLL的函数时所要做的。下一步，使用 HttpExtensionProc，稍微复杂一
点，因此我将把它作为一个独立的部分。
与 HttpExtensionProc 一起工作
HttpExtensionProc语句是DLL的入口。它的作用就好比C语言中的 main() 语句，或者Delphi 中的
begin...end 部分
这里有一个简单的使用GetExtensionVersion语句的例子
function HttpExtensionProc(var ECB: TExtensionControlBlock):
DWORD; stdcall;
var
ResStr: string;
StrLen: Integer;
begin
ECB.lpszLogData := 'Delphi DLL Log';
ECB.dwHTTPStatusCode := 200;
ResStr := '<HTML><TITLE>Test server result</TITLE>' +
'<H1>Test server results</H1>' +
'<BODY>Hello from ISAPI<BR></BODY>' +
'</HTML>';
ResStr := Format(
'HTTP/1.0 200 OK'#13#10+
'Content-Type: text/html'#13#10+
'Content-Length: %d'#13#10+
'Content:'#13#10#13#10'%s', [Length(ResStr), ResStr]);
StrLen := Length(ResStr);
ECB.WriteClient(ECB.ConnID, Pointer(ResStr), StrLen, 0);
Result := HSE_STATUS_SUCCESS;
end;
如果您在浏览其中向这个DLL发出请求，那么您会得到一页这样的回应：
Test Server Results
Hello from ISAPI
