Flask 教程，第四部分：数据库 已翻译 100%

这是我的在python中使用the Flask 微框架开发web程序系列的第四篇文章。本系列教程的目标是开发一个全面的围脖，姑且叫微薄吧。

这是系列文章的目录

• Part I: Hello, World!
  
• Part II: 模板
• Part III: web表单
• Part IV: 数据库
• Part V: 用户登录
• Part VI: 属性和头像
• Part VII: 单元测试
• Part VIII: 收听、@和好友
• Part IX: 分页
• Part X: 全文搜索
• Part XI: Email 支持
• Part XII: 翻新

回顾一下

在上一章中，我们创建了一个登录表单，并且完成了数据提交和验证的工作。

在这一章里，我们将要创建一个可以记录我们网站用户的数据库。

学习这章你需要有上一章的 微博(microblog) 程序，并且确保它能够正常的运行。 

命令行方式运行Python脚本

在这个章节中，我们将写一些简单的数据库管理脚本。在此之前让我们来复习一下如何通过命令行方式执行Python脚本.

如果Linux 或者OS X的操作系统，需要有执行脚本的权限。例如：

chmod a+x script.py

该脚本有个指向使用解释器的命令行。再脚本赋予执行权限后就可以通过命令行执行，就像这样： like this:

./script.py <arguments>

然而，在Windows系统上这样做是不行的，你必须提供Python解释器作为必选参数，如：

flask/Scripts/python script.py <arguments>

为了避免Python解释器路径输入出错，你可以将你的文件夹microoblog/flask/Scripts添加到系统路径，确保能正常显示Python解释器。

从现在开始，在Linux/OS X上的语句简洁。如果你使用Windows系统请记得转换语句。 

在Flask使用数据库

我们将使用Flask-SQLAlchemy 的扩展来管理数据库。由SQLAlchemy项目提供的，已封装了关系对象映射（ORM）的一个插件。

ORMs允许数据库程序用对象的方式替代表和SQL语句。面向对象的操作被ORM转化为数据库命令。这样就意味着，不用sql语句，让Flask-SQLAlchemy为我们执行sql语句。

迁移

大多数数据库教程都覆盖了创建和使用一个数据库的方法，但是没有充分解决当应用程序扩展时数据库更新的问题。通常，你会删除旧的数据库，然后再创建一个新的数据库来达到更新的效果，这样就丢失了所有的数据。如果这些数据创建起来很费劲，那么我们不得不写导入导出的脚本了。

幸运的是，我们有了更好的方案.

我们现在可以使用SQLAlchemy-migrate做数据库迁移的更新了，虽然它增加了数据库启动时的负担，但这点小小的代价还是值得的，毕竟我们不用担心手动迁移数据库的问题了。

理论学习完毕，我们开始吧！

配置

我们的小程序使用sqlite数据库。sqlite是小程序数据库的最佳选择，一个可以以单文件存储的数据库。

在我们的配置文件中添加新的配置项 (fileconfig.py):

import os
basedir = os.path.abspath(os.path.dirname(__file__))

SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(basedir, 'app.db')
SQLALCHEMY_MIGRATE_REPO = os.path.join(basedir, 'db_repository')

SQLALCHEMY_DATABASE_URI是the Flask-SQLAlchemy必需的扩展。这是我们的数据库文件的路径。

SQLALCHEMY_MIGRATE_REPO 是用来存储SQLAlchemy-migrate数据库文件的文件夹。

最后，初始化应用的时候也需要初始化数据库。这里是升级后的init文件(fileapp/__init)：

from flask import Flask
from flask.ext.sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config.from_object('config')
db = SQLAlchemy(app)

from app import views, models

注意生成的脚本已改动2个地方。我们现在开始创建数据库的adb对象，引用新的模块。马上来写这个模块。

数据库模型

我们在数据库存储的数据通过数据库model层被映射为一些类里面的对象，ORM层将根据类对象映射到数据库对应的字段.

让我们来创建个映射到users的model。使用WWW SQL Designer工具，我们创建了代表users表的一个图标:

id字段通常作为主键的形式用在所有的models里面，每个在数据库中的user都有一个指定的唯一id值。幸运的是，这些都是自动的，我们只需要提供一个id字段。

nickname和email字段被定义为string类型，他们的长度也已经被指定，这样可以节省数据库存储空间。

role字段被定义为integer类型，我们用来标识users是admins还是其他类型。

现在我们已经明确了users表的结构，接下来转换为编码的工作将相当简单了(fileapp/models.py)：

from app import db

ROLE_USER = 0
ROLE_ADMIN = 1

class User(db.Model):
    id = db.Column(db.Integer, primary_key = True)
    nickname = db.Column(db.String(64), index = True, unique = True)
    email = db.Column(db.String(120), index = True, unique = True)
    role = db.Column(db.SmallInteger, default = ROLE_USER)

    def __repr__(self):
        return '<User %r>' % (self.nickname)

User类把我们刚刚创建的几个字段定义为类变量。字段使用db.Column类创建实例，字段的类型作为参数，另外还提供一些其他可选参数。例如，标识字段唯一性和索引的参数.

__repr__方法告诉Python如何打印class对象，方便我们调试使用。