一、什么是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', ]
三、中间件执行流程
从用户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返回时执行的处理函数。
一个正常的中间件执行流程:
首先,先从第一个中间件的process_request函数到达最后一个中间件的process_request函数,如果没有出现返回的话。紧接着又从第一个中间件的process_view函数一直执行到最后一个中间件的process_view函数,然后将请求传递给views函数处理。views函数返回时,先从最后一个中间件的process_response开始执行一直到第一个中间件的process_response函数处理完成,然后返回给用户。
从Django1.10版本开始,当某个中间件的process_request函数触发了返回,那么在这个中间件之后的所有中间件方法都不会执行。直接从这个中间件开始向前执行process_response函数,最终返回给用户。
Django1.10版本之前的版本是,当某个中间件的process_request函数触发了返回,那么在这个中间件之后的所有中间件的process_request方法都不会执行,但会从最后一个中间件开始向前执行process_response函数,最终返回给用户。
一个包含异常处理的中间件执行流程:
process_exception函数只当views发生异常时才会执行,它先从最后一个中间件开始搜索异常处理方法。如果最后一个中间件没有处理,它会将异常传递给前一个中间件,如果一直传递给第一个中间件都没有处理异常。它就返回最后一个中间件开始执行process_response函数,最终返回给用户。
如果其中某一个中间件处理了这个异常,它就会立刻返回到最后一个中间件开始执行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函数,那这些都是必须要写的的吗?答案是否定的,你想写哪个就写哪个,自定义中间件中可以写任意一个或多个函数。这些函数名是不能变的!