request 简介

request对象是web2py中常见的类型gluon.storage.storage的实例，gluon.storage.storage是python的dict的子类。

gluon.storage.storage与dict的区别：

• 可以像访问属性一样访问dict的元素。如：request.vars等价于request['vars']

• 另一个与dict不同的就是当访问的key不存在时，不抛出异常，而是返回None。

• request 有下列的属性，其中有些属性也为gluon.storage.storage类型：

属性	含义
request.cookies	cookie.simplecookie()对象，包含了HTT request中的cookies信息。它像一个cookies dictionary。
request.env	是一个storage对象，包含了传递给controller的环境变量，包括来自HTTP request的HTTP header和标准的WSGI参数。环境变量都被转化为小写，点被转化为下划线
request.application	请求的应用的名字（从request.env.path_info解析而来
request.controller	请求的controller的名字（从request.env.path_info解析而来）
request.function	请求的函数的名字（从request.env.path_info解析而来）
request.extension	extension默认为html，如果controller函数返回一个dictionary且没有指定view，extension将被用来决定使用何种view来渲染dictionary。（从request.env.path_info解析而来）
request.folder	应用程序的目录
request.now	存储了当前request的时间戳，类型为datetime.datetime
request.args	controller函数后面的URL路径组件的list，等价于request.env.path_info('/')[3:]
request.vars	storage对象包含了HTTP GET和HTTP POST的查询变量
request.get_vars	storage对象存储了HTTP GET查询变量
request.post_vars	storage对象存储了HTTP POST查询变量
request.client	client的ip地址
request.body	只读的文件流包含了HTTP request的body
request.ajax	是True，如果函数通过Ajax request被调用
request.cid	ajax request产生的组件的id
request.wsgi	一个钩子允许调用在actions里第三方的WSGI应用

• 以请求http://127.0.0.1:8000/examples/default/status/x/y/z?p=1&q=2为例：request对象如下：

variable	value
request.application	examples
request.controller	default
request.function	index
request.extension	html
request.view	status
request.folder	applications/examples/
request.args	['x', 'y', 'z']
request.vars	<Storage {'p': 1, 'q': 2}>
request.get_vars	<Storage {'p': 1, 'q': 2}>
request.post_vars	<Storage {}>
request.cid	None
request.wsgi	hook
request.env.content_length	0
request.env.content_type
request.env.http_accept	text/xml,text/html;
request.env.http_accept_encoding	gzip, deflate
request.env.http_accept_language	en
request.env.http_cookie	session_id_examples=127.0.0.1.119725
request.env.http_host	127.0.0.1:8000
request.env.http_max_forwards	10
request.env.http_referer	http://web2py.com/
request.env.http_user_agent	Mozilla/5.0
request.env.http_via	1.1 web2py.com
request.env.http_x_forwarded_for	76.224.34.5
request.env.http_x_forwarded_host web2py.com
request.env.http_x_forwarded_server 127.0.0.1
request.env.path_info	/examples/simple_examples/status
request.env.query_string	remote_addr:127.0.0.1
request.env.request_method	GET
request.env.script_name
request.env.server_name	127.0.0.1
request.env.server_port	8000
request.env.server_protocol	HTTP/1.1
request.env.web2py_path	/Users/mdipierro/web2py
request.env.we2bpy_version	Version 1.83.1
request.env.web2py_runtime_gae	(optional, defined only if GAE detected)
request.env.wsgi_errors	<open file, mode 'w' at >
request.env.wsgi_input
request.env.wsgi_multiprocess	False
request.env.wsgi_multithread	True
request.env.wsgi_run_once	False
request.env.wsgi_url_scheme	http
request.env.wsgi_version	10
request.env.http_*	变量是从request HTTP header中解析而来

response 是storage实例，它包含了下列的属性

属性	含义
response.body	包含了返回的page的body的stringio对象。
response.cookies	与request.cookies（包含了client到server的cookies）类似，但是包含了server返回给client的cookies。
response.download	一个方法用来实现controller函数允许文件的下载。
response.files	页面需要的css和js文件的列表。这些文件将被自动地连接到标准的layout.html头。当需要包含新的css和js文件，只需要将他们加入到这个list。必须注意的是文件的顺序。
response.flash	可选的参数，可以包含在views。通常用来告知用户一些变化。
response.headers	HTTP response的头得dict。
response.menu	可选的参数，可以包含在views。一般用来将导航菜单传递给views。它可以使用MENU helper来产生。
response.meta	storage对象包含了可选的meta storage信息，例如response.meta.author，response.meta.description和response.meta.keywords。meta变量的内容被web2py_ajax.html(被views/layout.html包含)自动地放置到对应的tag中。
response.postprocessing	这是一个函数list，默认为空。这些函数用来在输出被渲染前过滤一个action的输出的response对象。
response.render(view,vars)	一个方法被用来显示地在controller中调用view。view是可选参数是view文件的名字。vars是一个传给view的dict。
response.seesion_file	文件流包含了session。
response.session_file_name	包含了session被保存的文件名字。
response.session_id	当前session的id。
response.session_id_name	这个应用的session cookie的名字。
response.status	HTTP状态代码。默认为200.
response.stream	当一个controller返回它，web2py流花文件内容给client。
response.subtitle	包含在views中的可选的参数。应该包含页面的subtitle。
response.title	包含在views中的可选的参数。
response_vars	只能被view访问的一个变量。action不能访问。它包含了action返回给view的值。
response.view	用来渲染页面的view模板的名字。默认为"%s/%s.%s" % (request.controller, request.function, request.extension)。如果以上view模板不存在，则使用"generic.%s" % (request.extension) 。改变该值来修改特定的action的view文件。
response.xmlrpc	当一个controller返回它，这个函数通过xml-rpc暴露该方法。
response.js	可以包含javascript代码。

session是storage类型的实例

只要code被同一个用户执行在同一session（用户没有删除session cookies且session没有过期）， 就可以使用session.myvar = ‘hello’存储变量，使用a=session.myvar来使用变量。

• session有2个重要的方法：

属性	作用
session.forget（response）	此方法告诉web2py不保存session
session.connect（request，response，db，masterapp=None）	db是一个打开的数据库连接。此方法告诉web2py存储session到数据库而不是文件系统

web2py将创建表：

db.define_table('web2py_session', 
                Field('locked', 'boolean', default=False),
                Field('client_ip'),
                Field('created_datetime', 'datetime', default=now),
                Field('modified_datetime', 'datetime'), 
                Field('unique_key'),                 
                Field('session_data', 'text'))

且存储cpickled sessions在session_data字段。

cookies

• web2py使用python的cookies模块来处理cookies。

• 从浏览器传来的cookies存储在request.cookies。

• 从server传给client的包含在response.cookies。
  可以使用下列的方法来设置cookies：

response.cookies['mycookie'] = 'somevalue'
response.cookies['mycookie']['expires'] = 24 * 3600
response.cookies['mycookie']['path'] = '/'

• 使用cookies的方法如下：

 if request.cookies.has_key('mycookie'): 
     value = request.cookies['mycookie'].value

cache

• cache是web2py执行环境中的一个全局变量。

• cache有2个属性：

属性	含义
cache.ram	应用程序缓冲在内存中
cache.disk	应用程序缓冲在硬盘中

• 将controller函数的输出缓冲到内存中的例子：

@cache(request.env.path_info, time_expire=5, cache_model=cache.ram)
def cache_controller_in_ram():    
    import time    
    t = time.ctime()    
    return dict(time=t, link=A('click me', _href=request.url))

• 将controller的函数的输出缓冲到硬盘的例子：

@cache(request.env.path_info, time_expire=5, cache_model=cache.disk)
def cache_controller_on_disk():
    import time    
    t = time.ctime()   
    return dict(time=t, link=A('click to reload',  _href=request.url))

URL

• URL用来产生URL的路径。

例如：
URL('a', 'c', 'f', args=['x', 'y'], vars=dict(z='t')) 映射为/a/c/f/x/y?z=t。

HTTP和redirect

• HTTP其实是一个异常类

例如：
400异常raise HTTP(400, "my message") 
redirect('http://www.web2py.com') 用来转向http://www.web2py.com/。