如果对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参数作为模型对象的结果集。如果我们要用该视图函数显示在中的创建的的列表,可以在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参数来指定渲染的模板文件。
5. Django提供的通用视图
除了object_list外,Django还提供了许多通用视图函数,分布在几个模块中:
django.views.generic.list_detail模块
- object_list 显示模型对象列表
- object_detail 显示单个模型对象
django.views.generic.create_update模块
- create_object 创建模型对象
- update_object 修改模型对象
- delete_object 删除模型对象
django.views.generic.simple模块
- direct_to_template 直接使用指定的模板渲染给定的context对象
- redirect_to 重定向到指定的url
django.views.generic.date_based模块
这个模块主要处理“按时间查看存档”的功能,来源于新闻出版行业。具体包括:
- archive_index 最顶级的归档,列出所有年份及指定数量的最新对象
- archive_year 按年归档,列出所有拥有对象的月份
- archive_month 按月归档,列出本月的所有对象,找到拥有对象的上一个、下一个月份
- archive_week 按周归档,列出本周的所有对象
- archive_day 按日归档,列出当天的所有对象,找到拥有对象的上一个、下一个日期
- archive_today 当前日期(今天)的按日归档
- object_detail 显示按照年/月/日/序号找到的对象
这些通用视图函数不再一一介绍,可以参考Django API文档,关注其参数,context内容和默认模板,就能基本掌握其使用。