Flask-SQLAlchemy是一个Flask扩展,它为应用程序提供了一个简单的方法来使用SQLAlchemy。它提供了一个配置参数,可以让你轻松地配置连接池。
# 连接池配置 app.config['SQLALCHEMY_POOL_SIZE'] = 5 # 默认 pool_size=5 app.config['SQLALCHEMY_MAX_OVERFLOW'] = 10 # 默认 max_overflow=10 app.config['SQLALCHEMY_POOL_TIMEOUT'] = 30 # 默认 pool_timeout=30
这三个参数分别表示连接池的大小、最大连接数和连接超时时间。pool_size表示连接池中保存的最大连接数,max_overflow表示当连接数超出pool_size时,允许创建的最大连接数,pool_timeout表示从连接池中取出一个连接后,如何长时间不使用该连接就会断开该连接。
正常情况下,当应用启动时,Flask-SQLAlchemy会根据上面三个参数创建一个固定大小的连接对象集合(即pool)。当应用需要使用数据库时,会从pool中取出一个已存在的对象或者新建一个对象来使用。当使用完成后,会释放该对象回到pool中。如此循环往复直到应用退出。
通常情况下,我们不必手动去配置上面三个参数,因为Flask-SQLAlchemy已经有了一套合理的默认值。但是在特定情况下我们也可以根据实际情况来修正上面三个参数来优化性能。
在Flask Web应用程序中使用原始SQL对数据库执行CRUD操作可能很繁琐。相反, SQLAlchemy ,Python工具包是一个强大的OR Mapper,它为应用程序开发人员提供了SQL的全部功能和灵活性。Flask-SQLAlchemy是Flask扩展,它将对SQLAlchemy的支持添加到Flask应用程序中。
什么是ORM(Object Relation Mapping,对象关系映射)?
大多数编程语言平台是面向对象的。另一方面,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类,使用它来声明用户定义的模型。
在下面的代码段中,创建了students 模型。
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对象的所有持久性操作。
以下session方法执行CRUD操作:
db.session.add (模型对象) - 将记录插入到映射表中
db.session.delete (模型对象) - 从表中删除记录
model.query.all() - 从表中检索所有记录(对应于SELECT查询)。
您可以通过使用filter属性将过滤器应用于检索到的记录集。例如,要在学生表中检索city ="Hyderabad"的记录,请使用以下语句:
Students.query.filter_by(city = ’Hyderabad’).all()
有了这么多的背景,现在我们将为我们的应用程序提供视图函数来添加学生数据。
应用程序的入口点是绑定到"/" URL的show_all()函数。学生表的记录集作为参数发送到HTML模板。模板中的服务器端代码以HTML表格形式呈现记录。
@app.route("/")
def show_all():
return render_template("show_all.html", students = students.query.all() )
模板("show_all.html")的HTML脚本如下:
<!DOCTYPE html>
<html lang = "en">
<head></head>
<body>
<h3>
<a href = "{{ url_for("show_all") }}">Comments - Flask
SQLAlchemy example</a>
</h3>
<hr/>
{%- for message in get_flashed_messages() %}
{{ message }}
{%- endfor %}
<h3>Students (<a href = "{{ url_for("new") }}">Add Student
</a>)</h3>
<table>
<thead>
<tr>
<th>Name</th>
<th>City</th>
<th>Address</th>
<th>Pin</th>
</tr>
</thead>
<tbody>
{% for student in students %}
<tr>
<td>{{ student.name }}</td>
<td>{{ student.city }}</td>
<td>{{ student.addr }}</td>
<td>{{ student.pin }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</body>
</html>
上述网页包含指向"/new" URL映射new()函数的超链接。单击时,将打开“学生信息”表单。 数据在 POST方法中发布到相同的URL。
<!DOCTYPE html>
<html>
<body>
<h3>Students - Flask SQLAlchemy example</h3>
<hr/>
{%- for category, message in get_flashed_messages(with_categories = true) %}
<div class = "alert alert-danger">
{{ message }}
</div>
{%- endfor %}
<form action = "{{ request.path }}" method = "post">
<label for = "name">Name</label><br>
<input type = "text" name = "name" placeholder = "Name" /><br>
<label for = "city">City</label><br>
<input type = "text" name = "city" placeholder = "city" /><br>
<label for = "addr">addr</label><br>
<textarea name = "addr" placeholder = "addr"></textarea><br>
<label for = "pin">City</label><br>
<input type = "text" name = "pin" placeholder = "pin" /><br>
<input type = "submit" value = "Submit" />
</form>
</body>
</html>
当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_template
from flask_sqlalchemy import SQLAlchemy
app = 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/。
点击“添加学生”链接以打开学生信息表单。
填写表单并提交。主页将重新显示提交的数据。
我们可以看到输出如下所示。
SWING - 环境安装本节将指导你如何在你的机器上下载和设置 Java。请按照以下步骤来设置环境。在链接 Download Java 上, Java SE ...
摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载,保留摘要,谢谢!“清醒时做事,糊涂时跑步,大怒时睡觉,独处时思...
摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载,保留摘要,谢谢!“怎样的人生才是没有遗憾的人生?我的体会是:(1...
缓存缓存是关于应用程序性能的优化,降低了应用程序对物理数据源访问的频次,从而提高应用程序的运行性能。缓存对 Hibernate 来...
ORM 概览什么是 JDBC?JDBC 代表 Java Database Connectivity ,它是提供了一组 Java API 来访问关系数据库的 Java 程序。这些 J...