定义模型
模型表示程序使用的数据实体,在Flask-SQLAlchemy中,模型一般是Python类,继承自db.Model,db是SQLAlchemy类的实例,代表程序使用的数据库。
类中的属性对应数据库表中的列。id为主键,是由Flask-SQLAlchemy管理。db.Column类构造函数的第一个参数是数据库列和模型属性类型。
注:如果没有在创建数据库的时候指定编码的话,向数据库中插入中文后,会报错,那么需要修改数据库的编码集:
alter database 数据库名 CHARACTER SET utf8
如下示例:定义了两个模型类,作者和书名。
#coding=utf-8
from flask import Flask,render_template,redirect,url_for
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
#设置连接数据
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:mysql@127.0.0.1:3306/test2'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True
#实例化SQLAlchemy对象
db = SQLAlchemy(app)
class Author(db.Model):
"""作者模型类:一,一个作者可以有多本书"""
__tablename__ = 'authors'
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(64), unique=True)
books = db.relationship('Book', backref='author', lazy='dynamic')
class Book(db.Model):
"""作者模型类:一,一个作者可以有多本书"""
__tablename__ = 'books'
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(64), unique=True)
# 外键
author_id = db.Column(db.Integer, db.ForeignKey(Author.id))
创建表
if __name__ == '__main__':
db.drop_all()
db.create_all()
app.run(debug=True)
查看创建结果
show tables;
查看表结构
desc author;
desc books;
添加测试数据
# 准备测试数据
au1 = Author(name='老王')
au2 = Author(name='老尹')
au3 = Author(name='老刘')
# 把数据提交给用户会话
db.session.add_all([au1, au2, au3])
# 提交会话
db.session.commit()
bk1 = Book(name='老王回忆录', author_id=au1.id)
bk2 = Book(name='我读书少,你别骗我', author_id=au1.id)
bk3 = Book(name='如何才能让自己更骚', author_id=au2.id)
bk4 = Book(name='怎样征服美丽少女', author_id=au3.id)
bk5 = Book(name='如何征服英俊少男', author_id=au3.id)
# 把数据提交给用户会话
db.session.add_all([bk1, bk2, bk3, bk4, bk5])
# 提交会话
db.session.commit()
生成数据后,查看数据
select * from authors;
select * from books;
数据显示&表单添加
数据显示
定义路由函数,并将 Author 和 Book 的所有结果传到模板
@app.route('/',methods=['GET','POST'])
def index():
author = Author.query.all()
book = Book.query.all()
return render_template('index.html',author=author,book=book)
模版关键代码
<ul>
{% for x in author %}
<li>{{ x }}</li>
{% endfor %}
</ul>
<hr>
<ul>
{% for x in book %}
<li>{{ x }}</li>
{% endfor %}
</ul>
表单添加
定义表单类
from flask_wtf import FlaskForm
from wtforms.validators import DataRequired
from wtforms import StringField,SubmitField
#创建表单类,用来添加信息
class Append(FlaskForm):
au_info = StringField(validators=[DataRequired()])
bk_info = StringField(validators=[DataRequired()])
submit = SubmitField(u'添加')
传至模板中
#创建表单对象
@app.route('/',methods=['GET','POST'])
def index():
author = Author.query.all()
book = Book.query.all()
form = Append()
return render_template('index.html',author=author,book=book,form=form)
模板中的代码
<form method="post">
{{ form.csrf_token }}
<p>作者:{{ form.au_info }}</p>
<p>书名:{{ form.bk_info }}</p>
<p>{{ form.submit }}</p>
</form>
表单验证
@app.route('/', methods=['get', 'post'])
def index():
append_form = Append()
if request.method == 'POST':
if append_form.validate_on_submit():
author_name = append_form.au_info.data
book_name = append_form.bk_info.data
# 判断数据是否存在
author = Author.query.filter_by(name=author_name).first()
if not author:
try:
# 先添加作者
author = Author(name=author_name)
db.session.add(author)
db.session.commit()
# 再添加书籍
book = Book(name=book_name, author_id=author.id)
db.session.add(book)
db.session.commit()
except Exception as e:
db.session.rollback()
print e
flash("数据添加错误")
else:
book_names = [book.name for book in author.books]
if book_name in book_names:
flash('该作者已存在相同的书名')
else:
try:
book = Book(name=book_name, author_id=author.id)
db.session.add(book)
db.session.commit()
except Exception as e:
db.session.rollback()
print e
flash('数据添加错误')
else:
flash('数据输入有问题')
authors = Author.query.all()
books = Book.query.all()
return render_template('test2.html', authors=authors, books=books, append_form=append_form)
重新编写html文件展示列表书籍
<h2>书籍列表</h2>
<ul>
{% for author in authors %}
<li>
{{ author.name }}
<ul>
{% for book in author.books %}
<li>{{ book.name }}
{% else %}
<li>无书籍</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
在form标签下添加 flash 消息的显示
{% for message in get_flashed_messages() %}
{{ message }}
{% endfor %}
删除数据
定义删除author和book的路由
# 删除作者
@app.route('/delete_author/<int:author_id>')
def delete_author(author_id):
author = Author.query.get(author_id)
if not author:
flash('数据不存在')
else:
try:
Book.query.filter_by(author_id=author_id).delete()
db.session.delete(author)
db.session.commit()
except Exception as e:
db.session.rollback()
print e
flash('操作数据库失败')
return redirect(url_for('index'))
# 删除书籍
@app.route('/delete_book/<int:book_id>')
def delete_book(book_id):
book = Book.query.get(book_id)
if not book:
flash('数据不存在')
else:
try:
db.session.delete(book)
db.session.commit()
except Exception as e:
db.session.rollback()
print e
flash('操作数据库失败')
return redirect(url_for('index'))
在模版中添加删除的 a 标签链接
<h2>书籍列表</h2>
<ul>
{% for author in authors %}
<li>
{{ author.name }} <a href="/delete_author/{{ author.id }}">删除</a>
<ul>
{% for book in author.books %}
<li>{{ book.name }} <a href="/delete_book/{{ book.id }}">删除</a></li>
{% else %}
<li>无书籍</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
数据库迁移
在开发过程中,需要修改数据库模型,而且还要在修改之后更新数据库。最直接的方式就是删除旧表,但这样会丢失数据。
更好的解决办法是使用数据库迁移框架,它可以追踪数据库模式的变化,然后把变动应用到数据库中。
在Flask中可以使用Flask-Migrate扩展,来实现数据迁移。并且集成到Flask-Script中,所有操作通过命令就能完成。
为了导出数据库迁移命令,Flask-Migrate提供了一个MigrateCommand类,可以附加到flask-script的manager对象上。
首先要在虚拟环境中安装Flask-Migrate。
pip install flask-migrate
创建迁移仓库
#这个命令会创建migrations文件夹,所有迁移文件都放在里面。
python database.py db init
创建迁移脚本
自动创建迁移脚本有两个函数
upgrade():函数把迁移中的改动应用到数据库中。
downgrade():函数则将改动删除。
自动创建的迁移脚本会根据模型定义和数据库当前状态的差异,生成upgrade()和downgrade()函数的内容。
对比不一定完全正确,有可能会遗漏一些细节,需要进行检查
python database.py db migrate -m 'initial migration'
更新数据库
python database.py db upgrade
返回以前的版本
可以根据history命令找到版本号,然后传给downgrade命令:
python app.py db history
输出格式:<base> -> 版本号 (head), initial migration
回滚到指定版本
python app.py db downgrade 版本号
实际操作顺序:
1.python 文件 db init
2.python 文件 db migrate -m"版本名(注释)"
3.python 文件 db upgrade 然后观察表结构
4.根据需求修改模型
5.python 文件 db migrate -m"新版本名(注释)"
6.python 文件 db upgrade 然后观察表结构
7.若返回版本,则利用 python 文件 db history查看版本号
8.python 文件 db downgrade(upgrade) 版本号