[网络协议]第十六章 CSP 中的 HTTP 请求 - ％CSP.Request 对象

第十六章 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。