【Flask】四、flask连接并操作数据库

前言

    在Flask框架中，数据库的操作是一个核心功能，它允许开发者与后端数据库进行交互，执行数据的增删改查操作。本文将详细介绍如何在Flask中连接并操作数据库，包括使用Flask-SQLAlchemy扩展和直接使用MySQL的Python驱动。
    常见的有三种操作方法：使用 SQLAlchemy、使用 Flask-SQLAlchemy 连接 MySQL和直接使用 MySQL 的 Python 驱动，本篇先讲述如何使用SQLAlchemy进行连接，后续会对其他方式进行讲解。

一、 安装必要的库

首先，安装Flask-SQLAlchemy和MySQL的Python驱动。可以通过以下命令安装：

pip install -U SQLAlchemy
pip install pymysql  # Python3 使用pymysql
pip install mysqlclient

二、配置数据库连接

在Flask应用中，需要配置数据库的地址（一般情况下，不建议直接在项目头部配置，此处只为演示，建议写在config.py中进行变量配置），这里的username等信息需要换成实际信息：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://username:password@localhost/dbname'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)

三、定义模型

在Flask-SQLAlchemy中，模型是数据库表的Python类，每个模型类代表数据库中的一张表。例如：

class User(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)
    def __repr__(self):
        return f'<User {self.username}>'

这里定义了一个用户模型，对应数据库中的用户信息表，属性包括：id、用户名和email，对应的mysql表如下：

CREATE TABLE `users` (
  `id` INT NOT NULL AUTO_INCREMENT,
  `username` VARCHAR(80) NOT NULL,
  `email` VARCHAR(120) NOT NULL,
  PRIMARY KEY (`id`),
  UNIQUE INDEX `username_unique` (`username` ASC),
  UNIQUE INDEX `email_unique` (`email` ASC)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

四、操作数据库

    配置好以上内容后，我们就可以通过SQLAlchemy 提供的 ORM 功能操作数据库了，我们简单的用CURD操作进行测试 ~

1.添加用户

# 添加用户路由
@app.route('/add_user', methods=['POST'])
def add_user():
    data = request.get_json()
    username = data.get('username')
    email = data.get('email')
    if not username or not email:
        return '缺少用户名或邮箱地址', 400
    # 检查 email 是否已存在
    existing_user = User.query.filter_by(email=email).first()
    if existing_user:
        return '邮箱已存在，无法添加用户', 400
    new_user = User(username=username, email=email)
    db.session.add(new_user)
    try:
        db.session.commit()
    except IntegrityError:
        db.session.rollback()
        return '插入失败，可能是用户名或邮箱重复', 400
    except Exception as e:
        db.session.rollback()
        return f'数据库错误: {str(e)}', 500
    return '用户添加成功'

2.删除用户

# 删除用户路由
@app.route('/delete_user/<int:user_id>', methods=['DELETE'])
def delete_user(user_id):
    user = User.query.get(user_id)
    if not user:
        return '用户不存在', 404
    db.session.delete(user)
    db.session.commit()
    return '用户删除成功'

3.更新用户信息

# 更新用户路由
@app.route('/update_user/<int:user_id>', methods=['PUT'])
def update_user(user_id):
    user = User.query.get(user_id)
    if not user:
        return '用户不存在', 404
    data = request.get_json()
    new_username = data.get('username')
    new_email = data.get('email')
    # 更新用户名和邮箱
    if new_username:
        user.username = new_username
    if new_email:
        existing_user = User.query.filter_by(email=new_email).first()
        if existing_user and existing_user.id != user_id:
            return '邮箱已存在，无法更新用户信息', 400
        user.email = new_email
    try:
        db.session.commit()
    except IntegrityError:
        db.session.rollback()
        return '更新失败，可能是用户名或邮箱重复', 400
    except Exception as e:
        db.session.rollback()
        return f'数据库错误: {str(e)}', 500
    return '用户更新成功'

4查询所有用户

# 获取所有用户路由
@app.route('/get_all', methods=['GET'])
def get_users():
    users = User.query.all()
    return '<br>'.join([f'{user.username} ({user.email})' for user in users])

五、测试结果

此时查询发生变化

    至此，我们完成了使用flask连接并操作数据库，其实使用python开发后端项目非常的轻松，相比结构缜密的springboot，偶尔使用flask写一些小项目也是不错的选择哦。