执行响应

响应对象是用于动态响应客户端请示，控制发送给用户的信息，并将动态生成响应。

响应对象类型为“服务器响应”。

本章节目录：

1. HTTP协议头处理
   • 1.1 响应状态
   • 1.2 响应头
   • 1.3 设置Cookie
   • 1.4 获取和设置Session的ID
   • 1.5 重定向
2. 输出内容处理
   • 2.1 输出文本和字节集
   • 2.2 发送文件
   • 2.3 渲染
3. 常用响应头列表

1. HTTP协议头处理

1.1 响应状态

响应状态是用来通知用户浏览器当前页面状态的。

常见的响应状态有 200 返回正常，404 文件未找到等。

获取当前响应状态：

服务器响应.取响应状态()

返回当前页面的状态值，大部分时候为 200。

设置响应状态：

服务器响应.置响应状态([HTTP响应状态])

1.2 响应头

响应头就是返回给用户的HTTP协议头部信息。

以下是一段响应头示例：

...
Content-Type: text/html
Date: Sun,26-Mar-17 05:04:29 GMT
...

设置响应头

服务器响应.置响应头([HTTP响应头名称], [响应头内容])

1.3 设置Cookie

服务器响应.添加Cookie(
    存取键值表 COOKIE表, 
    [文本型 域名], 
    [文本型 路径], 
    [文本型 过期时间],
    ［逻辑型 是否安全传输］
）

带中括号的参数是非必填项。如果不填写所有的非必填项参数，那么cookie发送后，将被记录在浏览器内存中，关闭浏览器cookie就不存在了。

以下是具体参数使用方式：

[Cookie表]

为键值表。键为cookie的名称，值为cookie内容文本。如果cookie值为空则表示删除。

[域名]

当前网站的域名，您可以设置为一级域名，这样所有二级三级等级别域名都可以访问到。

假设您的域名为：www.baidu.com，则域名参数可以设置为：.baidu.com，这样任何以 .baidu.com 结尾的二级三级域名都能访问到对应的cookie值，例如: image.baidu.coｍ就能访问到。同样的道理，如果您不想cookie跨越您当前的域名，您只需要设置具体域名信息就行了，设置 image.baidu.com 则 www.baidu.com 是访问不到的。

[路径]

路径可以绑定到不同的请求路径节点。

如果您想在网站任何地方都能访问到cookie值，则可以设置为“/”。

如果您只想在某个路径下所有请求都能得到cookie，则可以设置具体路径。例如您的功能命名为 book，所有 book 相关的路径都定义为 /book/ 开头，则这里可以设置为“/book/”，那么只有用户请求的网址路径为 /book/ 开头的视图函数中才能获取到对应的cookie值。

[过期时间]

过期时间为GMT格式的时间文本。

[是否安全传输]

安全传输标志位。

1.4 获取和设置Session的ID

响应对象允许用户自定义用户的 Session ID。不过通常不建议这么做。

服务器响应.取SessionID()
服务器响应.置SessionID([Session ID])

1.5 重定向

重定向功能通知浏览器跳转到一个新的网址。

服务器响应.重定向([重定向地址], [是否为永久地址], [自动处理容器路径])

[重定向地址]

要跳转的路径。允许跨域设置为其它网站的网址。

这里值得注意的是，当在服务器处于容器模块中时，如果您没有设置参数[自动处理容器路径]或者值为“真”，您以“/”开头设置的跳转路径，会被自动转换为您所在模块的相对寻址路径。

假设网站根相对路径：/

您的容器模块绑定路径：/book/

在您的容器模块调用重定向：

服务器响应.重定向(“/index.html”, 假, 真)

则自动处理容器路径后的跳转路径为：/book/index.html

[是否为永久地址]

不填写时默认为“假”。设置为永久地址后，浏览器再次访问该路径时，将直接跳转到您设置的重定向地址。

永久重定向和临时重定向分别修改“响应状态”为 301(永久重定向) 和 302(临时重定向)。

[自动处理容器路径]

该参数主要针对“/”开头的重定向相对路径。

如果为空或者设置为“真”，则路径会根据您所在的容器模块路径做对应的处理。见[重定向地址]参数说明。

如果设置为“假”时，将直接跳转到您指定的路劲而不区分是不是在模块中。如果设置为“假”时则上边的重定向例子中，最终重定向路径为“/index.html” 而不是 “/book/index.html” 。

2. 输出内容处理

2.1 输出文本和字节集

输出文本和字节集给浏览器的操作不是实时的，只有当您的视图函数执行完成后才会执行实际的数据发送。如果写入内容的数据量比较小，响应对象会自动做GZip压缩。

输出文本

服务器响应.写文本([文本内容])

直接向网页中写出文本，[文本内容]参数可重复添加。

文本内容不需要编码处理。响应对象会根据您设置的服务器编码类型，自动转换文本内容为您网站的编码。

输出字节集

服务器响应.写数据([数据内容])

直接向网页写数据。

2.2 发送文件

您可以直接向用户发送文件。允许发送任意路径的文件。

如果您在发送文件之前已经写出过文本或者字节集，发送文件命令会执行失败。

发送文件命令和服务器发送静态文件的功能一样，允许用户断点续传。

您发送的文件响应对象会自动根据文件名称设置文档类型(Content-Type)响应头，也会根据文件尺寸和服务器配置，自动做GZip处理。

2.3 渲染

获取渲染文件路径

服务器响应.取默认模板路径()

返回当前视图绑定的 模板路径。

渲染

渲染数据并写出到网页。

服务器响应.渲染([模板数据], [模板路径], [渲染类型])

[模板数据]

用于渲染模板组装的数据，类型为存取键值对，详细格式请参考之前的《模板和渲染》章节。

如果为空，响应对象会自动传递请求对象的“属性表”到模板引擎。

[模板路径]

指定要渲染模板的路径。如果为空则使用请求路径绑定的默认模板路径。

[渲染文档类型]

渲染后设置响应头中的文档类型(Content-Type)。默认为 配置 中设置的“渲染-xx文档类型”属性。

渲染到文本

使用方法和 渲染 完全一样，不同的是直接返回渲染文本，没有[渲染文档类型]参数。

3. 常用响应头列表