响应对象是用于动态响应客户端请示,控制发送给用户的信息,并将动态生成响应。
响应对象类型为“服务器响应”。
本章节目录:
响应状态是用来通知用户浏览器当前页面状态的。
常见的响应状态有 200 返回正常,404 文件未找到等。
获取当前响应状态:
服务器响应.取响应状态()
返回当前页面的状态值,大部分时候为 200。
设置响应状态:
服务器响应.置响应状态([HTTP响应状态])
响应头就是返回给用户的HTTP协议头部信息。
以下是一段响应头示例:
...
Content-Type: text/html
Date: Sun,26-Mar-17 05:04:29 GMT
...
服务器响应.置响应头([HTTP响应头名称], [响应头内容])
服务器响应.添加Cookie(
存取键值表 COOKIE表,
[文本型 域名],
[文本型 路径],
[文本型 过期时间],
[逻辑型 是否安全传输]
)
带中括号的参数是非必填项。如果不填写所有的非必填项参数,那么cookie发送后,将被记录在浏览器内存中,关闭浏览器cookie就不存在了。
以下是具体参数使用方式:
为键值表。键为cookie的名称,值为cookie内容文本。如果cookie值为空则表示删除。
当前网站的域名,您可以设置为一级域名,这样所有二级三级等级别域名都可以访问到。
假设您的域名为:www.baidu.com,则域名参数可以设置为:.baidu.com,这样任何以 .baidu.com 结尾的二级三级域名都能访问到对应的cookie值,例如: image.baidu.com就能访问到。同样的道理,如果您不想cookie跨越您当前的域名,您只需要设置具体域名信息就行了,设置 image.baidu.com 则 www.baidu.com 是访问不到的。
路径可以绑定到不同的请求路径节点。
如果您想在网站任何地方都能访问到cookie值,则可以设置为“/”。
如果您只想在某个路径下所有请求都能得到cookie,则可以设置具体路径。例如您的功能命名为 book,所有 book 相关的路径都定义为 /book/ 开头,则这里可以设置为“/book/”,那么只有用户请求的网址路径为 /book/ 开头的视图函数中才能获取到对应的cookie值。
过期时间为GMT格式的时间文本。
安全传输标志位。
响应对象允许用户自定义用户的 Session ID。不过通常不建议这么做。
服务器响应.取SessionID()
服务器响应.置SessionID([Session ID])
重定向功能通知浏览器跳转到一个新的网址。
服务器响应.重定向([重定向地址], [是否为永久地址], [自动处理容器路径])
要跳转的路径。允许跨域设置为其它网站的网址。
这里值得注意的是,当在服务器处于容器模块中时,如果您没有设置参数[自动处理容器路径]或者值为“真”,您以“/”开头设置的跳转路径,会被自动转换为您所在模块的相对寻址路径。
假设网站根相对路径:/
您的容器模块绑定路径:/book/
在您的容器模块调用重定向:
服务器响应.重定向(“/index.html”, 假, 真)
则自动处理容器路径后的跳转路径为:/book/index.html
不填写时默认为“假”。设置为永久地址后,浏览器再次访问该路径时,将直接跳转到您设置的重定向地址。
永久重定向和临时重定向分别修改“响应状态”为 301(永久重定向) 和 302(临时重定向)。
该参数主要针对“/”开头的重定向相对路径。
如果为空或者设置为“真”,则路径会根据您所在的容器模块路径做对应的处理。见[重定向地址]参数说明。
如果设置为“假”时,将直接跳转到您指定的路劲而不区分是不是在模块中。如果设置为“假”时则上边的重定向例子中,最终重定向路径为“/index.html” 而不是 “/book/index.html” 。
输出文本和字节集给浏览器的操作不是实时的,只有当您的视图函数执行完成后才会执行实际的数据发送。如果写入内容的数据量比较小,响应对象会自动做GZip压缩。
服务器响应.写文本([文本内容])
直接向网页中写出文本,[文本内容]参数可重复添加。
文本内容不需要编码处理。响应对象会根据您设置的服务器编码类型,自动转换文本内容为您网站的编码。
服务器响应.写数据([数据内容])
直接向网页写数据。
您可以直接向用户发送文件。允许发送任意路径的文件。
如果您在发送文件之前已经写出过文本或者字节集,发送文件命令会执行失败。
发送文件命令和服务器发送静态文件的功能一样,允许用户断点续传。
您发送的文件响应对象会自动根据文件名称设置文档类型(Content-Type)响应头,也会根据文件尺寸和服务器配置,自动做GZip处理。
服务器响应.取默认模板路径()
返回当前视图绑定的 模板路径。
渲染数据并写出到网页。
服务器响应.渲染([模板数据], [模板路径], [渲染类型])
用于渲染模板组装的数据,类型为存取键值对,详细格式请参考之前的《模板和渲染》章节。
如果为空,响应对象会自动传递请求对象的“属性表”到模板引擎。
指定要渲染模板的路径。如果为空则使用请求路径绑定的默认模板路径。
渲染后设置响应头中的文档类型(Content-Type)。默认为 配置 中设置的“渲染-xx文档类型”属性。
使用方法和 渲染 完全一样,不同的是直接返回渲染文本,没有[渲染文档类型]参数。
响应头 | 解释 | 示例 |
---|---|---|
Accept-Ranges | 表明服务器是否支持指定范围请求及哪种类型的分段请求 | Accept-Ranges: bytes |
Age | 从原始服务器到代理缓存形成的估算时间(以秒计,非负) | Age: 12 |
Allow | 对某网络资源的有效的请求行为,不允许则返回405 | Allow: GET, HEAD |
Cache-Control | 告诉所有的缓存机制是否可以缓存及哪种类型 | Cache-Control: no-cache |
Content-Encoding | web服务器支持的返回内容压缩编码类型。 | Content-Encoding: gzip |
Content-Language | 响应体的语言 | Content-Language: en,zh |
Content-Length | 响应体的长度 | Content-Length: 348 |
Content-Location | 请求资源可替代的备用的另一地址 | Content-Location: /index.htm |
Content-MD5 | 返回资源的MD5校验值 | Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ== |
Content-Range | 在整个返回体中本部分的字节位置 | Content-Range: bytes 21010-47021/47022 |
Content-Type | 返回内容的MIME类型 | Content-Type: text/html; charset=utf-8 |
Date | 原始服务器消息发出的时间 | Date: Tue, 15 Nov 2010 08:12:31 GMT |
ETag | 请求变量的实体标签的当前值 | ETag: “737060cd8c284d8af7ad3082f209582d” |
Expires | 响应过期的日期和时间 | Expires: Thu, 01 Dec 2010 16:00:00 GMT |
Last-Modified | 请求资源的最后修改时间 | Last-Modified: Tue, 15 Nov 2010 12:45:26 GMT |
Location | 用来重定向接收方到非请求URL的位置来完成请求或标识新的资源 | Location: http://www.jimstone.com.cn/ |
Pragma | 包括实现特定的指令,它可应用到响应链上的任何接收方 | Pragma: no-cache |
Proxy-Authenticate | 它指出认证方案和可应用到代理的该URL上的参数 | Proxy-Authenticate: Basic |
refresh | 应用于重定向或一个新的资源被创造,在5秒之后重定向(由网景提出,被大部分浏览器支持) | Refresh: 5; url=http://www.jimstone.com.cn/ |
Retry-After | 如果实体暂时不可取,通知客户端在指定时间之后再次尝试 | Retry-After: 120 |
Server | web服务器软件名称 | Server: Apache/1.3.27 (Unix) (Red-Hat/Linux) |
Set-Cookie | 设置Http Cookie | Set-Cookie: UserID=JohnDoe; Max-Age=3600; Version=1 |
Trailer | 指出头域在分块传输编码的尾部存在 | Trailer: Max-Forwards |
Transfer-Encoding | 文件传输编码 | Transfer-Encoding:chunked |
Vary | 告诉下游代理是使用缓存响应还是从原始服务器请求 | Vary: * |
Via | 告知代理客户端响应是通过哪里发送的 | Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1) |
Warning | 警告实体可能存在的问题 | Warning: 199 Miscellaneous warning |
WWW-Authenticate | 表明客户端请求实体应该使用的授权方案 | WWW-Authenticate: Basic |