beatx蓝牙版本:[Python]使用web.py创建一个blog

otherrrr@gmail.com原创，转载请注明原作者地址：otherrrr 的百度空间。

注：本文针对web.py 0.23版，以及python 2.5.1；
      如果您使用web.py 0.1x版，或python 2.4.x，
      那么有些功能会有所不同

01、准备工作

先安装Python，然后安装web.py。
不会安装的朋友，参考本博客的其他文章。
数据库我准备使用Python自带的sqlite，因此不用另安装其他数据库。
（我的运行环境是在Windows 2003下面，因为Python是跨平台的，所以理论上在Linux下面一样可行，但是我没有测试）
当前程序版本：Python 2.5.1，web.py 0.23。
（Python的官方网站：http://www.python.org）
（web.py的官方网站：http://webpy.org）

02、数据库

数据库我是用sqlite，主要是我并不会做一个大大大大的blog，用mysql是不是太浪费了？
而且sqlite现在python也集成了，用起来很方便。
（当然也可以用mysql，很流行的，如果想使用mysql的话，请搜一下“MySQLdb”）
（在web.py 0.23版本中，目前只支持3种数据库：postgres、mysql、sqlite）

那么不用数据库可不可以？当然可以。我其实很喜欢用txt文件，呵呵。
但是大家都用，我们最好也用。
（很久很久之后的将来，你会发现用数据库的好处）

我创建一个Python源程序文件：database.py，然后写一些代码来创建一个数据库，并插入一些文件。

代码如下：

# -*- coding: cp936 -*-

import sqlite3 # 导入sqlite模块

con = sqlite3.connect("blog.db") # 连接到数据库文件

cur = con.cursor() # 创建一个指针

cur.execute("create table user1 (date, number, article)") # 创建1个表格，并创建3个域

tt1 = (’2007-10-11′, ’1′, ‘aaa’) # 准备要插入的数据

cur.execute("""insert into user1 (date, number, article) values(?,?,?)""", tt1) # 插入数据

tt2 = (’2008-01-19′, ’2′, ‘bbbbb’) # 再插入一组数据

cur.execute("""insert into user1 (date, number, article) values(?,?,?)""", tt2)

tt3 = (’1997-03-25′, ’3′, ‘cc’) # 再再插入一组数据

cur.execute("""insert into user1 (date, number, article) values(?,?,?)""", tt3)

con.commit() # 执行操作

cur.close() # 关闭指针

con.close() # 关闭数据库连接

如果你会SQL的话上面的东西就很好理解，不会的的话，也很好理解，是不是？
数据库的连接——关闭，指针的创建——关闭，先建立一个表格，表格中有域，可以插入数据。
（你用过Excel没有？差不多都是一样的）

有可能你不太理解为什么要把插入的数据写成(’2007-10-11′, ’1′, ‘aaa’)这样的。
这样的数据结构是一个tuple（元祖），据说这样可以防止“数据库的注入式漏洞”。

好了，运行一下database.py吧，会在同目录下出现一个文件“blog.db”。这就是我们的数据库！

（最好能看一下Python Library Reference的13.13 sqlite3 — DB-API 2.0 interface for SQLite databases）
（这里面会对python里面内置的sqlite3做一个简单但是非常有用的介绍）

03、第一个页面

我们现在来写第一个页面，看看web.py到底能不能跑起来。

代码如下：

import web

urls = (
    ‘/’, ‘index’,
)
class index:
    def GET(self):
        print ‘index’

if __name__ == "__main__":
    web.run(urls, globals())

保存为：blog_1.py。并运行之。
注意：一定要在命令提示符下运行！

可以在命令提示符下面看到：http://0.0.0.0:8080/，
打开IE，访问：http://127.0.0.1:8080/，
可以看到“index”了，是不是？

04、整体架构

现在让我们冷静一下，先想想我们要做的这个Blog的整体架构。
虽然我们要做个最最最简单的Blog，但是还是要先想好然后再动手。

首先，要能“显示”，能显示每个用户的文章、序号、以及日期。

然后，要能“登陆”，只有“登陆”之后才能“写文章”。

我就想到这两点，我认为这就是一个blog的雏形了。

那么我们需要几个页面呢？

第1个：主页面，显示所有用户的文章。

第2个：登陆页面，用户在这里输入用户名和密码

第3个：显示页面，显示某个用户的文章

第4个：编辑页面，用户在这里写新文章

（当然，有一些功能也很重要，比如“修改”，比如“图片”之类，慢慢来添加好不好？）

05、主页面

现在我们来做主页面，要能显示数据库中的数据。

我们直接来修改blog_1.py。

在import web这行代码的下面添加：

import sqlite3

把print ‘index’这行代码删除，
添加：

        con = sqlite3.connect("blog.db")
        cur = con.cursor()
        cur.execute(‘select * from user1′)
        for row in cur:
            print row       
        cur.close()
        con.close()

把这个文件另存为：blog_2.py。并运行之（记住要在命令提示符下运行）。
然后我们打开IE，输入：http://127.0.0.1:8080/

我看到了：(u’2007-10-11′, u’1′, u’aaa’) (u’2008-01-19′, u’2′, u’bbbbb’) (u’1997-03-25′, u’3′, u’cc’)
你看到了没有？

06、主页面的第1次修改

其实blog_2.py是一个相当不成熟的例子，我想你也能感觉出来。
因为数据库不是这样用的，web.py是一个框架（Framework），
它提供了数据库和模板的方便调用方法，这也是我们使用框架的原因。

现在让我们来使用数据库吧。
我们直接修改blog_1.py文件。

先在：web.run(urls, globals())这一行上面添加：
web.config.db_parameters = dict(dbn=’sqlite’, db=’blog.db’)
（这一行代码是配置数据库的，mysql的话还需要添加用户名和密码）
其中dbn表示数据库的名称，我们填入sqlite；
db表示具体数据库的文件名称，我们填入blog.db。
（注意：一定要加后缀名）

然后把print ‘index’这行代码删除，
添加新的代码：

        user1 = web.select("user1")
        print user1[0].date
        print len(list(user1))
（第1行是遍历出整个user1表，第2行显示user1表的第1个元素的number值，第3行显示user1表的长度）
（关于第3行看上去会有点奇怪，但是如果你试着用len(user1)这样就会出错，请试着理解，这就是“数据库的方式”）

其中第1行可以改为user1 = web.query("select * from user1")，显示出来的东西会是完全一样的。
为什么呢？
因为本质上是一样的。但是web.query是用作查询之用的，最好还是专职专用。
（详细的还是要看C:\Python25\Lib\site-packages\web文件夹下面的db.py）

把这个文件另存为：blog_3.py。并运行之。
在127.0.0.1:8080下面我们应该能够看到：“2007-10-11 2”

其中“2007-10-11”是user1[0].date的值；
“2”是“数据库游标之后部分的长度”。
游标是什么呢？即cursor（游标，指针），它指向数据库的当前位置。

接下来，你可以试试把user1[0].number改成user1[1].number或者user[2].article，看看会显示出来什么。

07、 主页面的第2次修改

我们试着来显示数据库中所有的元素。

直接修改blog_3.py，其实主要就是修改index类中的GET方法。代码如下：

class index:
    def GET(self):
        user1 = web.select("user1")
        user1_len = len(list(user1)) #数据库长度
        user1_date = web.select("user1") #得到日期
        user1_number = web.select("user1") #得到序号
        user1_article = web.select("user1") #得到文章内容
for i in range(0, user1_len):
     print user1_date[i].date, \
                  user1_number[i].number, \
                  user1_article[i].article

另存为blog_4.py，并运行之，应该能看到：2007-10-11 1 aaa 2008-01-19 2 bbbbb 1997-03-25 3 cc

或者改为：

class index:
    def GET(self):
        user1 = web.select("user1")
        user1_len = len(list(user1)) #数据库长度
        user1_date = web.query("select date from user1") #得到日期
        user1_number = web.query("select number from user1") #得到序号
        user1_article = web.query("select article from user1") #得到文章内容
        for i in range(0, user1_len):
            print user1_date[i].date, \
                  user1_number[i].number, \
                  user1_article[i].article

另存，运行，得到的结果也和上面的一模一样。
主要区别在于调用的方法不同，一个是web.select一个是web.query。
（我看到别人写的一个程序，好像都是用的web.query）

虽然这样可以显示，不过好丑！
怎么办？用模板！

08、 用模板

（模板的英文是templates）

我们一步一步来看看模板怎么用。

首先，先创建一个目录，名字就是templates。

然后，在这个目录里面创建一个文件，名字是index.html。

那么往这个index.html上面写些什么呢？

$def with (user1_date)

$user1_date[0].date

在blog_4.py上面直接修改，在import web的下一行加上：

render = web.template.render(‘templates/’)

然后另存为blog_5.py。
这主要是告诉程序模板文件的位置。

然后修改index类的GET方法，原先的代码统统删掉，新代码如下：

user1_date = web.query("select date from user1") #得到日期
print render.index(user1_date)

好了，现在保存，然后运行blog_5.py吧。
我看到了：2007-10-11
你呢？

09 蛋炒饭

我放弃web.py有一段时间了。主要是因为自己在做：
http://code.google.com/p/ssqpython/项目。
但是因为空间的问题，SSQPython项目也搁置了，
于是回头来看web.py。

web.py官方发布版本还没有更新，还是0.23（到2008-04-22为止）。
据说在下一个版本0.3中，会更改render的显示方式，把print改为return。

现在准备重新把这个炒起来。
（注：其实我注意到了在code.google.com上面有类似的项目）

我们先来重新完整的考虑一下整个blog系统的架构：
（注：如果你是从一开始来看本文章的，也许到了这里你会有一点失望，
      因为我会重新来做，不过前面就当作热身了，好不好？）
- 登陆页面(login.html) —- （这个页面也同时作为注册页面，这样好吗？）
- 浏览页面(blog.html) —- （这个页面也是主页面，即在不登陆的情况下显示此页面）
- 发表页面(post.html)
以上3个页面是用户（user）的页面。
我在这里省去了很多东西，比如：回复文章功能、修改文章功能、删除文章功能等等。
而且将来可以添加用户信息显示及自定义功能。

我们再来考虑一下管理员（admin）的页面：
- 登陆页面(login.html) —- （管理员就不能有注册页面了，要在后台进行注册及密码修改等操作）
- 查看页面(index.html) —- （浏览用户的数据，可删除用户、删除文章……）
以上2个页面也不是很完整，还有许多功能需要添加，但是目前我还没有想到还有什么功能是必须的。

至于“登出”功能则会在每个页面都显示一个按钮的方式来实现。

这些架构的思考目前还不是很完善，我也是在一步一步摸索中……
（注：其实“标签”或者“类别”的功能很重要，这个将来也要完善）

10 大排面（主浏览页面–生成数据库）

我们现在假设数据库中有很多很多数据，我们现在只是要把它们显示出来。
这个显示页面是主浏览页面(index.html)。

首先我们来生成这样的数据。
我们创建一个db.py文件。
文件内容如下：

import sqlite3

con = sqlite3.connect(‘blog.db’)
cur = con.cursor()

cur.execute(‘create table article \
(articleID, articleTitle, articleContent, \
articleAuthor, articleTime)’)

insert_datas = (’1′, ‘title_1′, ‘content_1′, ‘user_1′, ’2008-01-01′)
cur.execute(‘insert into article \
(articleID, articleTitle, articleContent, \
articleAuthor, articleTime) values (?, ?, ?, ?, ?)’, \
insert_datas)

con.commit()                  
cur.close()
con.close()

运行：python db.py
则会生成：blog.db文件

在这个数据库中有1个表（table），
这个表有5个域（field）或者说是5个列（column），
分别是：文章的ID号（这个会从1开始排列到无穷大）
        文章的标题
        文章的内容
        文章的作者
        文章的时间（这里当前记录的文章的发表时间，将来会有另一个来记录修改时间）

11 大肉面（主浏览页面–主程序文件）

我们再创建一个blog.py，这个会是我们这个blog的主程序文件。

import web

render = web.template.render(‘templates/’)

urls = (
    ‘/’, ‘index’,
)

class index:
    def GET(self):
        datas = web.query("select * from article order by articleID desc")
        print render.index(datas)

if __name__ == "__main__":
    web.webapi.internalerror = web.debugerror
    web.config.db_parameters = dict(dbn=’sqlite’, db=’blog.db’)
    web.run(urls, globals(), web.reloader)

在这里我们定义了模板（template）的位置：templates文件夹。
并且定义了当访问“/”的时候，调用index类。
这表示我们访问127.0.0.1的时候，会显示index类中的print内容。

并且我们开启了debug，即：web.webapi.internalerror = web.debugerror
并设置数据库为sqlite，访问文件为blog.db。

12 炸酱面（主浏览页面–模板）

我们先创建一个文件夹：templates。
在这个文件夹下面创建一个index.html文件，这个文件就是我们用到的模板。
文件内容如下：

$def with (datas)