Flask - 概述

Flask - SQLAlchemy

在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')就像这样 :

<!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 方式发布到同一网址.

new.html

<!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 = "email">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/.

Flask SQLAlchemy Example