codecamp

Django4.0 中间件-异步支持

中间件支持同步和异步请求的任意组合。如果Django不能同时支持它们,它会调整请求来适应中间件的需求,但会有性能损失。

默认情况下,Django假设你的中间件只能处理同步请求。如果要改变这种模式,需要在你的中间件工厂函数或类中添加入如下属性:

  • sync_capable ​是一个布尔值,来表明中间件是否处理同步请求。默认为 ​True​。
  • async_capable ​是一个布尔值,来表明中间件是否处理异步请求。默认为 ​False​。

如果中间件的​sync_capable = True​并且 ​async_capable = True​,那么Django 会将请求传递给它而不进行转换。在这种情况下,你可以使用 ​asyncio.iscoroutinefunction()​ 来检查传递的 ​get_response​ 是否是一个协同函数,从而确定中间件是否接收到异步请求。
django.utils.decorators​ 模块包含 ​sync_only_middleware()​,​async_only_middleware()​ 和 ​sync_and_async_middleware()​ 装饰器,允许你将这些标志应用到中间件工厂函数中。
返回的可调用对象必须符合 ​get_response ​方法的同步或异步性质。如果你有一个异步的 ​get_response​,你必须返回一个协程函数(​async def​)。
process_view​、​process_template_response ​和 ​process_exception ​方法,如果有的话,也应该进行调整以匹配同步/异步模式。然而,如果你不这样做,Django 会根据需要单独调整它们,但会有额外的性能损失。
下面以一个例子来说明如何创建一个支持这两种功能的中间件函数:

import asyncio
from django.utils.decorators import sync_and_async_middleware

@sync_and_async_middleware
def simple_middleware(get_response):
    # One-time configuration and initialization goes here.
    if asyncio.iscoroutinefunction(get_response):
        async def middleware(request):
            # Do something here!
            response = await get_response(request)
            return response

    else:
        def middleware(request):
            # Do something here!
            response = get_response(request)
            return response

    return middleware

注解:如果你声明了一个同时支持同步和异步调用的混合中间件,你得到的调用种类可能与底层视图不匹配。Django 会优化中间件调用栈,使其尽可能少的同步/异步转换。

因此,即使你包装的是一个异步视图,如果在你和视图之间有其他的、同步的中间件,你也可能会在同步模式下被调用。


Django4.0 中间件-异常处理
Django4.0 中间件-升级Django1.10之前的中间件
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

Django4.0 模型和数据库

Django4.0 处理HTTP请求

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }