edit

cookbook/ctx.zh-cn.md

@@ -0,0 +1,51 @@
+---
+layout: default
+title: web.ctx
+---
+
+# web.ctx
+
+问题
+-------
+
+如何在代码中得到客户端信息？比如：来源页面(referring page)或是客户端浏览器类型
+
+解法
+--------
+
+使用web.ctx即可。首先讲一点架构的东西：web.ctx基于threadeddict类，又被叫做ThreadDict。这个类创建了一个类似字典(dictionary-like)的对象，对象中的值都是与线程id相对应的。这样做很妙,因为很多用户同时访问系统时，这个字典对象能做到仅为某一特定的HTTP请求提供数据(因为没有数据共享，所以对象是线程安全的)
+
+web.ctx保存每个HTTP请求的特定信息，比如客户端环境变量。假设，我们想知道正在访问某页面的用户是从哪个网页跳转而来的：
+
+例子
+-------
+
+    class example:
+        def GET(self):
+            referer = web.ctx.env.get('HTTP_REFERER', 'http://google.com')
+            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` – 包含响应实体的字符串。