一、什么是Django中间件

    中间件是一个钩子框架,它们可以介入Django 的请求和响应处理过程。它是一个轻量级、底层的“插件”系统,用于在全局修改Django 的输入或输出。每个中间件组件负责完成某个特定的功能。例如:“django.middleware.csrf.CsrfViewMiddleware”中间件的功能是防止POST跨域请求,除非在请求中带了csrf_token才会通过。


二、怎样激活中间件

    我们在setting.py文件中配置中间件,在Django1.10之前叫“MIDDLEWARE_CLASSES”,从Django1.10开始就叫“MIDDLEWARE”。

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]


三、中间件执行流程

Django之中间件_第1张图片

从用户request到response返回,每一个中间件中可以定义五种处理函数:

process_request(self,request)
process_view(self, request, callback, callback_args, callback_kwargs)
process_template_response(self,request,response)
process_exception(self, request, exception)
process_response(self, request, response)

process_request:

    在接到用户请求时所定义的处理函数。

process_view:

    这一步是在路由分发之后,views函数之前所执行的处理函数。

process_template_response:

    这个函数基本不用,只有当views函数返回中有render时才会执行的处理函数。

process_exception:

    异常处理函数,只有当views中函数出现异常时才会执行。其他process_xxx函数出现异常时,是不会触发此函数的。

process_response:

    response返回时执行的处理函数。


一个正常的中间件执行流程:

Django之中间件_第2张图片

    首先,先从第一个中间件的process_request函数到达最后一个中间件的process_request函数,如果没有出现返回的话。紧接着又从第一个中间件的process_view函数一直执行到最后一个中间件的process_view函数,然后将请求传递给views函数处理。views函数返回时,先从最后一个中间件的process_response开始执行一直到第一个中间件的process_response函数处理完成,然后返回给用户。

Django之中间件_第3张图片

    从Django1.10版本开始,当某个中间件的process_request函数触发了返回,那么在这个中间件之后的所有中间件方法都不会执行。直接从这个中间件开始向前执行process_response函数,最终返回给用户。

    Django1.10版本之前的版本是,当某个中间件的process_request函数触发了返回,那么在这个中间件之后的所有中间件的process_request方法都不会执行,但会从最后一个中间件开始向前执行process_response函数,最终返回给用户。


一个包含异常处理的中间件执行流程:

Django之中间件_第4张图片

    process_exception函数只当views发生异常时才会执行,它先从最后一个中间件开始搜索异常处理方法。如果最后一个中间件没有处理,它会将异常传递给前一个中间件,如果一直传递给第一个中间件都没有处理异常。它就返回最后一个中间件开始执行process_response函数,最终返回给用户。

Django之中间件_第5张图片

    如果其中某一个中间件处理了这个异常,它就会立刻返回到最后一个中间件开始执行process_response函数,在这个中间件之前的所有中间件的process_exception函数就不执行了。


四、如何自定义中间件

a、在项目中新建一个py文件

TestMiddleware.py

b、编辑TestMiddleware.py

from django.utils.deprecation import MiddlewareMixin

class TestMiddleware1(MiddlewareMixin):
    def process_request(self, request):
        print("Test1-->process_request")

    def process_response(self, request, response):
        print("Test1-->process_response")
        return response

    def process_view(self, request, callback, callback_args, callback_kwargs):
        print("Test1-->process_view")


class TestMiddleware2(MiddlewareMixin):
    def process_request(self, request):
        print("Test2-->process_request")

    def process_response(self, request, response):
        print("Test2-->process_response")
        return response

    def process_view(self, request, callback, callback_args, callback_kwargs):
        print("Test2-->process_view")


class TestMiddleware3(MiddlewareMixin):
    def process_request(self, request):
        print("Test3-->process_request")

    def process_response(self, request, response):
        print("Test3-->process_response")
        return response

    def process_view(self, request, callback, callback_args, callback_kwargs):
        print("Test3-->process_view")

    在Django1.10之前,我们自定义的中间件类继承的是Object。从Django1.10开始,我们必须继承MiddlewareMixin类。

class MiddlewareMixin(object):
    def __init__(self, get_response=None):
        self.get_response = get_response
        super(MiddlewareMixin, self).__init__()

    def __call__(self, request):
        response = None
        if hasattr(self, 'process_request'):
            response = self.process_request(request)
        if not response:
            response = self.get_response(request)
        if hasattr(self, 'process_response'):
            response = self.process_response(request, response)
        return response


c、在setting.py文件添加自定义的中间件

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'TestMiddleware.TestMiddleware1',
    'TestMiddleware.TestMiddleware2',
    'TestMiddleware.TestMiddleware3',
]

    MIDDLEWARE是一个列表,所以里面中间件的顺序是很重要的,不能随意颠倒。为了不影响它原先的功能,我们把自定义的中间件一般放到最后执行。当然如果你做了一个IP拦截功能的中间件,你也可以把它放到第一个执行。

    我们写了这么多的process_request、process_view、process_response函数,那这些都是必须要写的的吗?答案是否定的,你想写哪个就写哪个,自定义中间件中可以写任意一个或多个函数。这些函数名是不能变的!