Flask 蓝图(Blueprint)使用方式解析
Flask蓝图提供了模块化管理程序路由的功能,使程序结构清晰、简单易懂。下面分析蓝图的使用方法
假如说我们要为某所学校的每个人建立一份档案,一个很自然的优化方式就是这些档案如果能分类管理,就是说假如分为老师、学生、后勤人员等类别,那么后续查找和管理这些档案就方便清晰许多。Flask的蓝图就提供了类似“分类”的功能。
下面先上一张较大型程序的组织结构图

可以看到在app文件夹下有两个文件夹main和auth内含有视图函数,而main和auth就是注册的两个蓝图。
1. 蓝图的创建及注册
在图1中,以main文件夹为例。在main文件夹的__init__.py文件中,可创建蓝图,代码如下:

从Flask中导入Blueprint类,再创建一个实例即可。Blueprint接受两个参数实例化,分别为蓝本的名字和蓝本所在的包或模块,大多数情况下第二个参数使用Python 的__name__ 变量即可。

在图3中,是在Flask文件夹下的__init__.py文件中注册这两个模块(请结合图1理解文件夹的组织结构)。该__init__.py文件中包含app创建函数,创建app后,即可注册已创立的蓝图。
最后一部是在main文件夹下的view文件中导入创建的蓝图,使用from . import main命令。不要忘记这一步,应为视图函数实在view文件种定义的,不导入蓝图的话,无法用蓝图定义路由。
另请注意在图2中,在main = Blueprint('main', __name__) 命令下有一个from . import views, errors命令。该命令的意思是导入在views和errors整个模块。在此我们发现views模块和__init__模块之间存在相互导入。一定要保证__init__模块中,from . import views, error命令在main = Blueprint('main', __name__)之后,否则会产生依赖循环导入的错误。
2. 使用蓝图创建路由
使用蓝图创建路由的示例如下图:

该路由的创建有两点要注意,一是@main.route修饰器,在使用蓝图之前,所有的路由均通过@app.route注册,在此可对比创建蓝图后的不同。二是url_for函数的参数,该参数是一个“端点”名称,就是和在路由中定义的视图函数的名称,此处的‘ .index ’端点名是一种简写的方式,就是表示main蓝图下的index函数。如果我们要指向‘auth’蓝图下的index函数,应该使用‘ auth.index ’ 端点名称
另请注意图4中生成的url和通过@app.route修饰器生成的url没有区别,是因为在注册main蓝图时(见图2)没有加“前缀”。回到图2,对比main蓝图和auth蓝图的注册,会发现auth在注册时多了一个url_prefix='/auth' ,这个就是加的前缀。假如我们通过@auth.route('/student')创建了一个路由,那么我们在访问该路由时,要输入www.somehost.com/auth/student 才能行。
3. 从蓝图回到全局
创建蓝本后,会对Flask已定义的一些功能造成改变。例如在Flask中提供了一个before_request 钩子,通过该钩子,可以注册在请求之前必须先完成的函数。在创建蓝本前,当访问通过@app.route修饰器创建的所有路由时,均要先完成在钩子中注册的函数。但注册蓝本后,如果使用@main.before_request钩子,那么我们访问通过别的蓝本注册的路由时,可不用先完成在钩子中注册的函数。如果仍要保持“全局”的功能,应该使用@main.before_app_request钩子。
链接:https://www.jianshu.com/p/95b584e4f76e
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 地球OL攻略 —— 某应届生求职总结
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· 提示词工程——AI应用必不可少的技术
· .NET周刊【3月第1期 2025-03-02】