web.py 0.2 教程

ARM 132浏览

安装

要完成整个教程,你需要安装web.py, flup, Cheetah, psycopg2 Postgres 更多安装方面的细节请见web.py主页.

URL处理


在你的编辑器中打开一个新文件,取名code.py。输入以下代码:

import web

 

这会导入web.py框架。

urls = (

 '/', 'view'

)

 

这是URL到函数的映射列表。第一部分是一个正则表达式,它用来匹配一个路径,例如如/, /help/faq, /item/(d+), 等等。 (代码 d+ 匹配的是数字串。括号表示保留匹配上的这部分内容留做以后使用。)第二部分是接收请求的类的名称,例如 viewwelcomes.hello(表示 welcomes 模块的 hello 类), get_1 1 被替换为正则表达式所保留的第一部分内容;其他保留的匹配内容被传递给函数。

class view:

 def GET(self):

这是hello类和它的GET函数。可能你已经猜到了,当有人调用HTTP GET方法时GET函数就会被调用(即有人访问你的URL时)。

 print "Hello, world!"

这会返回纯文本 'Hello, world!' 给访问者。

web.internalerror = web.debugerror

这一行告诉web.py,当发生错误时显示调试信息页。当站点正式启动后你应该把这行去掉以免用户看到它。

if __name__ == '__main__': web.run(urls, web.reloader)

这告诉web.py当本文件被执行时运行你的代码。第一个参数 urls 是前面定义的URL到函数的映射。另一个参数是一个中间件”(middleware) —— 用来协助部分程序的封装函数(wrapper functions)。这里我们用的是reloader,当源代码发生变化时它会自动重新加载代码,这样我们就不用每次都重启服务了。站点正式启动后你可能会把想把它取消掉,但是当开发的时候这个功能是极为有用的。还有一个中间件 web.profiler,它会输出每个函数运行所用的时间,这样你可以想办法让你的代码快一点儿。

执行 python code.py 来启动一个运行你的程序的web服务器,(要运行在8002端口,执行 python code.py 8002)。你也可以让code.pyCGI脚本或FastCGI脚本的形式运行 —— 它会自动处理好。(由于 web.py 基于 WSGIPython web程序接口标准,你可以用它在各种环境中,包括mod_python

现在用浏览器访问你的站点,应该会看到 'Hello, world!'

模板(Templates)


新建一个templates目录,在该目录中打开一个新的.html文件,命名为 view.html

#if $name

 I just wanted to say hello to $name.

#else

 Hello, world!

#end if

现在回到 code.py。编辑view.GET为以下内容:

 name = 'Bob'

 web.render('view.html')

现在用浏览器访问你的站点,应该会看到 'hello to Bob'

这些模板是Cheetah 模板。所有的重要特性都可以在 一页纸教程中找到 —— 基本上,它们就像是嵌入HTML(或其他任何格式)的Python代码。

警告: 现在的计划是用一种简单一点但更强大的模板来取代Cheetah。这一模板格式已经设计好了,但是实现还没有完成。

自定义 URLs


编辑你的urls为:

 '/(.*)', 'view'

现在改变view.GET的定义为:

 def GET(self, name):

并删掉给name变量赋值的语句。

现在如果你访问 /Joe 应该能看到页面显示 'hello to Joe' 如果你访问 /,则应该显示'Hello, world!'

数据库交互

web.run 那一行之上,加入:

web.db_parameters = dict(dbn='postgres', user='me', pw='pass', db='dbname')

根据你的数据库设置相应改变这些值(例如,MySQL用户可能要把dbn的值改为mysql)。

在你的数据库中创建一个简单的表:

CREATE TABLE todo (

 id serial primary key,

 title text,

 created timestamp default now(),

 done boolean default 'f'

);

以及一个示例行:

INSERT INTO todo (title) VALUES ('Learn web.py');

回到 code.py, 将这一行加到view.GET的顶部:

 todos = web.select("todo")

编辑 view.html 为:

<ul>

 #for todo in $todos

 <li id="t$todo.id">$todo.title</li>

 #end for

</ul>

现在访问你的网站应该能看到你的todo条目: 'Learn web.py'

view.html 的尾部加入:

<form method="post" action="add">

<p><input type="text" name="title" /> <input type="submit" value="Add" /></p>

</form>

urls 列表改为:

 '/', 'view',

 '/add', 'add'

编辑 view.GET 去掉多余的参数:

 def GET(self):

 

view 类后面加入:

class add:

 def POST(self):

 i = web.input()

 n = web.insert('todo', title=i.title)

 web.seeother('./#t'+str(n))

web.insert 返回新插入条目的id,然后 web.seeother 重定向用户到该条目。

速览: web.transact() 开始一次交易(transaction)web.commit() 提交它; web.rollback() 回溯。 web.update 类似 web.insert 但是它不是返回id而是接受id在表名之后做为参数(或一个WHERER子句字符串)。

现在你可以添加 todo 条目到列表中了。

另附: 存储对象


web.input web.query 以及web.py中的其他一些东西会返回存储对象”("Storage objects")。一个存储对象就像一个字典(dictionary),但是d.food['foo']是一样的。这省去了很多打字时间。

Cookies

<!-- Work into examples. -->Cookies web.input 的工作方式基本是一样的。 web.cookies() 返回一个包含所有已设置cookies的存储对象。 web.setcookie(name, value, expires="") 用来设置cookies

web.input web.cookies 接受一些参数和关键词参数。例如,如果你调用 web.input('color', times=1),而它没接收到叫color的查询参数,它会抛出错误;如果没接收到 times 参数它会将其设为1

一种常见做法是:

try: i = web.input('foo', bar=2)

except KeyError: return web.badrequest()