视图装饰器

Django 提供很多装饰器,它们可以为视图支持多种 HTTP 特性。

查看 装饰类 来了解如何在基于类的视图中使用这些装饰器。

允许的 HTTP 方法

django.views.decorators.http 中的装饰器可以用来根据请求方法来限制对视图的访问。如果条件不满足,这些装饰器将返回 django.http.HttpResponseNotAllowed

require_http_methods(request_method_list)[源代码]

装饰器可以要求视图只接受特定的请求方法。用法如下:

  1. from django.views.decorators.http import require_http_methods
  2. @require_http_methods(["GET", "POST"])
  3. def my_view(request):
  4. # I can assume now that only GET or POST requests make it this far
  5. # ...
  6. pass

注意请求方法应该是大写。

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

require_GET()

装饰器可以要求视图只接受 GET 方法。用法如下:

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

require_POST()

装饰器可以要求视图只接受 POST 方法。用法如下:

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

require_safe()

装饰器可以要求视图只接收 GET 和 HEAD 方法。这些方法通常被认为是安全的,因为它们除了检索请求的资源外,没有特别的操作。

备注

Web 服务器自动删除对 HEAD 请求的相应内容,并保持头部不变,所以你可以像处理视图里的 GET 请求一样处理 HEAD 请求。因为一些软件依赖 HEAD 请求(比如链接检测器),因此你需要使用 require_safe 而不是 require_GET

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

条件视图处理

下面 django.views.decorators.http 的装饰器被用来控制特殊视图中的缓存行为。

condition(etag_func=None, last_modified_func=None)[源代码]

etag(etag_func)[源代码]

last_modified(last_modified_func)[源代码]

这些装饰器被用来生成 ETagLast-Modified 头部;查看 conditional view processing

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

GZip 压缩

django.views.decorators.gzip 里的装饰器控制基于每个视图的内容压缩。

gzip_page()

如果浏览器允许 gzip 压缩,那么这个装饰器将压缩内容。它相应的设置了 Vary 头部,这样缓存将基于 Accept-Encoding 头进行存储。

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

Vary 头

django.views.decorators.vary 里的装饰器被用来根据特殊请求头的缓存控制。

vary_on_cookie(func)

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

vary_on_headers(*headers)[源代码]

Vary 头定义了缓存机制在构建其缓存密钥时应该考虑哪些请求报头。

查看 using vary headers

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

缓存

django.views.decorators.cache 中的装饰器控制服务器及客户端的缓存。

cache_control(**kwargs)[源代码]

这个装饰器通过添加所有关键字参数来修补响应的 Cache-Control 头。查看 patch_cache_control() 来了解转换的详情。

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

never_cache(view_func)[源代码]

这个装饰器会为当前日期/时间添加一个 Expires 头部。

这个装饰器添加 Cache-Control: max-age=0, no-cache, no-store, must-revalidate 头到一个响应来标识禁止缓存该页面。

每个头只有在还没有设置的情况下才会被添加。

Changed in Django 5.0:

已添加对包装异步视图函数的支持。

Common

django.views.decorators.common 中的装饰器允许对 CommonMiddleware 的行为进行每视图自定义。

no_append_slash()[源代码]

这个装饰器允许单独的视图排除 APPEND_SLASH URL 标准化。

Changed in Django 5.0:

已添加对包装异步视图函数的支持。