python类库26[web2py之基本概念]


 一 web2py的应用的执行环境
Models,Controllers和views所在的执行环境中,以下对象已经被默认地导入:

Global Objects:
  request,response,session,cache

Navigation:
  redirect,HTTP

Internationalization:
  T

Helpers:
  XML, URL, BEAUTIFYA, B, BEAUTIFY, BODY, BR, CENTER, CODE, DIV, EM, EMBED,FIELDSET, FORM, H1, H2, H3, H4, H5, H6, HEAD, HR, HTML,I, IFRAME, IMG, INPUT, LABEL, LEGEND, LI, LINK, OL, UL,MARKMIN, MENU, META, OBJECT, ON, OPTION, P, PRE, SCRIPT,OPTGROUP, SELECT, SPAN, STYLE, TABLE, TAG, TD, TEXTAREA,TH, THEAD, TBODY, TFOOT, TITLE, TR, TT, URL, XHTML, xmlescape, embed64

validators:
  CLEANUP, CRYPT, IS_ALPHANUMERIC, IS_DATE_IN_RANGE, IS_DATE,IS_DATETIME_IN_RANGE, IS_DATETIME, IS_DECIMAL_IN_RANGE,IS_EMAIL, IS_EMPTY_OR, IS_EXPR, IS_FLOAT_IN_RANGE, IS_IMAGE,IS_IN_DB, IS_IN_SET, IS_INT_IN_RANGE, IS_IPV4, IS_LENGTH,IS_LIST_OF, IS_LOWER, IS_MATCH, IS_EQUAL_TO, IS_NOT_EMPTY,IS_NOT_IN_DB, IS_NULL_OR, IS_SLUG, IS_STRONG, IS_TIME,IS_UPLOAD_FILENAME, IS_UPPER, IS_URL

Database:
  DAL, Field

 

其他的一些不常用的对象需要用户显示的导入,如Auth,Crud和Service等,如下:from gluon.tools import Auth, Crud, Service.

 

二 web2py的核心对象

1) 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()对象,包含了HTTP 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中解析而来.

 

2) response 

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代码。 

 

3)session

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字段。


4)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

 

 

5)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))
 
6)URL
URL用来产生URL的路径。例如URL('a', 'c', 'f', args=['x', 'y'], vars=dict(z='t')) 映射为/a/c/f/x/y?z=t。

 

7)HTTP和redirect
HTTP其实是一个异常类,如400异常raise HTTP(400, "my message")
redirect('http://www.web2py.com') 用来转向http://www.web2py.com/

 

 

完1


作者:iTech
微信公众号: cicdops
出处:http://itech.cnblogs.com/
github:https://github.com/cicdops/cicdops

posted @ 2011-04-20 22:04  iTech  阅读(3096)  评论(0编辑  收藏  举报