在 Django 中,当一个请求(URL)匹配到一个路由后,在返回相应的视图函数处理之前,Django 会先经过中间件(Middleware)的处理流程。
中间件是一组轻量级、底层的插件系统,用于在全局范围内改变 Django 的输入或输出。每个中间件组件都负责执行一些特定的任务,比如请求和响应的处理、用户认证、会话管理等。
当 Django 接收到一个 HTTP 请求时,它会按照在 settings.py
文件中 MIDDLEWARE
配置的顺序,依次经过每个中间件中的 __call__
方法(或 Django 2.x 及更早版本中的 process_request
方法)进行处理。这些中间件可以对请求进行修改、添加信息或执行其他逻辑。
一旦请求通过了所有中间件的 process_request
(或 __call__
)方法,Django 就会根据 URLconf 找到匹配的视图函数,并将请求传递给该函数进行处理。
视图函数处理完请求并生成响应后,Django 会按照与 process_request
相反的顺序,依次经过每个中间件的 process_response
方法。这些中间件可以对响应进行修改、添加信息或执行其他逻辑。
如果中间件中的任何方法返回了一个响应对象(在 process_request
或 process_view
中),那么 Django 将不会继续执行后续的中间件或视图函数,而是直接返回这个响应对象。
此外,Django 还提供了 process_exception
、process_template_response
和 process_view
等其他中间件方法,用于在视图函数执行前后以及处理异常时提供额外的功能。
因此,可以说在 Django 中,每个路由匹配成功后,返回视图函数之前,都会先经过配置好的中间件链进行处理。
例子:
场景设定
假设我们有一个 Django 项目,其中定义了一个简单的视图函数,用于返回一个 "Hello, World!" 的 HTTP 响应。同时,我们还定义了两个中间件,一个用于记录请求的开始时间,另一个用于在响应中添加一个自定义的 HTTP 头部。
中间件定义
- 记录请求时间的中间件 (
record_time_middleware.py
):
import time
from django.utils.deprecation import MiddlewareMixin
class RecordTimeMiddleware(MiddlewareMixin):
def process_request(self, request):
# 记录请求开始时间
request.start_time = time.time()
- 添加自定义 HTTP 头部的中间件 (
custom_header_middleware.py
):
from django.utils.deprecation import MiddlewareMixin
class CustomHeaderMiddleware(MiddlewareMixin):
def process_response(self, request, response):
# 添加自定义 HTTP 头部
response['X-Custom-Header'] = 'This is a custom header'
return response
中间件配置
在 settings.py
文件中,我们需要将这两个中间件添加到 MIDDLEWARE
列表中:
MIDDLEWARE = [
# ... 其他中间件 ...
'myapp.middleware.record_time_middleware.RecordTimeMiddleware',
'myapp.middleware.custom_header_middleware.CustomHeaderMiddleware',
# ... 其他中间件 ...
]
视图函数定义
在 views.py
文件中,我们定义了一个简单的视图函数:
from django.http import HttpResponse
def hello_world_view(request):
# 这里可以访问 request.start_time,这是由 RecordTimeMiddleware 设置的
return HttpResponse('Hello, World!')
URL 配置
在 urls.py
文件中,我们将视图函数与一个 URL 模式关联起来:
from django.urls import path
from .views import hello_world_view
urlpatterns = [
path('hello/', hello_world_view),
]
工作流程
-
请求到达:当用户访问
http://yourdomain.com/hello/
时,Django 会接收到一个 HTTP 请求。 -
中间件处理:
- RecordTimeMiddleware 的
process_request
方法首先被调用,它记录了请求的开始时间,并将这个时间存储在request
对象的start_time
属性中。 - 然后,请求会继续通过其他中间件(如果有的话),最终到达
hello_world_view
视图函数。
- RecordTimeMiddleware 的
-
视图函数处理:
hello_world_view
视图函数被调用,它生成了一个 "Hello, World!" 的 HTTP 响应。 -
响应中间件处理:
- 在响应返回给客户端之前,
CustomHeaderMiddleware
的process_response
方法被调用。它向响应中添加了一个自定义的 HTTP 头部X-Custom-Header
。 - 然后,响应会继续通过其他中间件(如果有的话),最终返回给客户端。
- 在响应返回给客户端之前,
-
客户端接收响应:用户最终会在浏览器中看到一个包含 "Hello, World!" 文本的 HTTP 响应,并且响应头中会包含一个名为
X-Custom-Header
的自定义头部。
通过这个例子,我们可以看到 Django 中间件是如何在请求和响应处理流程中插入自定义逻辑的。中间件可以用于执行各种任务,如身份验证、会话管理、日志记录、跨站请求伪造(CSRF)保护等。