django 1.8 官方文档翻译: 3-2-1 内建的视图
内建的视图
有几个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 文档协作翻译小组,原文:Built-in Views。
本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。
Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。