作为一个java程序员,因为一些功能想用python方便些做一些接口,我对python除了基础语法其余的都不熟悉,也没有时间去从头学习,发现fastapi操作数据库的教程非常少,要么就是老版本,就是贴出的代码不完整,没有符合自己想要的技术站,在这里分享一下,结合ai和资料,跑通的一个demo
fastapi+SQLModel + SQLAlchemy2.x+mysql
mysql有原生的connection驱动,太老了,后得知大家都在用pymysql
SQLModel中封装了SQLAlchemy,但是他有两个版本,一个是1.4一个是2.x,本着用新不用旧,特别注意版本
工程结构解析
fastapi_project/ # 项目根目录 (英文小写,下划线分隔,Python命名规范)
├── app/ # 项目核心应用包 (所有业务代码都在这里,固定命名)
│ ├── __init__.py # 空文件,标记为Python包,必须有
│ ├── config/ # 【配置层】全局配置,Python标准命名,替代之前的core
│ │ ├── __init__.py
│ │ └── database.py # ✅ 核心:数据库引擎+会话依赖+SQLModel全自动建表工具+连接池配置
│ ├── models/ # 【模型层】Python标准命名,无任何争议
│ │ ├── __init__.py
│ │ └── user.py # ✅ 表模型+请求/响应模型,SQLModel核心,一个模型文件对应一张表
│ ├── crud/ # 【数据操作层】✅【Python原生核心层,重中之重】,替代Java的Mapper+Service
│ │ ├── __init__.py
│ │ └── user.py # ✅ 纯Python风格:业务逻辑+数据库CURD封装,二合一,这是Python的精髓!
│ └── api/ # 【接口路由层】✅【Python/FastAPI官方标准命名】,替代之前的routers
│ ├── __init__.py
│ └── v1/ # 接口版本控制,生产级必加,Python后端通用规范
│ ├── __init__.py
│ └── endpoints/ # 接口端点,存放所有接口
│ ├── __init__.py
│ └── user.py # 用户相关接口,纯路由分发,无任何业务逻辑
├── .env # 环境变量配置,敏感信息分离,Python标准
├── requirements.txt # 项目依赖清单,固定命名
└── main.py # 项目启动入口,固定命名,干净简洁
代码放在git上,本是自己的学习,还在摸索,以后采用fastapi的方式可能很多,我会不断完善
链接如下:https://gitee.com/ysjwork/fastapidemo
如果可以,请给我点点赞