6、在 Flask 中使用模型、SQLAlchemy 和超链接 API

在 Flask 中使用模型、SQLAlchemy 和超链接 API

1. 背景与目标

在开发 API 时，我们需要处理通知类别和通知的存储、管理等操作。为了简化数据的序列化、反序列化、验证等任务，我们将利用与 Flask RESTful 和 SQLAlchemy 相关的多个包。同时，我们的 RESTful API 需要支持多种 HTTP 方法，使用 SQLAlchemy 作为 ORM，并可以选择 PostgreSQL、MySQL 或 SQLite 等数据库。

2. HTTP 方法与语义

以下表格展示了新 API 必须支持的 HTTP 动词、作用域和语义：
| HTTP 动词 | 作用域 | 语义 |
| — | — | — |
| GET | 通知类别集合 | 检索集合中所有存储的通知类别，按名称升序排序。每个通知类别必须包含资源的完整 URL，以及属于该类别的所有通知的详细信息列表，通知无需包含通知类别以避免数据重复。 |
| GET | 通知类别 | 检索单个通知类别，包含与检索通知类别集合时每个类别相同的信息。 |
| POST | 通知类别集合 | 在集合中创建新的通知类别。 |
| PATCH | 通知类别 | 更新现有通知类别的名称。 |
| DELETE | 通知类别 | 删除现有通知类别。 |
| GET | 通知集合 | 检索集合中所有存储的通知，按消息升序排序。每个通知必须包含其通知类别详细信息，包括访问相关资源的完整 URL，通知类别详细信息无需包含属于该类别的通知，通知必须包含访问资源的完整 URL。 |
| GET | 通知 | 检索单个通知，包含与检索通知集合