处理请求

用户请求处理通常是服务器最核心的功能，您可以从用户请求中获取到所有您需要的信息。

请求对象类型为“服务器请求”，通过在视图函数中调用“取回请求对象”命令获取。

本章节目录：

1. 用户请求处理
   • 1.1 获取用户地址端口
   • 1.2 获取HTTP头部信息
   • 1.3 获取用户请求参数
   • 1.4 获取用户Cookies
   • 1.5 获取用户上传文件
   • 1.6 获取和设置用户Session
   • 1.7 获取用户提交数据
   • 1.8 URL编码/解码
   • 1.9 获取容器相对路径
2. 请求对象扩展功能
   • 2.1 传值用属性表
   • 2.2 检测和获取“标签”
   • 2.3 获取服务器配置
   • 2.4 获取服务器映射中心
3. 常用请求头列表

1. 用户请求处理

1.1 获取用户地址端口

服务器请求.取用户地址()
服务器请求.取用户端口()

得到的用户地址通常为客户IP地址。端口为传送数据的临时端口。

1.2 获取HTTP头部信息

服务器请求.取请求头(请求头名称)

可以获取客户提交的请求中的HTTP头部信息，返回头部内容文本。请求头名称允许不区分大小写。常用的请求头信息请参考本章节后边的“常用请求头列表”。

获取客户当前请求的类型，可以用：

服务器请求.取请求类型()

能够返回大写命名的请求类型，E2EE支持以下请求类型：

• GET : 请求获取Request-URI所标识的资源
• POST : 在Request-URI所标识的资源后附加新的数据
• HEAD : 请求获取由Request-URI所标识的资源的响应消息报头
• PUT : 请求服务器存储一个资源，并用Request-URI作为其标识
• DELETE : 请求服务器删除Request-URI所标识的资源
• TRACE : 请求服务器回送收到的请求信息，主要用于测试或诊断
• CONNECT : 暂时未使用
• OPTIONS : 请求查询服务器的性能，或者查询与资源相关的选项和需求

获取客户请求的HTTP版本号：

服务器请求.取请求版本号()

返回HTTP版本信息，目前仅支持 1.0 和 1.1。

1.3 获取用户请求参数

E2EE为了使您使用方便，用户POST/GET请求参数、地址参数以及RESFful网址处理生成的参数等都认为是平等的，最大化减少命名歧义。

获取参数的方式为：

服务器请求.取参数(参数名)

返回参数文本内容。

您可以可以一次取回所有请求参数，用以下命令：

服务器请求.取所有参数()

返回所有参数组成的 存取键值表 对象。注意，此时是区分大小写的。

通过返回所有请求参数命令获取数据时，当请求参数为多项时，数据会自动组装成存取列表，使用同名多值的时候务必注意区分。请求对象在处理请求前是不知道您同名的参数个数的。

首先看看正常的情况。

请求地址：

http://localhost/?type=2&user=1

取所有参数展开文本：

{
    type:       2
    user:       1
}

接下来看看同名多值的典型情况。

请求地址：

http://localhost/?type=2&user=1&user=3&user=4

取所有参数展开文本：

{
    type:       2
    user:       [1, 3, 4]
}

1.4 获取用户Cookies

服务器请求.取Cookies()

返回 存取键值表 对象，键值均为文本，取cookies是不会存在同名多值的情况的，遇到同名必然是后边值替换前边值。

1.5 获取用户上传文件

服务器处理用户上传文件时，会预先将用户上传的文件存储到“临时”目录，使用文件时请务必将文件转移到您需要的位置，不需要时请删除。

服务器请求.取上传文件(表单项名称)

返回文件存储在“临时”目录下的绝对路径，名称为临时文件名，文件后缀沿用原文件后缀名。使用请转移到您的目标位置，不使用请删除。

参数表单项名称为上传文件表单项的“name”名称。例如：

<form method="POST" action="{{_模块路径}}/add_book" enctype="multipart/form-data">
    ...
    <input name="image_file" type="file">
    ...
    <input type="submit" value="上传" />
</form>

上传后的表单项名称为“image_file”，您可以通过这个名称获取到文件的路径。

如果您需要获取文件原始名称等信息，可以使用取所有上传文件命令：

服务器请求.取所有上传文件()

返回的是 存取列表。注意是列表，此时的列表展开形式如下：

[
    {
        name:       文件表单项名称
        filename:   文件原始文件名
        file:       文件上传后存到“临时”目录的绝对路径
    }
    {
        name:       ...
        filename:   ...  [第二个文件的信息]
        file:       ...
    }
]

如果用户上传的图片等允许在浏览器查看或下载，请移动文件到“网页”目录下您专门用于存储上传文件的目录，便于用户能够通过网址访问到。

移动文件时务必注意Windows单目录存储文件的数量等问题，建议您可以通过业务信息的ID做 取模运算 或者 通过当前时间 月份或日期 等方式建立目录对文件做存储。

“临时”目录和“网页”目录位置的配置请参考之前的配置章节。

1.6 获取和设置用户Session

Session是由服务器创建，您可以通过Session对当前客户获取和设置一些内容，便于做一些基于用户的流程处理等操作，典型场景是用户登录。具体您可以点击这里查看Session的详细说明。

设置Session：

服务器请求.置Session值([名称], [值])

名称和值参数均为文本型。

获取Session:

服务器请求.取Session值([名称])

E2EE针对Session的管理是类似PHP的管理方式，每个用户的信息会建立专门的文件用来做存储。

E2EE允许您使用自定义的方式处理Session。

您可以通过下面的方式获取Session的ID，通过ID自己决定怎么存储和获取Session内容。

服务器请求.取SessionID()

返回服务器内部给用户标记的ID。此ID永远不为空，如果多服务器处理时，您可以通过对这个ID做封装，将用户信息存储在 Memcache、Redis或者数据里做管理。

1.7 获取用户提交数据

获取GET和POST的参数请使用 取参数() 命令。

获取用户POST提交的原始数据(XML/JSON/二进制)等原始数据：

服务器请求.取发送数据()

返回用户发送的原始数据字节集。

1.8 URL编码/解码

对URL进行编解码(编码格式自动使用服务器的编码格式)：

服务器请求.URL编码()
服务器请求.URL解码()

1.9 获取容器相对路径

获取当前服务器的容器路径(专业术语Servlet Path)：

服务器请求.取模块路径()

主要用于容器化技术中获取容器给当前服务器模块定义的相对访问路径。如果是主服务器或者容器服务器，返回的将为空文本。

2. 请求对象扩展功能

除了基础用户请求处理外，请求对象也包含一些自己特有的功能。

2.1 传值用属性表

在全局函数中或者其他方式处理请求时，可能需要将一些数据传递到最终的视图请求中，此时可以使用请求对象的“属性表”用来存储需要传递的信息。

服务器请求.属性表()

返回一个存储键值表对象。这个键值表对象最特别的地方在于，它是绑定在 请求对象中的，所以对同一个请求对象，任何地方操作属性表时，都是同步的。

2.2 检测和获取“标签”

检测当前请求路径是否包含指定标签：

服务器请求.是否包含标签([标签名])

获取当前请求路径包含的所有标签：

服务器请求.取标签列表()

返回一个纯文本的 存取列表 对象，所有值都是文本型。

标签名称是在服务器注册视图函数的时候携带的“标签”参数。

2.3 获取服务器配置

为了便于您的使用，请求对象可以直接获取服务器配置信息。

服务器请求.取配置项([配置项名称])

返回的结果跟 服务器.取配置项 返回结果一样，返回服务器配置内容，包括服务器加载的“包含文件”中的配置内容。具体请参考“创建网站和配置”章节。

同样也包含了取配置文本方法：

服务器请求.取配置文本()

返回包含所有配置内容的文本。

2.4 获取服务器映射中心

同样和服务器的功能是一样的。

服务器请求.取对象映射中心()

关于映射中心的详细说明请查看后面的章节。

3. 常用请求头列表