在Flask Web应用程序中使用原始SQL在数据库上执行CRUD操作可能很繁琐.相反, SQLAlchemy ,Python工具包是一个功能强大的 OR Mapper ,它为应用程序开发人员提供了SQL的全部功能和灵活性. Flask-SQLAlchemy是Flask扩展,它将对SQLAlchemy的支持添加到Flask应用程序中.
什么是ORM(对象关系映射)?
大多数编程语言平台都是面向对象的.另一方面,RDBMS服务器中的数据存储为表格.对象关系映射是一种将对象参数映射到底层RDBMS表结构的技术. ORM API提供了执行CRUD操作的方法,而无需编写原始SQL语句.
在本节中,我们将研究Flask-SQLAlchemy的ORM技术并构建一个小型Web应用程序.
第1步 : 安装Flask-SQLAlchemy扩展.
pip install flask-sqlalchemy
第2步 : 您需要从此模块导入SQLAlchemy类.
from flask_sqlalchemy import SQLAlchemy
第3步 : 现在创建一个Flask应用程序对象并为要使用的数据库设置URI.
app = Flask(__name__)app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///students.sqlite3'
第4步 : 然后使用应用程序对象作为参数创建SQLAlchemy类的对象.该对象包含ORM操作的辅助函数.它还提供了一个父Model Model类,用于声明用户定义的模型.在下面的代码段中,创建了学生模型.
db = SQLAlchemy(app)class students(db.Model): id = db.Column('student_id', db.Integer, primary_key = True) name = db.Column(db.String(100)) city = db.Column(db.String(50)) addr = db.Column(db.String(200)) pin = db.Column(db.String(10))def __init__(self, name, city, addr,pin): self.name = name self.city = city self.addr = addr self.pin = pin
第5步 : 要创建/使用URI中提到的数据库,请运行 create_all()方法.
db.create_all()
SQLAlchemy 的 Session 对象管理 ORM 对象的所有持久化操作.
以下会话方法执行CRUD操作 :
db.session.add (模型对象) : 将记录插入到映射表中
db.session.delete (模型对象) : 删除表中的记录
model.query.all() : 检索表中的所有记录(对应于SELECT查询).
您可以使用filter属性对检索到的记录集应用过滤器.例如,为了在学生表中检索 city ='Hyderabad'的记录,请使用以下语句 :
Students.query.filter_by(city ='Hyderabad').all()
有了这么多的背景,现在我们将为我们的应用程序提供视图函数添加学生数据.
应用程序的入口点是 show_all()函数绑定到'/' URL.记录集学生表作为参数发送到HTML模板.模板中的服务器端代码以HTML表格形式呈现记录.
@app.route('/')def show_all(): return render_template('show_all.html', students = students.query.all() )
HTML脚本template ('show_all.html')就像这样 :
Comments - Flask SQLAlchemy example
{%- for message in get_flashed_messages() %} {{ message }} {%- endfor %}Students (Add Student )
Name | City | Address | Pin |
---|---|---|---|
{{ student.name }} | {{ student.city }} | {{ student.addr }} | {{ student.pin }} |
上面的页面包含指向'/new' URL映射 new()功能的超链接.单击时,将打开"学生信息"表单.数据以 POST 方式发布到同一网址.
new.html
Students - Flask SQLAlchemy example
{%- for category, message in get_flashed_messages(with_categories = true) %}{{ message }}{%- endfor %}
当检测到http方法为POST时,表单数据将添加到学生表中,应用程序将返回显示添加数据的主页.
@app.route('/new', methods = ['GET', 'POST'])def new(): if request.method == 'POST': if not request.form['name'] or not request.form['city'] or not request.form['addr']: flash('Please enter all the fields', 'error') else: student = students(request.form['name'], request.form['city'], request.form['addr'], request.form['pin']) db.session.add(student) db.session.commit() flash('Record was successfully added') return redirect(url_for('show_all')) return render_template('new.html')
以下是完整的代码应用程序(app.py).
from flask import Flask, request, flash, url_for, redirect, render_templatefrom flask_sqlalchemy import SQLAlchemyapp = Flask(__name__)app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///students.sqlite3'app.config['SECRET_KEY'] = "random string"db = SQLAlchemy(app)class students(db.Model): id = db.Column('student_id', db.Integer, primary_key = True) name = db.Column(db.String(100)) city = db.Column(db.String(50)) addr = db.Column(db.String(200)) pin = db.Column(db.String(10))def __init__(self, name, city, addr,pin): self.name = name self.city = city self.addr = addr self.pin = pin@app.route('/')def show_all(): return render_template('show_all.html', students = students.query.all() )@app.route('/new', methods = ['GET', 'POST'])def new(): if request.method == 'POST': if not request.form['name'] or not request.form['city'] or not request.form['addr']: flash('Please enter all the fields', 'error') else: student = students(request.form['name'], request.form['city'], request.form['addr'], request.form['pin']) db.session.add(student) db.session.commit() flash('Record was successfully added') return redirect(url_for('show_all')) return render_template('new.html')if __name__ == '__main__': db.create_all() app.run(debug = True)
从Python shell运行脚本并在浏览器中输入 http://localhost:5000/.
点击'添加学生'链接以打开学生信息表单.
填写表格并提交.主页重新显示提交的数据.
我们可以看到输出如下所示.