深入Django(1): 通用视图 (generic views)

如果对Django的基础部分尚不熟悉，请参考《Django实战》系列。

内容提要
1. 回顾Django的视图函数（view function）
2. 在视图函数中使用模板
3. 简化视图函数的两个工具
4. 使用通用视图函数
5. Django提供的通用视图

1. 回顾Django的视图函数（view function）

Django中将视图定义为一种函数，我们称其为视图函数（view function)。当Django框架接收到http请求的时候，从定义的urlpatterns中寻找url表达式进行匹配，一旦找到匹配的项，就将HTTPRequest以及匹配到的其他字符串作为参数，调用找到的视图函数，然后根据视图函数返回的HTTPResponse对象进行响应。所以视图函数应该至少接收一个django.http.HTTPRequest对象作为参数，并返回django.http.HTTPResponse对象，如下：

def my_view(request, *args, **kwargs): response = HTTPResponse() … ... return response

2. 在视图函数中使用模板

视图函数返回的response对象中包含一些头（Header）信息和内容（Content），而我们通常通过模板来生成内容，所以我们经常用到的视图函数应该是这样：

def my_view_with_template(request, *args, **kwargs): var1 = foo var2 = bar t = get_template('path_name_of_template_file') c = Context({'key1':var1,'key2':var2}) content = t.render( c) return HTTPResponse(content)

3. 简化视图函数的两个工具

总是写这样的代码实在是让人厌倦，所以Django为我们提供了两个有用的工具：
一个是django.shortcuts.render_to_response函数，接收一系列的参数，包括模板路径、context使用的字典、原始的context实例以及要设定的mimetype等：
render_to_response(template_path_name, dictionary=None, context_instance=None, mimetype=None)
另一个是locals()函数，将所有的局部变量组装成一个字典。
有了这两个工具，视图函数就可以这样写：

def my_view_with_template(request, *args, **kwargs): var1 = foo var2 = bar return render_to_response('path_name_of_template_file', locals())

4. 使用通用视图函数

有了这两个工具，编写视图函数确实可以简化很多。但是这样你就满意了吗？Django并没有就此止步，更进一步注意到，很多视图函数其实都在做同样的事情，比如显示一组模型对象的列表，显示模型对象的详细信息，对模型对象的增、删、改操作等。为了简化对这些情况的处理，Django定义了一系列的通用视图（generic views），我们只需要使用这些内置的通用视图函数，而无需自己编写就可以实现相应的功能。

使用通用视图的方法是在URLconf文件中创建参数字典，将字典作为URLconf元组的第三个成员,即可自动在调用视图函数时向其传递参数了。比如在django.views.generic.list_detail模块中的object_list函数，用于显示模型对象的列表，可以接受queryset参数作为模型对象的结果集。如果我们要用该视图函数显示在《Django实战》系列中的创建的第一个模型类Product的列表，可以在URLconf中这样配置：

from django.conf.urls.defaults import * from django.views.generic import list_detail from depot.depotapp.models import Product product_info = { 'queryset': Product.objects.all(), } urlpatterns = patterns('', (r'^product/list/$', list_detail.object_list, product_info) )

除了queryset外，object_list函数还可以接收许多其他的参数：

object_list(request, queryset, paginate_by=None, page=None, allow_empty=True, template_name=None, template_loader=loader, extra_context=None, context_processors=None, template_object_name='object', mimetype=None )

通用视图函数接收到参数后，会创建context，并渲染模板，最后返回HTTPResponse对象。object_list函数创建的context中会包含以下字典项：

object_list             要显示的对象的list
is_paginated         是否分页
results_per_page 如果分页，存储每页记录数
has_next              是否有下一页
has_previous       是否有上一页
page                     当前页码
next                      下一页
previous               上一页
pages                   总页数
hits                       总条目数
last_on_page       本页最后录一条记录的序数（从1开始）
first_on_page       本页第一条记录的序数（从1开始）
page_range          页码范围的列表

如果这些context字典项不能满足你的需要，还可以通过指定extra_context参数，传入一个字典，该字典中的内容会被合并到context字典中。

context字典项会被模板使用。如果不指定模板，该函数将使用[app_name]/[model_name]_list.html作为模板，指定模板的方法也是通过参数字典，比如：

product_info = { 'queryset': Product.objects.all(), 'template_name': 'depotapp/another_product_list.html'), }

这个参数字典会传入template_name参数来指定渲染的模板文件。