视图装饰器
查看 装饰类 来了解如何在基于类的视图中使用这些装饰器。
在 中的装饰器可以用来根据请求方法来限制对视图的访问。如果条件不满足,这些装饰器将返回 django.http.HttpResponseNotAllowed 。
(request_method_list)
装饰器可以要求视图只接受特定的请求方法。用法如下:
注意请求方法应该是大写。
require_GET
()
装饰器可以要求视图只接受 GET 方法。用法如下:
require_POST
()
装饰器可以要求视图只接受 POST 方法。用法如下:
require_safe
()
装饰器可以要求视图只接收 GET 和 HEAD 方法。这些方法通常被认为是安全的,因为它们除了检索请求的资源外,没有特别的操作。
Web 服务器自动删除对 HEAD 请求的相应内容,并保持头部不变,所以你可以像处理视图里的 GET 请求一样处理 HEAD 请求。因为一些软件依赖 HEAD 请求(比如链接检测器),因此你需要使用 require_safe
而不是 require_GET
。
条件视图处理
下面 django.views.decorators.http 的装饰器被用来控制特殊视图中的缓存行为。
condition
(etag_func=None, last_modified_func=None)
(etag_func)
last_modified
(last_modified_func)
这些装饰器被用来生成 ETag
和 Last-Modified
头部;查看 。
django.views.decorators.gzip 里的装饰器控制基于每个视图的内容压缩。
gzip_page
()
如果浏览器允许 gzip 压缩,那么这个装饰器将压缩内容。它相应的设置了 Vary
头部,这样缓存将基于 Accept-Encoding
头进行存储。
Vary 头
django.views.decorators.vary 里的装饰器被用来根据特殊请求头的缓存控制。
(func)
Vary
头定义了缓存机制在构建其缓存密钥时应该考虑哪些请求报头。
查看 。
django.views.decorators.cache 中的装饰器控制服务器及客户端的缓存。
cache_control
(\*kwargs*)
这个装饰器通过添加所有关键字参数来修补响应的 Cache-Control
头。查看 来了解转换的详情。
never_cache
(view_func)
This decorator adds an Expires
header to the current date/time.
这个装饰器添加 头到一个响应来标识禁止缓存该页面。
每个头只有在还没有设置的情况下才会被添加。
Common
The decorators in allow per-view customization of CommonMiddleware behavior.
no_append_slash
()