使用 IntraWeb (39) - THttpRequest、THttpReply
在其它服务器脚本语言中熟悉的 Request、Response(THttpRequest、THttpReply) 在 IntraWeb 中算是幕后英雄了, 用户基本不需要直接操作它们了.
IW 默认 Post 传值(WebApplication.Request.HttpMethod = hmPost, 只读), 但像表单字段之类, 在 IW 中直接根据控件名称读取就是了, 用不着麻烦 Request.
但如果需要, 可以使用 WebApplication.Request.QueryFields.Values['控件名'] 读取.
要读出以 Get 方式传输的 Url 变量, 发现在很多时候 WebApplication.Request.QueryFields.Values['变量名'] 并不好用; 经过尝试, 也不是没有办法:
1、笨办法: 自己解析 WebApplication.Request.Referer;
2、Request 以参数方式出现时往往可以, 譬如 TIWAppForm.OnURLRequest 事件:
{Unit1 中的关键代码}
procedure TIWForm1.IWButton1Click(Sender: TObject);
begin
WebApplication.GoToURL('Page2.html?AAA=111&BBB=222');
end;
{Unit2 中的关键代码}
procedure TIWForm2.IWAppFormURLRequest(aSender: TIWAppForm; aRequest: THttpRequest); //需 uses IW.HTTP.Request
begin
IWMemo1.Lines.Add(WebApplication.Request.QueryFields.Values['bbb']);
end;
initialization
TIWForm2.SetURL('', 'Page2.html');
我想, 按照 IW 的理念, 网页间互相传递的参数应该是用 Session(下篇博客测试下).
有时还要用到运行参数, 输入运行参数有两种方法:
1.从代码(如: WebApplication.RunParams.CommaText := 'AAA=111,BBB=222');
2.从 Server 控制台(如下图);
读取运行参数, 如: MyStr := WebApplication.RunParams.Values['AAA'];
THttpRequest 所在单元及继承链:
IW.HTTP.Request.THttpRequest < TObject
主要成员(根据测试结果判断吧):
property UserAgent: string //测试结果: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko property Referer: string //测试结果: http://127.0.0.1:8888/$/?aaa=111&bbb=222; 测试时添加了两个运行参数 property ScriptName: string // property Host: string //测试结果: 127.0.0.1 property URL: string // property PathInfo: string //测试结果: /$/callback property RemoteAddr: string //测试结果: 127.0.0.1 property ServerPort: integer //测试结果: 8888 property Query: string //测试结果: callback=... property HttpMethod: THttpMethod //测试结果: hmPost(其它: hmNone, hmGet, hmPut, hmPost, hmHead) property IfModifiedSince: string // property ForwardedFor: string // property HttpClientIP: string // property AcceptLanguage: string //测试结果: zh-CN property HttpsHeader: string // property Authorization: string // property AuthorizationHeader: string // property AuthUser: string // property AuthPass: string // property ServerVariables: TStrings // property HasContent: Boolean //测试结果: True property Files: THttpFileList // property QueryString: string //测试结果: callback=... function GetCookieValue(const aName: string): string; function GetRawHeaderValue(const aName: string): string; function GetServerVariableValue(const aVariableName: string): string; function GetContentFieldValue( const aContentFieldName: string): string; procedure SetRewriteURL(const aUrl: string); property RawHeaders: TStrings //测试结果: //Accept: */* //Content-Type: application/x-www-form-urlencoded //Referer: http://127.0.0.1:8888/$/ //Accept-Language: zh-CN //Accept-Encoding: gzip, deflate //User-Agent: Mozilla/5.0 (Windows NT 6.1; Trident/7.0; rv:11.0) like Gecko //Host: 127.0.0.1:8888 //Content-Length: 205 //DNT: 1 //Connection: Keep-Alive //Cache-Control: no-cache //Cookie: IW_MyApp=rtDemtDbmuncnJHgndGWqueWrKmWodK1otaXrue4mdu_2 property ContentFields: TStrings //测试结果: //IWBUTTON2= //IW_Action=IWBUTTON2 //IW_ActionParam= //IW_FormName=IWForm1 //IW_FormClass=TIWForm1 //IW_LocationHash= //IW_TrackID_=2 //IW_width=1920 //IW_height=985 //IW_SessionID_=mKrbmdjendG0mZLgndGXoefbn0yWoefbmti2rJngode //callback=IWBUTTON2.DoOnAsyncClick //x=48 //y=10 //which=0 //modifiers= property CookieFields: TStrings //测试结果: IW_MyApp=ourdmeffmdHgmtK1ndiWodGZoungnKvfmtG5nKiXmue_2 property QueryFields: TStrings //测试结果: //IWBUTTON2= //IW_Action=IWBUTTON2 //IW_ActionParam= //IW_FormName=IWForm1 //IW_FormClass=TIWForm1 //IW_LocationHash= //IW_TrackID_=2 //IW_width=1920 //IW_height=985 //IW_SessionID_=nZKXqtvcrJvbmtiZndjfrKe1nZm3numYmta3ruiXnZG //callback=IWBUTTON2.DoOnAsyncClick //x=52 //y=18 //which=0 //modifiers= function GetParams: TStrings; //测试结果: //IWBUTTON2= //IW_Action=IWBUTTON2 //IW_ActionParam= //IW_FormName=IWForm1 //IW_FormClass=TIWForm1 //IW_LocationHash= //IW_TrackID_=2 //IW_width=1920 //IW_height=985 //IW_SessionID_=nJDbrdvcrdaZnZiZndm0mJG0mem1ndnerdC1nJaWree //callback=IWBUTTON2.DoOnAsyncClick //x=56 //y=15 //which=0 //modifiers= //IWBUTTON2= //IW_Action=IWBUTTON2 //IW_ActionParam= //IW_FormName=IWForm1 //IW_FormClass=TIWForm1 //IW_LocationHash= //IW_TrackID_=2 //IW_width=1920 //IW_height=985 //IW_SessionID_=nJDbrdvcrdaZnZiZndm0mJG0mem1ndnerdC1nJaWree //callback=IWBUTTON2.DoOnAsyncClick //x=56 //y=15 //which=0 //modifiers=
THttpReply 所在单元及继承链:
IW.HTTP.Reply.THttpReply < TObject
主要成员:
property AllowCaching: Boolean //
property AuthRealm: string //
property CacheTTL: Integer //
property Code: Word //
property CodeText: string //
property ContentType: string //
property Cookies: TCookieList//
property LastModified: TDateTime //
property Headers: TStrings //
property Expires: TDateTime //
property DataType: THttpReplyType //
property ServerPort: Integer //
property SendingFile: Boolean //
property CacheControlEnabled: Boolean //If FALSE, completely disable cache control header fields ("Expires", "Last-Modified", "Pragma: no-cache" and "Cache-Control: no-cache"). Default = TRUE
constructor Create(aBuffer: PByte; const aSize: Integer)
procedure Commit
procedure WriteString(const aValue: string)
procedure SendRenderStream(aStream: TIWRenderStream)
procedure SendStream(aStream: TStream; const aDisableCacheControl: Boolean)
procedure SendHsmStream(aStream: THsmStream)
procedure SendFile(const aPathname: string; aDelete: Boolean; const aDisableCacheControl: Boolean)
procedure SendCacheFile(const aPathname: string)
procedure SendRedirect(const aURL: string)
procedure ResetReplyType
学其他服务器脚本, 都快习惯了先用 Response 输出点什么, 下面测试了在 IW 中通过 Response 做简单的输出:
{新建 MyIndex 单元, 从 TContentBase 继承实现一个 TMyIndex 类}
unit MyIndex;
interface
uses Classes, IW.Content.Base, HTTPApp, IWApplication, IW.HTTP.Request, IW.HTTP.Reply, IWMimeTypes;
type
TMyIndex = class(TContentBase)
protected
function Execute(aRequest: THttpRequest; aReply: THttpReply; const aPathname: string; aSession: TIWApplication; aParams: TStrings): Boolean; override;
public
constructor Create; override;
end;
implementation
{ TMyIndex }
constructor TMyIndex.Create;
begin
inherited;
mFileMustExist := False;
end;
function TMyIndex.Execute(aRequest: THttpRequest; aReply: THttpReply; const aPathname: string; aSession: TIWApplication; aParams: TStrings): Boolean;
begin
aReply.ContentType := MIME_HTML;
aReply.WriteString('万一的 Delphi 博客');
Result := True;
end;
end. //MyIndex.pas End
{在 IWServerControllerBase.OnConfig 中指定为首页, 并命名为 Index.htm}
uses
IWInit, IWGlobal, IW.Content.Handlers, MyIndex;
procedure TIWServerController.IWServerControllerBaseConfig(Sender: TObject);
begin
THandlers.AddStartHandler('', 'Index.htm', TMyIndex.Create);
end;