[python][flask][flask-SQLAlchemy]关于flask-SQLAlchemy的初级使用教程

鉴于网上关于flask-SQLAlchemy的实例使用教程良莠不齐，于此写下工做学习过程当中的使用过程，以便分享交流。

对于python关于flask有必定了解的高端玩家来讲，请转至flask官方开发文档。

 

一.安装(install)

须要有安装python的PC一台，介于windows系统用户比较多，本文章使用的是windows下开发。

1.建立虚拟

为每个工程建立一个独立的python运行环境是咱们所须要的，python提供了virtualenv，能够为咱们提供这个特殊的需求。

配置virtualenv环境

windows环境下运行cmd.exe，使用管理员权限运行。

 pip install virtualenv

笔者使用的python版本是3.5.2，该版本中自动配置了pip应用，使用pip指令能够很方便的下载到你所须要的python拓展库。  

安装成功后会出现successfully installed virtualenv字样。

PS：若是pip指令没法使用，请确认python环境下scripts是否包含在系统环境变量中的Path中。

      

使用控制台进入你须要配置该虚拟环境的目录，使用mkdir建立工程的文件夹，笔者建立的工程名为sqlalchemy_demo

  mkdir sqlalchemy_demo

建立虚拟Python运行环境

 virtualenv flask

出现以下字样，说明虚拟环境建立成功

 

进入工程文件夹，激活虚拟python运行环境

 flask\scripts\activate

出现以下字样显示，说明进入虚拟python运行环境成功

 

 

2.安装所须要的库文件

咱们须要两个库文件，一个是flask，另外一个是flask-SQLAlchemy。使用pip指令安装

 pip install flask
 pip install flask-sqlalchemy

看到以下字样说明两个库文件安装成功

至此，环境配置阶段结束。

 

二.flask-SQLAlchemy简介

flask-SQLAlchemy 是一个为您的flask应用增长SQLAlchemy支持的扩展。

在python扩展库中其实包含了SQLAlchemy。在版本的不断叠加后，已经被整合到flask架构中，flask-SQLAlchemy简化在Flask中SQLAlchemy的使用，提供了有用的默认值和额外的助手来更简单地完成常见任务。

笔者认为SQLAlchemy比较精髓的是使用ORM(对象关系映射),相对于传统链接数据库使用select,update,insert,delete操做数据表来讲具备如下特色[1]：

　　简单——以最基本的形式建模数据

　　传达性——数据库结构被任何人都能理解的语言文档化

　　精确性——基于数据模型建立正确标准化的结构

完事无绝对，ORM有明显的优点，就会想伴随有缺点。

　　隐蔽性——相对于传统使用select,update,insert,delete来讲，隐藏了操做数据表的具体操做，不利于SQL的学习

　　数据表结构修改难——在设计中有时会忽略了一些字段的定义，在ORM模式中只能更新映射表更新字段，并且效果远不如alter table [表名] add 字段名更新字段来的容易理解，经常会忽略一些细节

 

但不得不说，ORM模式的确打开了新世界的大门，大大减小了学习及使用数据库的过程与难度。

三.在实例中应用

1.文件结构

sqlalchemy_demo--->flask

　　　　　　　　　--->database.py

　　　　　　　　　--->model.py

　　　　　　　　　--->test.py

2.建立SQLAlchemy配置文件

database.py代码以下所示

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import os
basedir = os.path.abspath(os.path.dirname(__file__))

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir, 'test.db')
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app）

def db_init():
    db.create_all()

一句一句解释

（1）from flask import Flask

Flask类是flask框架的核心类，它实现了WSGI应用规范。

（2）from flask_sqlalchemy import SQLAlchemy

将flask-sqlchemy中内置的SQLAlchemy引用到该文件下。

（3）import OS

本实例中须要将数据库建立在工程的更目录下，使用python内置os库能够很方便的定位到工程路径下。

（4）basedir = os.path.abspath(os.path.dirname(__file__))

将当前文件传入dirname函数中，获取当前文件所在路径，abspath函数获取该文件所在的绝对路径，以便在后边配置建立数据库的路径使用。

（5）app = Flask(__name__) [2]

Flask构造函数的第一个参数指定一个引入参数/importname。

Flask框架使用这个名字进行静态资源、模板、错误信息的定位。除非你清楚的理解它的做用，一般状况下，咱们总应该使用特殊变量__name__。

Flask实例是可调用的（具备call方法），这个实例能够直接对接 WSGI服务器。

（6）app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(basedir, 'test.db')

       app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

SQLALCHEMY_DATABASE_URI:用于链接数据库

　　eg：sqlite:////tmp/test/db

　　　　mysql://username:password@server/db

SQLALCHEMY_TRACK_MODIFICATIONS:

若是设置成True(默认状况)，Flask-SQLAlchemy 将会追踪对象的修改而且发送信号。这须要额外的内存， 若是没必要要的能够禁用它。若是你不显示的调用它，在最新版的运行环境下，会显示警告。

（7）db = SQLAlchemy(app)

SQLAlchemy函数，将刚刚建立的Flask框架，与工程所须要使用的数据库绑定到一块儿，以便实现工程与数据库链接，实现数据操做。

（8）db_init()函数

手动建立函数，以便初始化数据库

 

以上就是配置database.py的一些说明，但如今还远远不够，由于当前工程的数据库在建立以后只是单纯的一个空数据库，不包含任何数据表。

那怎么建立数据表呢，工程下须要一个映射表，以便将表格映射到数据库中，以达到建立表格的做用。

3.建立映射表

以下为一段建立最简单的User数据表的代码。

from database import db

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True)
    email = db.Column(db.String(120), unique=True)
    
    def __init__(self, username, email):
        self.username = username
        self.email = email
        
    def __repr__(self):
        return '<User %r>' % self.usernam

仍然是逐句解释

（1）from database import db

将刚刚建立的SQLAlchemy应用引用到当前文件，以便将映射表映射到数据库中，以便对于数据表的建立修改以及更新删除。

（2）db.Model

上边提到，当工程文件不提供映射表时将建立一个空的数据库文件。继承db.Model类，将咱们当前建立的映射表和数据库db绑定在一块儿。此时工程文件调用create_all函数后，会自动将绑定后的映射表文件建立在数据库文件中。

若是想探究详细绑定关系，请应用纯SQlAlchemy库，而不是flask-sqlalchemy库，以前调到了flask-sqlalchemy是简化版的SQLAlchemy，隐藏了许多细节，深刻研究请转至SQLAlchemy官方文档查看应用细节。

（3）db.Column

建立映射表字段，如下为最多见的类型

Integer	存储整数
String(size)	存储有长度的字符串
Text	存储较长的unicode文本
DateTime	存储时间类型数据
Float	存储浮点值
Boolean	存储布尔值
PickleType	存储一个python对象
LargeBinary	存储一个任意大的二进制数据

 

 

 

 

 

 

primary_key=True设置当前字段为主键

uniqu=True设置当前字段不可重复

固然也能够设置主键外键，在本文中只建立了一张数据表，在之后的文章中将说明此操做。

（4）__init__函数

为映射表的构造函数，通常用来初始变量，配置相关数据时使用

（5）__repr__函数

为之后调试输出提供接口

4.修改database.py

将下面的代码添加到database.py的底部

from model import User

Q：为何添加到底部呢？

A：若是你添加到头部引用model中的User，此时User类已经被引用并建立。有没有发现一个问题，User类继承了db.Model类，那么此时User类建立的时候没法找到db这个参数，由于db参数尚未建立。

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import os
from model import User

上边的就是错误的例子，当你引用User类时，此时db对象尚未被建立，因此调用db_init()函数时会显示ImportError: cannot import name 'User'

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import os
...
db = SQLAlchemy(app)
...
from model import User

上边的伪代码就是正确的写法，引用User类的时机至少要等到db对象建立结束后才能引用。为何放在底部呢？为了调整文件结构，使代码看起来不是很乱，放在其余处也不要紧，但请注意如下两点：

（1）若是你打算在该文件引用User类，请保证全局引用。

（2）不管发在哪里，至少要在db = SQLAlchemy(app)执行后，生成db对象才能进行引用，不然会致使model.py文件执行错误。

至此，映射表文件建立成功。

 

4.建立数据库

将以上配置结束后，能够调用db_init()函数建立数据库了。

还记得以前配置的虚拟python运行环境么，在虚拟环境下输入python，进入python指令模式进行建立

此时，工程文件夹根目录已经生成了内置的sqlite数据库文件test.db

四.SQLAlchemy下的数据库操做

1.insert

添加4个用户，将database.py中的User和db引用到文件中，此处必须引用database中的User，若是引用model中的User会形成循环引用，由于model.py中引用了database模块中的db变量

from database from User，db

u1 = User(username= 'john', email = 'john@example.com')
u2 = User(username= 'susan', email = 'susan@example.com')
u3 = User(username= 'mary', email = 'mary@example.com')
u4 = User(username= 'david', email = 'david@example.com')
db.session.add(u1)
db.session.add(u2)
db.session.add(u3)
db.session.add(u4)
db.session.commit()

（1）对象 = User(字段1='值1',字段2='值2')

至关于SQL操做INSERT INTO User VALUES(字段1='值1',字段2='值2')，并将该SQL语句赋值到一个对象上

（2）db.session.add()

将对于数据库的操做保存在缓存中，既然是保存到缓存中，那么该数据库语句尚未提交到数据库中

（3）db.session.commit()

commit()和数据库中的commit指令同样，将数据库操做提交到数据库中。

2.select

查询全部用户信息，并输出结果

from database import User, db

for user in User.query.all():
    print(user.id, user.name, user.email)

如下是运行产生的结果

(1)精确查询

查询用户名为susan的用户邮箱

from database import User， db

u = User.query.filter_by(username='susan').first()
print(u.email)

(2)模糊查询

查询邮箱以example.com结尾的用户，输出用户名及邮箱

from database import User, db

for user in  User.query.filter(User.email.ilike('%example.com')).all():
    print(user.username, user.email)

如下是运行产生的结果

PS：将查询出的结果按照正序或者逆序排序请使用，以username为例order_by(User.username)正序，order_by(User.username.desc())逆序

3.update

更新操做和查询操做有交集，请看如下代码示例，将john的邮箱修改成john@example.vip.com

from database import User, db

u = User.query.filter_by(username='john').first()
u.email = 'john@example.vip.com'
db.session.add(u)
db.session.commit()

解释起来就是首先将对象查询出来，而后将修改的字段赋值，并将查询出的对象提交到数据库，这样更新操做就结束了。

4.delete

将david用户删除

from database import User, db

u = User.query.filter_by(username='john').first()
db.session.delete(u)
db.session.commit()

调用delete()函数，将数据传入db对象，并提交到数据库中。

五.单体测试框架测试

对本文提到的操做进行单体测试。（test.py文件代码以下）

import unittest
from database import User, db

class TestCase(unittest.TestCase):
    def setUp(self):
        pass

    def tearDown(self):
        pass

    def test_db(self):
        u1 = User.query.filter_by(username='john').first()
        u2 = User.query.filter_by(username='susan').first()
        u3 = User.query.filter_by(username='mary').first()
        u4 = User.query.filter_by(username='david').first()

        assert u1.email == 'john@example.vip.com'
        assert u2.email == 'susan@example.com'
        assert u3.email == 'mary@example.com'
        assert u4.email == 'david@example.com'

        u5 = User(username='Alima', email='Alima@example.com')
        db.session.add(u5)
        db.session.commit()

        u = User.query.filter_by(username='Alima').first()
        assert u.email == 'Alima@example.com'

        u5.email = 'Alima@example.vip.com'
        db.session.add(u5)
        db.session.commit()

        u = User.query.filter_by(username='Alima').first()
        assert u.email == 'Alima@example.vip.com'

        db.session.delete(u5)
        db.session.commit()

        u = User.query.filter_by(username='Alima').first()
        assert u == None

if __name__ == '__main__':
    unittest.main()

执行test.py，运行结果：

显示OK，单体测试结束。

 

以上就是基本的flask-SQLAlchemy初级使用实例说明，欢迎探讨转载及引用参考，大家的回应是个人动力。

若是文中存在错误或是某个地方说的不够精确，劳烦批评指出。

以上，辛苦了。

 

参考资料：
[1] [sogou][搜狗百科][ORM] http://baike.sogou.com/v75834.htm?fromTitle=ORM
[2] [csdn][seanb][Flask中路由使用解析] http://blog.csdn.net/seanb/article/details/51454833
[3] [flask][flask-sqlalchemy][官方文档] http://flask-sqlalchemy.pocoo.org/2.1/

 

*本文为Alima原创，若是转载请联系笔者，转载注明格式[转载][博客园][Alima][关于flask-SQLAlchemy的初级使用教程]，并在文尾注明本文连接，多谢合做。

*非法转载及非法抄袭博文将依照网络著做权流程办理，请尊重做者劳动成果