flask基础之请求钩子(十二)

前言

什么是请求钩子?在客户端和服务器交互的过程中,有些准备工作或扫尾工作需要统一处理,为了让每个视图函数避免编写重复功能的代码,flask提供了统一的接口可以添加这些处理函数,即请求钩子。

请求钩子的原理

先回顾一下flask对请求的处理流程:

接收请求--》创建请求上下文--》请求上下文入栈--》创建该请求的应用上下文--》应用上下文入栈--》处理逻辑--》请求上下文出栈--》应用上下文出栈

看了这个过程,flask放置请求钩子的位置有:处理逻辑之前,处理逻辑之后,应用上下文出栈之前。

flask有五种常用请求钩子:

  • before_first_request:在处理app第一个请求前运行。

  • before_request:在每次请求前运行。

  • after_request:如果处理逻辑没有异常抛出,在每次请求后运行。

  • teardown_request:在每次请求后运行,即使处理发生了错误。

  • teardown_appcontext:在应用上下文从栈中弹出之前运行

定义请求钩子

# before_request装饰的方法会加载到app的before_request_funcs列表中,按加载的顺序依次执行,不需要参数
@app.before_request
def rest_test():
    print('this is a test'+ '--2')
    pass

# before_first_request装饰的函数加载到before_first_request_funcs列表中,只不过在app第一次接收到请求后执行,其他时候不再执行
@app.before_first_request
def app_first_request():
    print('first_request' + '--1')

# after_request装饰的函数加载到after_request_funcs列表中,传入的参数是response对象,可以对其进行拦截修改,必须返回一个response对象
@app.after_request
def after_request(rsp):
    print(rsp)
    print('--3')
    return rsp

# teardown_request装饰的函数加载到teardown_request_funcs中,如果发生了异常则传入error的对象,无异常参数为None,无返回值
@app.teardown_request
def teardown_request(error):
    print(error)
    print('--4')

# teardown_appcontext装饰的函数加载到teardown_appcontext_funcs中,如果发生了异常则传入error的对象,无异常参数为None,无返回值
@app.teardown_appcontext
def teardown_appcontext(error):
    print('--5')

注意

  • 在debug模式下,teardown_request和teardown_appcontext装饰的函数不会执行;

  • after_request请求钩子会自动传入response对象作为参数,同时必须返回一个response对象;

  • before_request装饰的函数不需要返回数据,如果返回了数据,那么视图函数不会再执行,而是直接返回结果。

蓝图的请求钩子

蓝图存在的目的是为了在大型应用中对众多的业务模块的api分层次管理,所以即使在主app下定义的路由规则,其默认是在None为名字的蓝图下面的,所以蓝图也有自己的请求钩子,只在该蓝图下的api其作用。

from flask import Blueprint

testblue = Blueprint('blue', __name__)

# 蓝图也可以为主app添加请求钩子,before_app_first_request装饰会在app的before_first_request_funcs列表中,以None为键;
@testblue.before_app_first_request
def app_first_request():
    print('first_request' + '--1')

# 加载到app的before_request_funcs列表中,在None蓝图下,按加载的顺序依次执行,不需要参数
@testblue.before_app_request
def app_request():
    pass

# 加载到app的before_request_funcs列表中,在testblue蓝图下
@testblue.before_request
def blue_before_request():
    pass

# 加载到after_request_funcs列表中,在testblue蓝图下
@testblue.after_request
def after_request(rsp):
    return rsp

# 加载到after_request_funcs列表中,在None蓝图下
@testblue.after_app_request
def blue_after_app_request(rsp):
    return rsp

#teardown_request装饰的函数加载到app的teardown_request_funcs中,在testblue蓝图下
@testblue.teardown_request
def teardown_request(error):
    print(error)
    print('--4')

# 和teardown_request功能一样,在None蓝图下
@testblue.teardown_app_request
def blue_teardown_app_request(error):
    pass

注意

  • teardown_request装饰的函数无论有没有异常都执行,after_request装饰的函数无异常才执行。

  • 对于before_request、after_request、teardown_request请求钩子,如果app存在相应的请求钩子函数,则蓝图和app的请求钩子函数都会执行,先执行app的钩子函数,再执行蓝图的钩子函数。

参考

  • https://dormousehole.readthedocs.io/en/latest/

猜你喜欢

转载自www.cnblogs.com/cwp-bg/p/10094912.html