第十六章 CSP 中的 HTTP 请求 - %CSP.Request 对象
%CSP.Request 对象
当 CSP
服务器响应 HTTP
请求时,它将有关传入请求的信息打包到对象中的 %CSP.Request
实例中。可以使用变量 %request
来引用此对象。
URL 属性
要查找传入 HTTP
请求的 URL
(不包括查询字符串),对象中使用 %CSP.Request
的 URL
属性:
Write "URL: ", %request.URL 复制代码
数据属性和 URL
参数
URL
可能包含参数列表(也称为 URL
查询)对象中的 %CSP.Request
通过其 Data
属性使这些可用。
例如,假设传入的 URL 包含:
/csp/user/MyPage.csp?A=10&a=20&B=30&B=40 复制代码
可以使用以下命令在服务器上检索这些参数:
Write %request.Data("A",1) // this is 10 Write %request.Data("a",1) // this is 20 Write %request.Data("B",1) // this is 30 Write %request.Data("B",2) // this is 40 复制代码
数据是一个多维属性,其中存储的每个值都有 2
个下标:参数的名称和参数的索引号(参数可以在 URL
中多次出现,如上面的 B
)。请注意,参数名称区分大小写。
另请注意,传入的 HTTP
请求是 GET
还是 POST
请求并不重要:Data
属性以完全相同的方式表示参数值。
可以使用 ObjectScript $Data ($D)
函数来测试是否定义了给定的参数值:
If ($Data(%request.Data("parm",1))) { } 复制代码
如果您希望引用一个参数但不确定它是否已定义,可以使用 ObjectScript $Get
函数:
Write $Get(%request.Data("parm",1)) 复制代码
可以在对象中使用 %CSP.Request
的 Count
方法找出为特定参数名称定义了多少值:
For i = 1:1:%request.Count("parm") { Write %request.Data("parm",i) } 复制代码
CgiEnvs 属性和 CGI环境变量
Web
服务器提供一组值,称为 CGI
(通用网关接口)环境变量,其中包含有关 HTTP
客户端和 Web
服务器的信息。可以使用多维属性 CgiEnvs
访问这些 CGI
环境值。可以按照与 Data
属性相同的方式使用它。
例如,要确定发出 HTTP
请求的浏览器类型,请查看 CGI
环境变量 HTTP_USER_AGENT
的值:
Write %request.CgiEnvs("HTTP_USER_AGENT") 复制代码
Cookies 属性
如果 HTTP
请求包含任何 cookie
,可以使用多维属性 Cookies
检索它们的值。可以按照与 Data
属性相同的方式使用它。
数据也可以保存在 %session
对象中。
请参阅 CSP
示例数据库中 cookie.csp
中使用 cookie
的示例。
MIME 数据属性
传入请求可能包含 MIME
(多用途 Internet
邮件扩展)数据。这通常用于较大的信息,例如文件。可以在对象中使用 %CSP.Request
检索 MIME
数据。这将创建并返回一个 Caché
流对象的实例,然后可以使用该实例来读取 MIME
数据。
有关使用 MIME
数据的示例,请参阅 CSP
示例中的 upload.csp
。