一起学习 Python 的 Sanic 框架:路由和蓝图
引言
Sanic 支持路由装饰器将处理函数映射到 HTTP 请求。我们可以在“路由”装饰器中使用名为 methods
的可选参数来处理列表中的任何 HTTP 方法。蓝图是一个概念,用于将子路由从大型应用程序的子模块插入 Sanic 应用程序。蓝图必须注册到 Sanic 应用程序对象中。使用蓝图还可以避免在整个应用程序中传递 Sanic 应用程序对象。
一般来说,蓝图包括 MVC 框架中的 view.py
和 model.py
。但为什么叫蓝图呢?每个子目录将包含远远超过一个蓝图对象。关键是要强化这样一个概念,即这个目录中的所有东西都是围绕这些离散的组件之一来解决的。
蓝图定义
根据官方文档,我们可以知道:
蓝图是应用中可以作为子路由的对象。蓝图定义了同样的添加路由的方式,您可以将一系列路由注册到蓝图上而不是直接注册到应用上,然后再以可插拔的方式将蓝图注册到到应用程序。
创建蓝图
在下面的程序中,我们能够将这些路由组合到一个单一的蓝图中。重要的是,这使我们能够将 URL 路径(/my_bp
)的共同部分拉到蓝图中,这使我们能够灵活地在未来做出改变。
无论你决定如何组织你的文件结构,你可能总是应该使用蓝图。它们使组织更容易,甚至可以嵌套。就个人而言,我只在最琐碎的网络应用中使用 @app.route
。对于任何真正的项目,我总是将路由附加到蓝图中。
注册蓝图
仅仅创建我们的蓝图是不够的。Python 没有办法知道它们的存在。我们需要导入我们的蓝图并将它们附加到我们的应用程序中。这可以通过一个简单的注册方法完成:app.blueprint()
整体演示
为了演示路由和蓝图的使用,新建一个 main.py
文件:
然后新建一个 controller.py
:
让我们运行 main.py
,访问 http://127.0.0.1:8080
,能看到如下结果:
并在访问 http://127.0.0.1:8080/my_bp
,能看到我们的蓝图结果显示 :
我们可以使用 Postman 客户端来展示我们的 POST 请求:
回到服务器也能看到如下的后台信息:
总结
最先在 Flask 框架中了解到蓝图的概念,但是在 Sanic 中,组织所谓组件的标准方法也是蓝图。因此,每个子目录将有一个而且只有一个蓝图对象。本文简单介绍了蓝图的定义,然后通过创建和注册蓝图,做了一个简单的演示,但这对于蓝图的理解远远不够。
因为蓝图对大型应用是理想的。一个项目可以实例化一个应用对象,初始化几个扩展,并注册一集合的蓝图。根据官方文档,蓝图对于大型应用特别有用。在大型应用中,您可以将应用代码根据不同的业务分解成多个蓝图。
参考链接:https://sanic.dev/zh/guide/best-practices/blueprints.html#%E6%A6%82%E8%BF%B0-overview
版权声明: 本文为 InfoQ 作者【宇宙之一粟】的原创文章。
原文链接:【http://xie.infoq.cn/article/2571a194f46862cccdc11e0f9】。文章转载请联系作者。
评论