python网络编程学习笔记(10)：webpy框架

django和webpy都是python的web开发框架。Django的主要目的是简便、快速的开发数据库驱动的网站。它强调代码复用,多个组件可以很方便的以“插件”形式服务于整个框架，Django有许多功能强大的第三方插件，你甚至可以很方便的开发出自己的工具包。这使得Django具有很强的可扩展性。它还强调快速开发和DRY(Do Not Repeat Yourself)原则。webpy小巧，简单，实用，可以快速的完成简单的web页面。这里根据webpy Cookbook简要的介绍一下webpy框架，更加详细请见http://webpy.org/cookbook/index.zh-cn。

一、安装与开发

    web.py下载地址：http://webpy.org/static/web.py-0.33.tar.gz。解压并拷贝web文件夹到你的应用程序目录下。或者，为了让所有的应用程序都可以使用，运行：

python setup.py install

注意: 在某些类unix系统上你可能需要切换到root用户或者运行：

sudo python setup.py install

也可以直接把里面的WEB文件夹放site-packages 。
    web.py 内置了web服务器，代码写完后，将其保存，例如文件名为mywebpy.py，可以用下面的方法来启动服务器：

python mywebpy.py

打开你的浏览器输入 http://localhost:8080/ 查看页面。 若要制定另外的端口，使用 python mywebpy.py 1234。

二、URL 处理

    任何网站最重要的部分就是它的URL结构。你的URL并不仅仅只是访问者所能看到并且能发给朋友的。它还规定了你网站运行的心智模型。在一些类似del.icio.us的流行网站 , URL甚至是UI的一部分。 web.py使这类强大的URL成为可能。

urls = (
  '/', 'index'
)

第一部分是匹配URL的正则表达式，像/、/help/faq、/item/(\d+)等(\d+将匹配数字)。圆括号表示捕捉对应的数据以便后面使用。第二部分是接受请求的类名称，像index、view、welcomes.hello (welcomes模块的hello类)，或者get_\1。\1 会被正则表达式捕捉到的内容替换，剩下来捕捉的的内容将被传递到你的函数中去。这行表示我们要URL/(首页)被一个叫index的类处理。现在我们需要创建一个列举这些url的application。
app = web.application(urls, globals())
这会告诉web.py去创建一个基于我们刚提交的URL列表的application。这个application会在这个文件的全局命名空间中查找对应类。
    一般来说，在每个应用的最顶部，你通常会看到整个URL调度模式被定义在元组中:

urls = (
    "/tasks/?", "signin",
    "/tasks/list", "listing",
    "/tasks/post", "post",
    "/tasks/chgpass", "chgpass",
    "/tasks/act", "actions",
    "/tasks/logout", "logout",
    "/tasks/signup", "signup"
)

这些元组的格式是: URL路径, 处理类 。

你可以利用强大的正则表达式去设计更灵活的URL路径。比如 /(test1|test2) 可以捕捉 /test1 或 /test2。要理解这里的关键，匹配是依据URL路径的。比如下面的URL:
http://localhost/myapp/greetings/hello?name=Joe
这个URL的路径是 /myapp/greetings/hello。web.py会在内部给URL路径加上和$ ，这样 /tasks/ 不会匹配 /tasks/addnew。URL匹配依赖于“路径”，所以不能这样使用，如： /tasks/delete?name=(.+) ,?之后部分表示是“查询”，并不会被匹配。阅读URL组件的更多细节，请访问web.ctx。

你可以捕捉URL的参数，然后用在处理类中:
/users/list/(.+), "list_users"
在 list/后面的这块会被捕捉，然后作为参数被用在GET或POST:

class list_users:
    def GET(self, name):
        return "Listing info about user: {0}".format(name)

你可以根据需要定义更多参数。同时要注意URL查询的参数(?后面的内容)也可以用web.input()取得。

三、hello world

    现在我们需要来写index类。虽然大多数人只会看看，并不会注意你的浏览器在使用用于与万维网通信的HTTP语言。具体的细节并不重要，但是要理解web访问者请求web服务器去根据URL(像/、/foo?f=1)执行一个合适的函数（像GET、POST）的基本思想。GET用于请求网页文本。当你在浏览器输入harvard.edu，它会直接访问Harvard的web服务器，去GET /。 POST经常被用在提交form，比如请求买什么东西。每当提交一个去做什么事情(像使用信用卡处理一笔交易)的请求时，你可以使用POST。这是关键，因为GET的URL可以被搜索引擎索引，并通过搜索引擎访问。虽然大部分页面你希望被索引，但是少数类似订单处理的页面你是不希望被索引的。
在我们web.py的代码中，我们将这两个方法明确区分:

class index:
    def GET(self):
        return "Hello, world!"

当有人用GET请求/时，这个GET函数随时会被web.py调用。
好了，限制我们只需要最后一句就写完了。这行会告诉web.py开始提供web页面:

if __name__ == "__main__": app.run()

这会告诉web.py为我们启动上面我们写的应用。
于是将上面的代码完整列出如下：

import web
urls = (
    '/', 'index'
)
class index:
    def GET(self):
        return "Hello, world!"
if __name__ == "__main__":
    app = web.application(urls, globals())
    app.run()

保存为hello.py，运行后显示：
http://0.0.0.0:8080/
在浏览器中输入http://127.0.0.1:8080，就会出现hello world!页面。

四、模板

    给模板新建一个目录（命名为 templates），在该目录下新建一个以 .html 结尾的文件，这里存为index.html，内容如下：

<em>Hello</em>, world!

你也可以在模板中使用 web.py 模板支持代码：

$def with (name)
$if name:
    I just wanted to say <em>hello</em> to $name.
$else:
    <em>Hello</em>, world!

如上，该模板看起来就像 python 文件一样，除了顶部的 def with (表示从模板将从这后面取值)和总是位于代码段之前的$。当前，template.py 首先请求模板文件的首行 $def 。当然，你要注意 web.py 将会转义任何用到的变量，所以当你将name的值设为是一段HTML时，它会被转义显示成纯文本。如果要关闭该选项，可以写成 $:name 来代替 $name。

在code.py第一行之下添加：

render = web.template.render('templates/')

这会告诉web.py到你的模板目录中去查找模板。然后把 index.GET改成: 告诉 web.py 在你的模板目录下查找模板文件。修改 index.GET ：

name = 'Bob'    
return render.index(name)

完整代码为：

##@小五义
import web
render = web.template.render('templates/')
urls = (
    '/', 'index'
)
class index:
    def GET(self):
        name='Bob'
        return render.index(name)
        #return "Hello, world!"
if __name__ == "__main__":
    app = web.application(urls, globals())
    app.run()

访问站点它将显示 I just wanted to say hello to Bob。

但是如果我们想让用户自行输入他的名字，如下：

i = web.input(name=None)
return render.index(i.name)

访问 / 将显示 hello world，访问 /?name=Joe 将显示 I just wanted to say hello to Joe。
URL 的后面的 ? 看起来不好看，修改下 URL 配置：
'/(.*)', 'index'

然后修改下 GET：

def GET(self, name):
    return render.index(name)

完整代码为：

##@小五义 
import web 
render = web.template.render('templates/') 
urls = ( 
    '/(.*)', 'index' 
) 
class index: 
    def GET(self,name): 
        i=web.input(name=None) 
        return render.index(name) 
        #return "Hello, world!" 
if __name__ == "__main__": 
    app = web.application(urls, globals()) 
    app.run()

现在访问http://127.0.0.1:8080/TOM ，它会显示I just wanted to say hello to TOM. 如果访问http://127.0.0.1:8080/，它会显示Hello, world!

五、表单

1、简介

       表单包括Textbox、Password 、Textarea 、Dropdown、Radio、Checkbox、Button具体使用及样式如下：

login = form.Form(
    form.Textbox('username'),
    form.Password('password'),
    form.Password('password_again'),
    
    form.Button('Login'),
    form.Checkbox('YES'),
    form.Checkbox('NO'),
    form.Textarea('moe'),
    form.Dropdown('SEX', ['man', 'woman']),
    form.Radio('time',['2012-01-01','20120101']),
    validators = [form.Validator("Passwords didn't match.", lambda i: i.password == i.password_again)]
)

显现在页面中：

2、输入属性
如：

form.textbox("firstname",
    form.notnull, #put validators first followed by optional attributes
    class_="textEntry", #gives a class name to the text box -- note the underscore
    pre="pre", #directly before the text box
    post="post", #directly after the text box
    description="please enter your name", #describes field, defaults to form name ("firstname")
    value="bob", #default value
    id="nameid", #specify the id
)

3、例子：

##code.py
##@小五义
import web,os
from web import form
render = web.template.render("d:/webpy/templates")##这里仿照http://webpy.org/form#example最初使用了相对路径templates/,但总是发生找不到formtest的错误，于是搜索后，发现换成绝对路径可以解决这一问题。
urls = (
    '/', 'index',
)
app = web.application(urls, globals())
login = form.Form(
    form.Textbox('username'),
    form.Password('password'),
    form.Password('password_again'),
    
    form.Button('Login'),
    form.Checkbox('YES'),
    form.Checkbox('NO'),
    form.Textarea('moe'),
    form.Dropdown('SEX', ['man', 'woman']),
    form.Radio('time',['2012-01-01','20120101']),
    validators = [form.Validator("Passwords didn't match.", lambda i: i.password == i.password_again)]
)
   
class index:
    def GET(self):
        f=login()
        return render.formtest(f)
    def POST(self):
        f=login()
        if not f.validates():
            return render.formtest(f)
        else:
            return "HAHA!"
if __name__ == "__main__":
    web.internalerror = web.debugerror
    app.run()

d:/webpy/templates文件夹下存放formtest.html文件，文件代码如下：

$def with (form)
<form name="main" method="post"> 
$if not form.valid: <p class="error">Try again,Passwords didn't match:</p>
$:form.render()
<input type="submit" />    </form>

运行code.py，然后在浏览器中浏览页面如下：

填写表格后，如果两次password相同，那么会显示HAHA!，否则显示Try again, Passwords didn't match:。

六、数据库

1、数据库的连接
    在开始使用数据库之前，确保已经安装了合适的数据库访问库。比如对于MySQL数据库，使用 MySQLdb ，对于Postgres数据库使用psycopg2。
创建一个数据库对象：db = web.database(dbn='postgres', user='username', pw='password', db='dbname')
2、数据库读取
    例，在数据库test中有一个表testtable，字段是name，在上面code.py中进行修改，如果login成功，那么列出test表中的内容。

code.py

##@小五义
import web,os
from web import form
db = web.database(dbn='postgres', user='postgres', pw='password', db='test')
render = web.template.render("d:/webpy/templates")
urls = (
    '/', 'index',
)
app = web.application(urls, globals())
login = form.Form(
    form.Textbox('username'),
    form.Password('password'),
    form.Password('password_again'),
    form.Button('Login'),
    form.Checkbox('YES'),
    form.Checkbox('NO'),
    form.Textarea('moe'),
    form.Dropdown('SEX', ['man', 'woman']),
    form.Radio('time',['2012-01-01','20120101']),
    validators = [form.Validator("Passwords didn't match.", lambda i: i.password == i.password_again)]
)
class index:
    def GET(self):
        f=login()
        return render.formtest(f)
    def POST(self):
        f=login()
        if not f.validates():
            return render.formtest(f)
        else:
            testtables = db.select('testtable')
            return render.index(testtables)

if __name__ == "__main__":
    web.internalerror = web.debugerror
    app.run()

##index.html

$def with (testtables)
<ul>
$for testtable in testtables:
    <li id="t$testtable.name">$testtable.name</li>
</ul>

当login正确后，会列出testtable表中name字段的值。

3、数据库写入
如将上面的FORM表中的user加入到testtable表name字段中，很简单，只需要在上面的代码中加入一句：n=db.insert('voa',filename=f['username'].value)。
现在，对code.py代码进行修改后，当表单填写正确后，会将username加入到testtable表中，完整代码如下：

##@小五义
import web,os
from web import form
db = web.database(dbn='postgres', user='postgres', pw='password', db='bbstime')
render = web.template.render("d:/webpy/templates")
urls = (
    '/', 'index',
)
app = web.application(urls, globals())
login = form.Form(
    form.Textbox('username'),
    form.Password('password'),
    form.Password('password_again'),
    form.Button('Login'),
    form.Checkbox('YES'),
    form.Checkbox('NO'),
    form.Textarea('moe'),
    form.Dropdown('SEX', ['man', 'woman']),
    form.Radio('time',['2012-01-01','20120101']),
    validators = [form.Validator("Passwords didn't match.", lambda i: i.password == i.password_again)]
)
class index:
    def GET(self):
        f=login()
        return render.formtest(f)
    def POST(self):
        f=login()
        if not f.validates():
            return render.formtest(f)
        else:
            n=db.insert('voa',filename=f['username'].value)
            voas = db.select('voa')
            return render.index(voas)
if __name__ == "__main__":
    web.internalerror = web.debugerror
    app.run()