前言
本页介绍了构建一个稍微复杂的 Flask-RESTPlus 应用程序,该应用程序将涵盖在设置实际基于 Flask-RESTPlus 的 API 时的一些最佳实践。
多个namespaces 命名空间
组织 Flask-RESTPlus 应用程序有很多不同的方法,但在这里我们将描述一种可以很好地扩展大型应用程序并保持良好级别组织的方法。
Flask-RESTPlus 提供了一种使用与 Flask 的蓝图几乎相同的模式的方法。主要思想是将您的应用程序拆分为可重用的命名空间。
这是一个示例目录结构:
project/
├── app.py
├── core
│ ├── __init__.py
│ ├── utils.py
│ └── ...
└── apis
├── __init__.py
├── namespace1.py
├── namespace2.py
├── ...
└── namespaceX.py
app 模块将作为遵循经典 Flask 模式之一的主应用程序入口点.
core 模块是一个例子,它包含业务逻辑。实际上,您可以随意调用它,并且可以有很多包。
apis包将是您需要在应用程序上导入和注册的主要 API 入口点,而命名空间模块是可重用的命名空间,其设计类似于 Flask 的蓝图。
namespace 命名空间模块包含