用Delphi编写CGI程序（四）
用Delphi编写CGI程序（四）
从 这 一 讲 开 始，我 们 将 进 入 CGI 程 序 设 计 的 学 习 过 程。通 过 前 面 几 讲 的 学 习，您 已 经 掌 握 了 CGI 程 序 设 计 的 基 础 知 识。现 在，您 可 以 坐 下 来 编 写 CGI 程 序 了！
三、CGI 程 序 设 计
1、服 务 器 端 附 件 (SSI) 及 网 关
2、网 关：通 过 WEB 连 接 其 他 协 议
在 编 写 CGI 程 序 的 过 程 中，最 好 遵 循 以 下 几 个 应 用 程 序 设 计 的 要 点：
（1）提 出 问 题 -- 您 要 解 决 的 问 题
（2）设 计 阶 段 -- 构 想 出 CGI 程 序 的 基 本 框 架 和 功 能
（3）编 码 阶 段 -- 用 行 动 实 现 思 想
（4）程 序 移 植 -- 编 写 可 移 植 的 代 码
（5）精 益 求 精 -- 使 程 序 更 上 一 层 楼
1、服 务 器 端 附 件 (SSI) 及 网 关
在 本 节 将 介 绍 服 务 器 端 附 件 SSI(Server Side Include) 和 网 关。严 格 的 说，SSI 并 不 是 CGI 程 序 设 计 的 内 容，但 SSI 可 以 完 成 一 些 简 单 CGI 程 序 所 能 完 成 的 工 作，有 时 SSI 甚 至 是 最 好 的 选 择。因 此，在 这 里 作 简 单 介 绍。
SSI 定 义 了 一 组 嵌 入 HTML 文 本 的 命 令，在 HTML 文 本 送 往 HTTP 客 户 端 前，WEB 服 务 器 对 这 些 SSI 命 令 先 作 预 处 理，将 处 理 后 的 HTML 文 本 输 出 到 HTTP 客 户 端 的 浏 览 器。
SSI 的 命 令 格 式 是：
< !--# 命 令 参 数 =" 值 " -->
SSI 命 令 同 Java 或 JavaScript 不 同，它 是 在 服 务 器 端 处 理 的，而 不 是 在 客 户 端 处 理 的，这 一 点 同 CGI 程 序 是 相 似 的。当 然，在 SSI 的 功 能 范 围 内，其 优 点 同 CGI 程 序 相 同，可 以 提 高 服 务 器 的 资 源 利 用 率，而 且 在 客 户 端 用 任 何 WEB 浏 览 器 都 可 以 浏 览 含 有 SSI 的 HTML 文 本。
下 面 是 常 用 的 六 个 SSI 命 令：
（1）Include命令
（2）echo 命 令
（3）exec 命 令
（4）config 命 令
（5）fsize 命 令
（6）flastmod 命 令
include 命 令
唯 一 支 持 的 参 数 是 file，这 是 在 当 前 HTML 文 本 中 插 入 file 参 数 指 定 的 文 件 的 内 容。如 果 您 了 解 C 语 言，可 以 看 出 它 和 C 语 言 中 的“#include”命 令 的 功 能 是 一 样 的。例 如，有 两 个 HTML 文 本：main.html 和 header.html，在 main.html 中 使 用 include 命 令：main.html:
< html>
< tilte> Test Include SSI Command < /title>
< !--#include file="header.html" -->
< body>
The above header comes from header.html!
< /body>
< /html>
header.html:
< H1> This is a title in header.html! < /H1>
( 不 过，好 象 OmniHTTPD 不 支 持 include 命 令，:< !)
echo 命 令
唯 一 支 持 的 参 数 是 var，它 用 于 显 示 服 务 器 提 供 的 变 量，例 如：
DOCUMENT_NAME：当 前 文 件 名
DOCUMENT_URL：SSI 文 本 的 相 对 路 径
DATE_LOCAL：当 地 日 期
DATE_GMT：GMT(Creenwich 标 准 时 间 ) 日 期
LAST_MODIFIED：包 含 此 SSI 命 令 的 文 件 的 最 近 修 改 日 期
HTTP_USER_AGENT：浏 览 器 名。
例 如：main.shtml < html>
This document was last updated on < !--#echo var="LAST_MODIFIED"-->
< /html>
当 您 用 浏 览 器 打 开 main.shtml 时 可 以 看 到 最 后 修 改 时 间。( 要 注 意 的 是，必 须 将 main.shtml 存 储 在 OmniHTTPD 的 HtDocs 目 录 下，在 浏 览 器 中 用 地 址 http://localhost/main.shtml 访 问。)
exec 命 令
两 个 参 数 是 cgi 和 cmd。前 者 调 用 一 个 可 执 行 文 件，如 cgi="/cgi-bin/finger.cgi"；后 者 调 用 一 个 系 统 命 令，如 cmd="ls"。遗 憾 的 是，OmniHTTPD 不 支 持 此 SSI 命 令 ( 也 许 现 在 的 最 新 版 支 持 )。
config 命 令
此 命 令 设 置 服 务 器 处 理 文 件 和 显 示 日 期 的 方 法。它 有 两 个 参 数：
（1）timefmt，决 定 显 示 日 期 的 格 式。在 UNIX 中 用 man strftime 查 询 可 用 的 值。
（2）sizefmt，决 定 显 示 文 件 长 度 的 格 式。值 为 bytes 或 addrev。这 个 命 令 在 OmniHTTPD 中 也 不 支 持。
fsize 命 令
此 命 令 显 示 给 定 文 件 的 大 小。参 数 是 file，指 定 文 件 的 路 径 及 文 件 名。
flastmod 命 令
此 命 令 显 示 指 定 文 件 的 最 近 修 改 日 期。参 数 是 file，指 定 文 件 的 路 径 及 文 件 名。
2、网 关：通 过 WEB 连 接 其 他 协 议
HTTP 协 议 无 法 访 问 Internet 的 所 有 资 源，要 访 问 HTTP 协 议 以 外 的 资 源 时 ( 例 如 POP3 和 SMTP 收 发 电 子 邮 件 )，就 需 要 网 关。CGI 程 序 是 实 现 网 关 的 好 方 法。
在 许 多 UNIX 的 HTTP 服 务 器 中 提 供 一 些 常 用 的 网 关，例 如 finger、wais、archie 等。但 在 OmniHTTPD 中，没 有 提 供 这 些 网 关。但 我 们 可 以 通 过 编 写 CGI 程 序 向 OmniHTTPD 中 增 加 网 关 功 能。
表 单 及 其 处 理
HTML 表 单 是 WEB 文 档 的 一 部 分 ， 用 于 将 用 户 填 写 的 信 息 提 交 给 服 务 器 。 通 常 ， 这 些 信 息 传 递 给 CGI 程 序 ， CGI 程 序 依 据 输 入 信 息 进 行 一 系 列 操 作 或 数 据 加 工 ， 再 生 成 表 示 处 理 结 果 的 HTML 文 档 发 回 给 客 户 浏 览 器 。
由 此 可 见 ， CGI 程 序 的 关 键 部 分 是 得 到 输 入 数 据 和 生 成 HTML 文 档 ， 而 操 作 和 数 据 处 理 部 分 同 大 多 数 应 用 程 序 相 同 。 在 这 一 讲 ， 我 将 介 绍 如 何 在 Perl 和 Delphi 中 得 到 数 据 及 输 出 HTML 文 档 。
首 先 ， 我 们 建 立 一 个 名 为 greeting.html 的 HTML 文 档 ：
greeting.html 文 件 ( 存 储 在 OmniHTTPD 的 HtDocs 目 录 下 )
< html>
< head>
< title> This is a greeting page! < /title>
< h1> Greeting < /h1>
< body>
< hr>
< form action="/cgi-bin/greeting.pl" method=POST>
< p> Your First Name: < input type=text name="firstname" size=60 maxlength=80> < /p>
< p> Your Last Name: < input type=text name="lastname" size=60 maxlength=80> < /p>
< hr>
< p> < input type=submit value="All OK!"> < input type=reset value="Clear All"> < /p>
< /form>
< /body>
< /html>
下 面 是 Perl 的 CGI 程 序 greeting.pl ：
greeting.pl 文 件 ( 存 储 在 OmniHTTPD 的 cgi-bin 目 录 下 ) # Greeting You!
require "cgi-lib.pl";
# ===================================
# get input values
&ReadParse(*input);
$mFirstName = $input{'firstname'};
$mLastName = $input{'lastname'};
# ===================================
# do some operations here
$mFullName = "$mFirstName $mLastName";
# ===================================
# create HTML document to output
print &PrintHeader;
print "< html>< head>< title> Greeting You! < /title>< /head>\n";
print "< body> Hello, < i>$mFullName< /i> !\n";
print "< hr> by Greeting.pl < /body>< /html>";
# ===================================
# All done!
通 过 浏 览 http://localhost/greeting.html 测 试 CGI 程 序 。
在 上 面 的 Perl 程 序 中 ， 作 为 CGI 程 序 ， 必 须 用 require "cgi-lib.pl" 来 引 用 cgi-lib.pl 文 件 ， 此 文 件 有 许 多 用 于 CGI 编 程 的 函 数 和 过 程 。 require 相 当 于 C 中 的 #include ， 但 要 注 意 的 是 ， require 语 句 后 必 须 有 分 号 。
ReadParse 过 程 读 取 HTML 表 单 提 交 的 数 据 ， 参 数 是 一 个 数 组 指 针 。 要 注 意 的 是 ， 在 Perl 中 ， 函 数 和 过 程 的 调 用 要 在 前 面 加 上 & 符 号 。
mFirstName 、 mLastName 和 mFullName 是 变 量 。 在 Perl 中 ， 变 量 名 前 要 有 $ 符 号 。
PrintHeader 函 数 实 际 上 返 回 值 是 "Content-type: text/html\n\n" ， 它 告 诉 浏 览 器 下 面 的 数 据 是 HTML 文 档 。
生 成 HTML 文 档 部 分 很 简 单 ， 就 是 用 print 语 句 将 HTML 文 档 的 内 容 输 出 就 可 以 了 。 怎 么 样 ， 会 用 Perl 编 写 CGI 程 序 了 吧 ？
下 面 ， 我 们 来 编 写 一 段 Delphi 程 序 来 完 成 相 同 的 功 能 ：
先 关 闭 Delphi 中 的 所 有 项 目 ， 选 择 菜 单 File/New ， 在 对 话 框 中 选 择 Web Server Application 类 型 ， 使 用 CGI Stand-alone excutable 选 项 ， 则 出 现 一 个 新 项 目 ， 其 主 窗 口 名 为 WebModule1 。
在 WebModule1 的 Actions 属 性 上 双 击 鼠 标 ， 出 现 Actions 属 性 编 辑 窗 口 。 在 窗 口 中 新 建 一 Action ， 名 为 WebActionItem1 ， 将 其 Default 属 性 设 为 True ； 并 在 它 的 Events 中 双 击 OnAction 事 件 ， 添 入 下 面 的 代 码 ：
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject;Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
var
mFirstName, mLastName, mFullName: string;
HtmlDoc: string;
begin
// Get Input Values:
mFirstName := Request.ContentFields.Values['firstname'];
mLastName := Request.ContentFields.Values['lastname'];
// Do some operations here
mFullName := mFirstName + ' ' + mLastName;
// Create HTML document to output
HtmlDoc := '< html>< head>< title> Greeting You! < /title>< /head>';
HtmlDoc := HtmlDoc + '< body> Hello, < i>' + mFullName + '< /i> !';
HtmlDoc := HtmlDoc + '< hr> by Greeting.cgi < /body>< /html>';
Response.Content := HtmlDoc;
end;
将 此 工 程 的 单 元 存 为 cgimain.pas ， 将 工 程 存 为 greeting.dpr 。 编 译 ( 用 Ctrl+F9) 后 ， 将 greeting.exe 复 制 到 OmniHTTPD 的 cgi-bin 目 录 下 ， 并 改 名 为 greeting.cgi 。 同 时 ， 将 前 面 我 们 写 的 greeting.html 做 如 下 修 改 ：
将 < form action="/cgi-bin/greeting.pl" method=POST> 改 成
< form action="/cgi-bin/greeting.cgi" method=POST>
这 样 ， 通 过 浏 览 http://localhost/greeting.html 就 可 以 测 试 用 Delphi 编 写 的 CGI 程 序 了 。
从 这 个 程 序 可 以 看 出 ， 在 Delphi 中 CGI 程 序 一 得 到 一 个 请 求 就 发 生 WebActionItem 的 OnAction 事 件 。 在 这 个 事 件 中 ， 数 据 输 入 和 HTML 文 档 生 成 是 这 样 做 的 ：
通 过 Request.ContentFields.Values[HTML 表 单 元 素 名 ] 得 到 表 单 元 素 的 值 。
通 过 对 Response.Content 赋 值 生 成 HTML 文 档 。
下 面 是 Delphi 程 序 的 三 个 文 件 内 容 ： -----------------------------------------------------------
greeting.dpr :
program greeting;
{$APPTYPE CONSOLE}
uses
HTTPApp,
CGIApp,
cgimain in 'cgimain.pas' {WebModule1: TWebModule};
{$E cgi}
{$R *.RES}
begin
Application.Initialize;
Application.CreateForm(TWebModule1, WebModule1);
Application.Run;
end.
-----------------------------------------------------------
cgimain.pas :
unit cgimain;
interface
uses Windows, Messages, SysUtils, Classes, HTTPApp;
type
TWebModule1 = class(TWebModule)
procedure WebModule1WebActionItem1Action(Sender: TObject;Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
private
{ Private declarations }
public
{ Public declarations }
end;
var
WebModule1: TWebModule1;
implementation
{$R *.DFM}
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject;Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
var
mFirstName, mLastName, mFullName: string;
HtmlDoc: string;
begin
// Get Input Values:
mFirstName := Request.ContentFields.Values['firstname'];
mLastName := Request.ContentFields.Values['lastname'];
// Do some operations here
mFullName := mFirstName + ' ' + mLastName;
// Create HTML document to output
HtmlDoc := '< html>< head>< title> Greeting You! < /title>< /head>';
HtmlDoc := HtmlDoc + '< body> Hello, < i>' + mFullName + '< /i> !';
HtmlDoc := HtmlDoc + '< hr> by Greeting.cgi < /body>< /html>';
Response.Content := HtmlDoc;
end;
end.
-----------------------------------------------------------
cgimain.dfm ：
object WebModule1: TWebModule1
OldCreateOrder = False
Actions = <
item
Default = True
Name = 'WebActionItem1'
OnAction = WebModule1WebActionItem1Action
end>
Left = 192
Top = 107
Height = 150
Width = 215
end
