web.ctx

问题

如何在代码中得到客户端信息？比如：来源页面(referring page)或是客户端浏览器类型

解法

使用web.ctx即可。首先讲一点架构的东西：web.ctx基于threadeddict类，又被叫做ThreadDict。这个类创建了一个类似字典(dictionary-like)的对象，对象中的值都是与线程id相对应的。这样做很妙,因为很多用户同时访问系统时，这个字典对象能做到仅为某一特定的HTTP请求提供数据(因为没有数据共享，所以对象是线程安全的)

web.ctx保存每个HTTP请求的特定信息，比如客户端环境变量。假设，我们想知道正在访问某页面的用户是从哪个网页跳转而来的：

例子

  1. class example:
  2.     def GET(self):
  3.         referer = web.ctx.env.get('HTTP_REFERER', 'http://google.com')
  4.         raise web.seeother(referer)

上述代码用web.ctx.env获取HTTP_REFERER的值。如果HTTP＿REFERER不存在，就会将google.com做为默认值。接下来，用户就会被重定向回到之前的来源页面。

web.ctx另一个特性，是它可以被loadhook赋值。例如：当一个请求被处理时，会话(Session)就会被设置并保存在web.ctx中。由于web.ctx是线程安全的，所以我们可以象使用普通的python对象一样，来操作会话(Session)。

‘ctx’中的数据成员

Request

  • environ 又被写做. env – 包含标准WSGI环境变量的字典。
  • home – 应用的http根路径(译注：可以理解为应用的起始网址，协议＋站点域名＋应用所在路径)例：http://example.org/admin
  • homedomain – 应用所在站点(可以理解为协议＋域名) http://example.org
  • homepath – 当前应用所在的路径，例如： /admin
  • host – 主机名（域名）＋用户请求的端口（如果没有的话，就是默认的80端口），例如： example.org, example.org:8080
  • ip – 用户的IP地址，例如： xxx.xxx.xxx.xxx
  • method – 所用的HTTP方法，例如： GET
  • path – 用户请求路径，它是基于当前应用的相对路径。在子应用中，匹配外部应用的那部分网址将被去掉。例如：主应用在code.py中，而子应用在admin.py中。在code.py中, 我们将/admin关联到admin.app。 在admin.py中, 将/stories关联到stories类。在 stories中, web.ctx.path就是/stories, 而非/admin/stories。形如： /articles/845
  • protocol – 所用协议，例如： https
  • query – 跟在’？’字符后面的查询字符串。如果不存在查询参数，它就是一个空字符串。例如： ?fourlegs=good&twolegs=bad
  • fullpath 可以视为 path + query – 包含查询参数的请求路径，但不包括’homepath’。例如：/articles/845?fourlegs=good&twolegs=bad

Response

  • status – HTTP状态码（默认是’200 OK’) 401 Unauthorized 未经授权
  • headers – 包含HTTP头信息(headers)的二元组列表。
  • output – 包含响应实体的字符串。