8.28

3_1_4_Decorators.md

+# 视图装饰器 #
+
+Django为视图提供了数个装饰器，用以支持相关的HTTP服务。
+
+## 允许的HTTP 方法 ##
+
+`django.views.decorators.http` 包里的装饰器可以基于请求的方法来限制对视图的访问。若条件不满足会返回 `django.http.HttpResponseNotAllowed`。
+
+`require_http_methods`(request_method_list)[source]
+
+限制视图只能服务规定的http方法。用法：
+
+```
+from django.views.decorators.http import require_http_methods
+
+@require_http_methods(["GET", "POST"])
+def my_view(request):
+    # I can assume now that only GET or POST requests make it this far
+    # ...
+    pass
+```
+
+注意，方法名必须大写。
+
+`require_GET()`
+
+只允许视图接受GET方法的装饰器。
+
+`require_POST()`
+
+只允许视图接受POST方法的装饰器。
+
+`require_safe()`
+
+只允许视图接受 GET 和 HEAD 方法的装饰器。 这些方法通常被认为是安全的，因为方法不该有请求资源以外的目的。
+
+> 注
+>
+> Django 会自动清除对HEAD 请求的响应中的内容而只保留头部，所以在你的视图中你处理HEAD 请求的方式可以完全与GET 请求一致。因为某些软件，例如链接检查器，依赖于HEAD 请求，所以你可能应该使用`require_safe` 而不是`require_GET`。
+
+## 可控制的视图处理 ##
+
+`django.views.decorators.http` 中的以下装饰器可以用来控制特定视图的缓存行为。
+
+`condition`(etag_func=None, last_modified_func=None)[source]
+
+
+`etag`(etag_func)[source]
+
+`last_modified`(last_modified_func)[source]
+
+这些装饰器可以用于生成ETag 和Last-Modified 头部；参考 conditional view processing.
+
+## GZip 压缩 ##
+
+`django.views.decorators.gzip` 里的装饰器基于每个视图控制其内容压缩。
+
+`gzip_page()`
+
+如果浏览器允许gzip 压缩，这个装饰器将对内容进行压缩。它设置相应的`Vary`头部，以使得缓存根据`Accept-Encoding`头来存储信息。
+
+## Vary 头部 ##
+
+`django.views.decorators.vary` 可以用来基于特定的请求头部来控制缓存。
+
+`vary_on_cookie`(func)[source]
+
+`vary_on_headers`(\*headers)[source]
+
+到当构建缓存的键时，Vary 头部定义一个缓存机制应该考虑的请求头。
+
+参见[使用vary 头部](http://python.usyiyi.cn/django/topics/cache.html#using-vary-headers)。
+
+> 译者：[Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html)，原文：[Decorators](https://docs.djangoproject.com/en/1.8/topics/http/decorators/)。
+>
+> 本文以 [CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/cn/) 协议发布，转载请保留作者署名和文章出处。
+>
+> [Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html)人手紧缺，有兴趣的朋友可以加入我们，完全公益性质。交流群：467338606。

3_2_1_Built-in Views.md

+# 内建的视图 #
+
+有几个Django 的内建视图在编写视图 中讲述，文档的其它地方也会有所讲述。
+
+## 开发环境中的文件服务器 ##
+
+**static.serve(request, path, document_root, show_indexes=False)**
+
+在本地的开发环境中，除了你的项目中的静态文件，可能还有一些文件，出于方便，你希望让Django 来作为服务器。serve() 视图可以用来作为任意目录的服务器。（该视图不能用于生产环境，应该只用于开发时辅助使用；在生产环境中你应该使用一个真实的前端Web 服务器来服务这些文件）。
+
+最常见的例子是用户上传文档到`MEDIA_ROOT` 中。`django.contrib.staticfiles` 用于静态文件且没有对用户上传的文件做处理，但是你可以通过在URLconf 中添加一些内容来让Django 作为MEDIA_ROOT 的服务器：
+
+```
+from django.conf import settings
+from django.views.static import serve
+
+# ... the rest of your URLconf goes here ...
+
+if settings.DEBUG:
+    urlpatterns += [
+        url(r'^media/(?P<path>.*)$', serve, {
+            'document_root': settings.MEDIA_ROOT,
+        }),
+   ]
+```
+
+注意，这里的代码片段假设你的`MEDIA_URL`的值为`'/media/'`。它将调用`serve()` 视图，传递来自URLconf 的路径和（必选的）`document_root` 参数。
+
+因为定义这个URL 模式显得有些笨拙，Django 提供一个小巧的URL 辅助函数`static()`，它接收`MEDIA_URL`这样的参数作为前缀和视图的路径如`'django.views.static.serve'`。其它任何函数参数都将透明地传递给视图。
+
+## 错误视图 ##
+
+Django 原生自带几个默认视图用于处理HTTP 错误。若要使用你自定义的视图覆盖它们，请参见自定义错误视图。
+
+### 404 (page not found) 视图 ###
+
+**defaults.page_not_found(request, template_name='404.html')**
+
+当你在一个视图中引发Http404 时，Django 将加载一个专门的视图用于处理404 错误。默认为`django.views.defaults.page_not_found()` 视图，它产生一个非常简单的“Not Found” 消息或者渲染`404.html`模板，如果你在根模板目录下创建了它的话。
+
+默认的404 视图将传递一个变量给模板：`request_path`，它是导致错误的URL。
+
+关于404 视图需要注意的3点：
+
++ 如果Django 在检测URLconf 中的每个正则表达式后没有找到匹配的内容也将调用404 视图。
++ 404 视图会被传递一个`RequestContext`并且可以访问模板上下文处理器提供的变量（例如`MEDIA_URL`）。
++ 如果DEBUG 设置为`True`（在你的`settings` 模块中），那么将永远不会调用404 视图，而是显示你的URLconf 并带有一些调试信息。
+
+### 500 (server error) 视图 ###
+
+**defaults.server_error(request, template_name='500.html')**
+
+类似地，在视图代码中出现运行时错误，Django 将执行特殊情况下的行为。如果一个视图导致异常，Django 默认情况下将调用`django.views.defaults.server_error` 视图，它产生一个非常简单的“Server Error” 消息或者渲染`500.html`，如果你在你的根模板目录下定义了它的话。
+
+默认的500 视图不会传递变量给`500.html` 模板，且使用一个空`Context` 来渲染以减少再次出现错误的可能性。
+
+如果`DEBUG` 设置为`True`（在你的`settings` 模块中），那么将永远不会调用500 视图，而是显示回溯并带有一些调试信息。
+
+### 403 (HTTP Forbidden) 视图 ###
+
+**defaults.permission_denied(request, template_name='403.html')**
+
+与404 和500 视图一样，Django 具有一个处理403 Forbidden 错误的视图。如果一个视图导致一个403 视图，那么Django 将默认调用`django.views.defaults.permission_denied`视图。
+
+该视图加载并渲染你的根模板目录下的`403.html`，如果这个文件不存在则根据RFC 2616（HTTP 1.1 Specification）返回“403 Forbidden”文本。
+
+`django.views.defaults.permission_denied` 通过`PermissionDenied` 异常触发。若要拒绝访问一个视图，你可以这样视图代码：
+
+```
+from django.core.exceptions import PermissionDenied
+
+def edit(request, pk):
+    if not request.user.is_staff:
+        raise PermissionDenied
+    # ...
+```
+
+### 400 (bad request) 视图 ###
+
+**defaults.bad_request(request, template_name='400.html')**
+
+当Django 中引发一个`SuspiciousOperation` 时，它可能通过Django 的一个组件处理（例如重设会话的数据）。如果没有特殊处理，Django 将认为当前的请求时一个'bad request' 而不是一个server error。
+
+`django.views.defaults.bad_request` 和server_error 视图非常相似，除了返回400 状态码来表示错误来自客户端的操作。
+
+`bad_request` 视图同样只是在`DEBUG` 为`False` 时使用。
+
+> 译者：[Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html)，原文：[Built-in Views](https://docs.djangoproject.com/en/1.8/ref/views/)。
+>
+> 本文以 [CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/cn/) 协议发布，转载请保留作者署名和文章出处。
+>
+> [Django 文档协作翻译小组](http://python.usyiyi.cn/django/index.html)人手紧缺，有兴趣的朋友可以加入我们，完全公益性质。交流群：467338606。