Django 1.0 中文文档-----指导 第三部分 发布视图

 编写你的Django应用 第三部分

 

我们接着上篇开始，继续网页投票应用，本篇我们着重在建立发布视图。

 

理念

 

视图在Django中就是一个特定功能和特定模板的网页，例如在博客程序中你会有如下视图：

 

博客首页 – 显示最新记录.

进入详细内容页面 – 页面固定链接.

基于年的存档页 – 显示给定年里所有月份的进入点.

基于月的存档页 – 显示给定月里所有天的进入点. .

基于日的存档页 – 显示给定日里所有天的进入点. 

评论 – 所有评论的进入链接.

 

在我们的投票应用程序中，我们有下面四个视图：

 

Poll “archive” 页 – 显示最新的投票.

Poll “detail” 页  – 显示投票页面.

Poll “results” 页 – 显示投票结果.

Vote action – 处理投票程序的页面.

 

在Django里，每个视图都是用一个简单的python函数描述的。

 

设计你的urls

 

编写视图第一步是设计你的URL结构，需要借助python的一个组件URLconf将python代码和URL联系起来。

当用户请求Django的页面，系统会查找ROOT_URLCONF 设置，Django加载组件并查找urlpatterns变量，一段类似如下格式的序列：

 

(regular expression, Python callback function [, optional dictionary])

 

Django会从第一个规则表达式开始，一直往下，匹配请求的URL直到匹配上，当找到匹配的时候，Django会回调函数，为第一个参数传入HttpRequest 对象，还有表达式里捕获的值。

要了解更多HttpRequest,URLconfs详情，可查看具体文档。

 

当我们创建工程的时候，mysite/urls.py会被自动创建。settings.py中默认配置指定位置ROOT_URLCONF = 'mysite.urls'
编辑mysite/urls.py：

 

1. from django.conf.urls.defaults import *
3. urlpatterns = patterns('',
4.     (r'^polls/$', 'mysite.polls.views.index'),
5.     (r'^polls/(?P<poll_id>\d+)/$', 'mysite.polls.views.detail'),
6.     (r'^polls/(?P<poll_id>\d+)/results/$', 'mysite.polls.views.results'),
7.     (r'^polls/(?P<poll_id>\d+)/vote/$', 'mysite.polls.views.vote'),
8. )

 

当有"/polls/23/"这样的地址请求时，python 会匹配到 r'^polls/(?P<poll_id>\d+)/$' 这里，然后调用

mysite/polls/views.py里的detail()函数，如下：

 

 

 

detail(request=<HttpRequest object>, poll_id='23')

 

poll_id='23' 来自(?P<poll_id>\d+). 通过正则匹配捕获的值，这里也可以定义多个值来捕获。

因为URL定义没有什么扩展名定义限制你也可以像这样定义

(r'^polls/latest\.php$', 'mysite.polls.views.index'),
用php做扩展名，看起来比较幽默。不过最好还是不要定义扩展名。

 

注意，URL表达式是不包括GET,POST参数和域名。例如http://www.example.com/myapp/，URL配置为/myapp/。

http://www.example.com/myapp/?page=3 也同样匹配/myapp/

 

表达式会在django加载的时候编译。

 

编写你的第一个视图

 

好，我们还没有创建视图，只是创建了URLconf，接下来我们确认下URLconf。

启动django服务

 

python manage.py runserver

我们访问"http://localhost:8000/polls/"，我们会看到下面的报错信息：

 

ViewDoesNotExist at /polls/

Tried index in module mysite.polls.views. Error was: 'module'
object has no attribute 'index'

 

这个信息提示我们没有在mysite/polls/views.py里创建 index() 函数

测试"/polls/23/", "/polls/23/results/" 和 "/polls/23/vote/". 都会有错误提示没有创建视图函数。

 

打开mysite/polls/views.py文件加入下面的代码：

1. from django.http import HttpResponse
3. def index(request):
4.     return HttpResponse("Hello, world. You're at the poll index.")

 

这是个简单的视图，访问"/polls/" 你会看到相应的内容输出。

我们继续创建接下来的视图，这个有一点不通，多了一个参数

 

 

 

1. def detail(request, poll_id):
2.     return HttpResponse("You're looking at poll %s." % poll_id)

 

访问"/polls/34/". 你会看到URL传入的ID

 

写一个有实际功能的视图

 

每个视图都会负责做些事情，返回一个HttpResponse 对象，包含请求页面的内容，或抛出HTTP 404 异常。

视图可以读取数据库数据，可以使用Django带的模板，也可以使用第三方模板，还可以输出PDF,XML,ZIP等。

为了方便，我们用DJANGO自己的数据库API根据发布时间显示5挑问卷，用逗号分开

 

1. from mysite.polls.models import Poll
2. from django.http import HttpResponse
4. def index(request):
5.     latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]
6.     output = ', '.join([p.question for p in latest_poll_list])
7.     return HttpResponse(output)

有个问题，如果页面比较复杂，这里用python编写html会很麻烦，那么我们可以使用django的模板来解决。

 

1. from django.template import Context, loader
2. from mysite.polls.models import Poll
3. from django.http import HttpResponse
5. def index(request):
6.     latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]
7.     t = loader.get_template('polls/index.html')
8.     c = Context({
9.         'latest_poll_list': latest_poll_list,
10.     })
11.     return HttpResponse(t.render(c))

程序会调用"polls/index.html"模板，同时会传入一个字典到给模板，刷新页面你会看到下面输出

 

TemplateDoesNotExist at /polls/
polls/index.html

 

提示没有这个模板文件，我们编辑 TEMPLATE_DIRS 在 settings.py 文件中，设置模板目录，在"[template_directory]/polls/index.html" 位置添加模板文件，代码入校

 

1. {% if latest_poll_list %}
2.     <ul>
3.     {% for poll in latest_poll_list %}
4.         <li>{{ poll.question }}</li>
5.     {% endfor %}
6.     </ul>
7. {% else %}
8.     <p>No polls are available.</p>
9. {% endif %}

 

一个快捷方法: render_to_response()

 

1. from django.shortcuts import render_to_response
2. from mysite.polls.models import Poll
4. def index(request):
5.     latest_poll_list = Poll.objects.all().order_by('-pub_date')[:5]
6.     return render_to_response('polls/index.html', 'latest_poll_list': latest_poll_list})

 

抛出404

 

投票详细内容视图

 

1. from django.http import Http404
2. # ...
3. def detail(request, poll_id):
4.     try:
5.         p = Poll.objects.get(pk=poll_id)
6.     except Poll.DoesNotExist:
7.         raise Http404
8.     return render_to_response('polls/detail.html', {'poll': p})

 

如果请求的投票ID 不存在，就会升级404 异常

 

快捷函数 get_object_or_404()

 

1. from django.shortcuts import render_to_response, get_object_or_404
2. # ...
3. def detail(request, poll_id):
4.     p = get_object_or_404(Poll, pk=poll_id)
5.     return render_to_response('polls/detail.html', {'poll': p})

 

同样还有一个 get_list_or_404() 函数

 

使用模板系统

 

回到投票detail()视图，在模板路径建立"polls/detail.html" 文件

 

1. <h1>{{ poll.question }}</h1>
2. <ul>
3. {% for choice in poll.choice_set.all %}
4.     <li>{{ choice.choice }}</li>
5. {% endfor %}
6. </ul>

 

 

{{ poll.question }}是用点语法访问变量的属性或者字典的KEY，{% for %}是模板脚本的循环，poll.choice_set.all 投票选项的所有记录。

 

简化URLconfs

 

1. urlpatterns = patterns('',
2.     (r'^polls/$', 'mysite.polls.views.index'),
3.     (r'^polls/(?P<poll_id>\d+)/$', 'mysite.polls.views.detail'),
4.     (r'^polls/(?P<poll_id>\d+)/results/$', 'mysite.polls.views.results'),
5.     (r'^polls/(?P<poll_id>\d+)/vote/$', 'mysite.polls.views.vote'),
6. )

视图函数部分都是完整的名称，我们可以简化下配置：

 

1. urlpatterns = patterns('mysite.polls.views',
2.     (r'^polls/$', 'index'),
3.     (r'^polls/(?P<poll_id>\d+)/$', 'detail'),
4.     (r'^polls/(?P<poll_id>\d+)/results/$', 'results'),
5.     (r'^polls/(?P<poll_id>\d+)/vote/$', 'vote'),
6. )

mysite.polls.views 提取出来，这样URL配置更简化了些。

 

解耦URLconfs

 

URLs 可以分多个文件模块配置，通过include包含进来。

(r'^polls/', include('mysite.polls.urls')),
polls/相关的请求就会到mysite/polls/urls.py查找匹配

 

mysite/polls/urls.py如下：

 

 

 

1. urlpatterns = patterns('mysite.polls.views',
2.     (r'^$', 'index'),
3.     (r'^(?P<poll_id>\d+)/$', 'detail'),
4.     (r'^(?P<poll_id>\d+)/results/$', 'results'),
5.     (r'^(?P<poll_id>\d+)/vote/$', 'vote'),
6. )

去掉了polls/部分