【转自 Felipe Silveira 的《Build a Flask CRUD Application with MVC Architecture》(翻译)】
如何用 Flask 的 Blueprint 实现一个 CRUD 的应用
我多年来一直在开发和生产应用程序中使用 Node.js,最近我开始专注于使用 Flask 的全栈 Web 开发。
我记得我的第一个实践 Node.js 项目,现在与 Flask 相比,它的开发速度要快得多。碰巧的是,在使用 Flask 时,我在实现一个简单的 CRUD 应用程序时被卡住了很多次,主要是在如何使用 Python 构建项目方面。
特别是,我已经使用 Python 实现了许多机器学习应用程序。在我看来,它是最好的语言。但是,在实现 CRUD 和/或 API 项目时,我仍然更喜欢 Node.js。
总的来说,请注意本教程的重点不是解释什么是 CRUD 应用程序,也不是它的方法。它只是关于如何按照 MVC 架构实现应用程序的指南。
我试图尽可能地将它与 NodeJS 应用程序相关联,希望你喜欢它。如有任何意见或建议,请随时与我联系。
为了构建这个应用程序,我们首先需要了解 CLIENT/SERVER 的基本思想。
在这种方法中,服务器响应返回客户端请求的整个页面。例如,请求页面会为此/users返回所有 HTML、CSS 和 JS。对它的实际理解是render_template来自烧瓶的方法。
请记住,此格式仅限于特定客户端。由于服务器呈现 HTML、CSS 和 JS,因此 Android 或 iOS 客户端无法处理它。作为一种解决方案,经常使用 RESTful API,从而消除了呈现模板的后端责任。
项目结构
本教程假设您已经在计算机上安装了 Python、PostgreSQL 和 Flask。之后,请在您的项目文件夹中创建以下结构。
project/|├── templates/| └── index.html|├── migrations/ **| └── ...|├── routes/| └── user_bp.py|├── models/| └── User.py|├── controllers/| └── UserController.py|├── app.py└── config.py
复制代码
如果你从另一个框架,你可能已经注意到了瓶 CLI 是用来设置的东西,如FLASK_APP=app.py和FLASK_ENV=development,但不会自动为我们创建这个结构。
现在,让我们开始编写代码。
在 src/app.py 中
from flask import Flask, render_templatefrom flask_migrate import Migrate
from models.User import dbfrom routes.user_bp import user_bp
app = Flask(__name__)app.config.from_object('config')
db.init_app(app)migrate = Migrate(app, db)app.register_blueprint(user_bp, url_prefix='/users')
@app.route('/')def index(): return render_template('index.html')
if __name__ == '__main__': app.debug = True app.run()
复制代码
在 src/config.py 中:
import os
SECRET_KEY = os.urandom(32)
# Grabs the folder where the script runs.basedir = os.path.abspath(os.path.dirname(__file__))
# Enable debug mode.DEBUG = True
# Connect to the databaseSQLALCHEMY_DATABASE_URI = 'your psycopg2 URI connection'
# Turn off the Flask-SQLAlchemy event system and warningSQLALCHEMY_TRACK_MODIFICATIONS = False
复制代码
在 src/models/User.py 中:
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
class User(db.Model): __tablename__ = 'users'
id = db.Column(db.Integer, primary_key=True) name = db.Column(db.String) age = db.Column(db.String(120)) address = db.Column(db.String(120))
@property def serialize(self): return { 'id': self.id, 'name': self.name, 'city': self.city, 'state': self.state, 'address': self.address }
复制代码
之后,您可以运行以下命令:
flask db init: 它将创建带有版本子文件夹的迁移文件夹。
flask db migrate: 它将通过升级和降级逻辑设置检测模型更改。
flask db upgrade: 它将应用您已实施的模型更改。
flask db downgrade: 如果出现问题,您可以使用此命令取消应用您对模型文件所做的更改。
路线:
如您所见,路由通常使用控制器功能编写
@app.route('/', methods =['GET']) def index(): ...
@app.route('/create', methods =['POST']) def store(): ...
...
复制代码
但是,由于我们希望按照 MVC 架构来组织它,因此需要进行一些更改。为此,Blueprint可以用作解决方案。它负责将代码拆分为不同的模块,从而更好地维护并提高可扩展性。
在 src/routes/user_bp.py 中:
from flask import Blueprint
from controllers.UserController import index, store, show, update, destroy
user_bp = Blueprint('user_bp', __name__)
user_bp.route('/', methods=['GET'])(index)user_bp.route('/create', methods=['POST'])(store)user_bp.route('/<int:user_id>', methods=['GET'])(show)user_bp.route('/<int:user_id>/edit', methods=['POST'])(update)user_bp.route('/<int:user_id>', methods=['DELETE'])(destroy)
复制代码
回到app.py,你可能注意到在app.register_blueprint(user_bp, url_prefix='/users')中蓝图正被注册
在 src/controllers/UserController.py 中
# pseudo code
import sysfrom flask import render_template, redirect, url_for, request, abort
from models.User import Userfrom flask_sqlalchemy import SQLAlchemydb = SQLAlchemy()
def index(): ...
def store(): ...
def show(userId): ...
def update(userId): ...
def delete(userId): ...
复制代码
编写完所有必要的方法后,您可以使用命令flask run或运行项目python app.py。最后,您可以检查您的项目是否在 http://localhost:5000/正确运行
本教程侧重于指导您进行后端实现,如果您想了解前端部分的详细信息,请为第二个教程发表评论。
我希望我已经向您展示了使用 Flask 实现 CRUD 应用程序是多么容易,就像使用 Node.js 一样。谢谢阅读!
评论