Part 3：视图和模板--Django从入门到精通系列教程

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

该系列教程系个人原创，并完整发布在个人官网刘江的博客和教程

所有转载本文者，需在顶部显著位置注明原作者及www.liujiangblog.com官网地址。

一、概述

一个视图就是一个页面，通常提供特定的功能，使用特定的模板。例如：在一个博客应用中，你可能会看到下列视图：

博客主页：显示最新发布的一些内容
每篇博客的详细页面：博客的永久链接
基于年的博客页面：显示指定年内的所有博客文章
基于月的博客页面：显示指定月内的所有博客文章
基于天的博客页面：显示指定日内的所有博客文章
发布评论：处理针对某篇博客发布的评论

在我们的投票应用中，我们将建立下面的视图：

问卷“index”页：显示最新的一些问卷
问卷“detail”页面：显示一个问卷的详细文本内容，没有调查结果但是有一个投票或调查表单。
问卷“results”页面：显示某个问卷的投票或调查结果。
投票动作页面：处理针对某个问卷的某个选项的投票动作。

在Django中，网页和其它的一些内容都是通过视图来处理的。视图其实就是一个简单的Python函数（在基于类的视图中称为方法）。Django通过对比请求的URL地址来选择对应的视图。

二、编写视图

下面，打开 polls/views.py 文件，输入下列代码：

def detail(request, question_id):

    return HttpResponse("You're looking at question %s." % question_id)

def results(request, question_id):

    response = "You're looking at the results of question %s."

    return HttpResponse(response % question_id)

def vote(request, question_id):

    return HttpResponse("You're voting on question %s." % question_id)

然后，在 polls/urls.py 文件中加入下面的url模式，将其映射到我们上面新增的视图。

from django.conf.urls import url

from . import views

urlpatterns = [

    # ex: /polls/

    url(r'^$', views.index, name='index'),

    # ex: /polls/5/

    url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),

    # ex: /polls/5/results/

    url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'),

    # ex: /polls/5/vote/

    url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),

]

现在去浏览器中访问 /polls/34/ （注意：这里省略了域名。另外，使用了二级路由后，url中都要添加polls部分，参考前面的章节），它将调用 detail() 函数，然后在页面中显示你在url里提供的ID。访问 /polls/34/results/ 和 /polls/34/vote/ ，将分别显示预定义的伪结果和投票页面。(PS:这里就不贴图了，请大家务必自己动手测试，多实践。）

上面访问的路由过程如下：当有人访问 /polls/34/ 地址时，Django将首先加载 mysite.urls 模块，因为它是settings文件里设置的根URL配置文件。在该文件里，Django发现了 urlpatterns 变量，于是在其内按顺序进行匹配。当它匹配上了 ^polls/ ，就裁去url中匹配的文本 polls/ ，然后将剩下的文本“34/”，传递给 polls.urls 进行下一步的处理。在 polls.urls 中，又匹配到了 r’^(?P<question_id>[0-9]+)/$’ ，最终结果就是调用该模式对应的detail()视图，也就是下面的函数：

detail(request=<HttpRequest object>, question_id='34')

函数中的 question_id=’34’ 参数，是由 (?P<question_id>[0-9]+) 而来。在正则表达式中通过一个双圆括号，Django会捕获它匹配到的值并传递给对应的视图，作为视图的位置参数之一，而 ?P<question_id> 则表示我要给这个捕获的值指定一个特殊的变量名，在视图中可以通过 question_id 这个变量名随意的引用它，形成一个关键字参数，不用考虑参数的位置。至于 [0-9]+ 则是一个很简单的原生正则表达式，用于匹配一系列连续的数字，它匹配到的值也就是具体要传递的参数值。

所有的URL模式都是正则表达式，Django不限制你在url模式中的书写方式。但是，你真的没必要书写一个如下的较为愚蠢的包含 .html 的模式，它显然是没必要，不够简练的：

url(r'^polls/latest\.html$', views.index),

你完全可以用下面的模式代替上面的：

url(r'^polls/latest$', views.index),

三、编写能实际干点活的视图

每个视图至少做两件事之一：返回一个包含请求页面的HttpResponse对象或者弹出一个类似Http404的异常。其它的则随你便，你爱干嘛干嘛。

下面是一个新的index()视图，用于替代先前无用的index，它会根据发布日期显示最近的5个投票问卷。

from django.http import HttpResponse

from .models import Question

def index(request):

    latest_question_list = Question.objects.order_by('-pub_date')[:5]

    output = ', '.join([q.question_text for q in latest_question_list])

    return HttpResponse(output)

# 下面是那些没改动过的视图(detail, results, vote)

这里有个非常重要的问题：在当前视图中的HTML页面是硬编码的。 如果你想改变页面的显示内容，就必须修改这里的Python代码。为了解决这个问题，需要使用Django提供的模板系统，解耦视图和模板之间的硬连接。

首先，在polls目录下创建一个新的 templates 目录，Django会在它里面查找模板文件。在templates目录中，再创建一个新的子目录名叫 polls ，进入该子目录，创建一个新的html文件 index.html 。换句话说，你的模板文件应该是 polls/templates/polls/index.html 。可以在DJango中直接使用 polls/index.html 引用该文件。

注意：在Pycharm中，templates文件夹通常已经帮你创建好了！

模板命名空间：

你也许会想，为什么不把模板文件直接放在polls/templates目录下，而是费劲的再建个子目录polls呢?设想这么个情况，有另外一个app，它也有一个名叫index.html的文件，当Django在搜索模板时，有可能就找到它，然后退出搜索，这就命中了错误的目标，不是我们想要的结果。解决这个问题的最好办法就是在templates目录下再建立一个与app同名的子目录，将自己所属的模板都放到里面，从而达到独立命名空间的作用，不会再出现引用错误。

现在，将下列代码写入文件 polls/templates/polls/index.html :

{% if latest_question_list %}

    <ul>

    {% for question in latest_question_list %}

    <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>

    {% endfor %}

    </ul>

{% else %}

    <p>No polls are available.</p>

{% endif %}

同时，修改视图文件 polls/views.py ，让新的 index.html 文件生效：

from django.http import HttpResponse

from django.template import loader

from .models import Question

def index(request):

    latest_question_list = Question.objects.order_by('-pub_date')[:5]

    template = loader.get_template('polls/index.html')

    context = {

    'latest_question_list': latest_question_list,

    }

    return HttpResponse(template.render(context, request))

上面的代码会加载 polls/index.html 文件，并传递给它一个参数。这个参数是一个字典，包含了模板变量名和Python对象之间的映射关系。

在浏览器中通过访问 /polls/ ，你可以看到一个列表，包含 “What’s up” 的问卷，以及连接到其对应详细内容页面的链接点。

如果你显示的是 No polls are available. 说明你前面没有添加Questions对象。没关系，我们手动添加一下就可以。

进入admin界面，选择Questions，点击右上角的 Add question ，如下操作。

添加完后，刷新 /polls/ 页面。

快捷方式：render()

在实际运用中，加载模板、传递参数，返回HttpResponse对象是一整套再常用不过的操作了，为了节省力气，Django提供了一个快捷方式：render函数，一步到位！看如下代码：

polls/views.py

from django.shortcuts import render

from .models import Question

def index(request):

    latest_question_list = Question.objects.order_by('-pub_date')[:5]

    context = {'latest_question_list': latest_question_list}

    return render(request, 'polls/index.html', context)

render()函数的第一个位置参数是请求对象（就是view函数的第一个参数），第二个位置参数是模板。还可以有一个可选的第三参数，一个字典，包含需要传递给模板的数据。最后render函数返回一个经过字典数据渲染过的模板封装而成的HttpResponse对象。

四、返回404错误

现在让我们来编写返回具体问卷文本内容的视图 polls/views.py ：

from django.http import Http404

from django.shortcuts import render

from .models import Question

# ...

def detail(request, question_id):

    try:

        question = Question.objects.get(pk=question_id)

    except Question.DoesNotExist:

        raise Http404("Question does not exist")

    return render(request, 'polls/detail.html', {'question': question})

这里有个新知识点，如果请求的问卷ID不存在，那么会弹出一个Http404错误。

新建 polls/detail.html 文件，暂时写入下面的代码：

{{ question }}

快捷方式：get_object_or_404()

就像render函数一样，Django同样为你提供了一个偷懒的方式，替代上面的多行代码，那就是 get_object_or_404() 方法，参考下面的代码：

polls/views.py

from django.shortcuts import get_object_or_404, render

from .models import Question

# ...

def detail(request, question_id):

    question = get_object_or_404(Question, pk=question_id)

    return render(request, 'polls/detail.html', {'question': question})

别说我没提醒你，和render一样，也需要从Django内置的快捷方式模块中导出 get_object_or_404() ！

get_object_or_404() 方法将一个Django模型作为第一个位置参数，后面可以跟上任意个数的关键字参数，如果对象不存在则弹出Http404错误。

同样，还有一个 get_list_or_404() 方法，和上面的 get_object_or_404() 类似，只不过是用来替代 filter() 函数，当查询列表为空时弹出404错误。（filter是模型API中用来过滤查询结果的函数，它的结果是一个列表集。而get则是查询一个结果的方法，和filter是一个和多个的区别！）

五、使用模板系统

detail() 视图会将上下文变量question传递给对应的 polls/templates/polls/detail.html 模板，修改该模板的内容，如下所示：

<h1>{{ question.question_text }}</h1>

<ul>

{% for choice in question.choice_set.all %}

    <li>{{ choice.choice_text }}</li>

{% endfor %}

</ul>

在模板系统中圆点 . 是万能的魔法师，你可以用它访问对象的属性。在例子 {{ question.question_text }} 中，DJango首先会在question对象中尝试查找一个字典，如果失败，则尝试查找属性，如果再失败，则尝试作为列表的索引进行查询。

在 {% for %} 循环中的方法调用—— poll.choice_set.all 其实就是Python的代码 poll.choice_set.all() ,它将返回一组可迭代的 Choice 对象，并用在 {% for %} 标签中。

这里我们对Django模板语言有个简单的印象就好，更深入的介绍放在后面。

六、删除模板中硬编码的URLs

在 polls/index.html 文件中，还有一部分硬编码存在，也就是href里的“/polls/”部分：

<li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>

它对于代码修改非常不利。设想如果你在urls.py文件里修改了正则表达式，那么你所有的模板中对这个url的引用都需要修改，这是无法接受的！

我们前面给urls定义了一个name别名，可以用它来解决这个问题。具体代码如下：

<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>

Django会在 polls.urls 文件中查找 name='detail' 的url，具体的就是下面这行：

url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),

举个栗子，如果你想将polls的detail视图的URL更换为 polls/specifics/12/ ，那么你不需要在模板中重新修改url地址了，仅仅只需要在 polls/urls.py 文件中，将对应的正则表达式改成下面这样的就行了，所有模板中对它的引用都会自动修改成新的链接：

# 添加新的单词'specifics'

url(r'^specifics/(?P<question_id>[0-9]+)/$', views.detail, name='detail'),

七、URL names的命名空间

本教程例子中，只有一个app也就是polls，但是在现实中很显然会有5个、10个、更多的app同时存在一个项目中。Django是如何区分这些app之间的URL name呢？

答案是使用URLconf的命名空间。在polls/urls.py文件的开头部分，添加一个 app_name 的变量来指定该应用的命名空间：

from django.conf.urls import url

from . import views

app_name = 'polls'  # 关键是这行

urlpatterns = [

    url(r'^$', views.index, name='index'),

    url(r'^(?P<question_id>[0-9]+)/$', views.detail, name='detail'),

    url(r'^(?P<question_id>[0-9]+)/results/$', views.results, name='results'),

    url(r'^(?P<question_id>[0-9]+)/vote/$', views.vote, name='vote'),

]

现在，让我们将代码修改得更严谨一点，将 polls/templates/polls/index.html 中的

<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>

修改为：

<li><a href="{% url 'polls:detail' question.id %}">{{ question.question_text }}</a></li>

注意引用方法是冒号而不是圆点也不是斜杠！！！！！！！！！！！！

正文

该系列教程系个人原创，并完整发布在个人官网刘江的博客和教程

所有转载本文者，需在顶部显著位置注明原作者及www.liujiangblog.com官网地址。

一、概述

二、编写视图

三、编写能实际干点活的视图

注意：在Pycharm中，templates文件夹通常已经帮你创建好了！

四、返回404错误

五、使用模板系统

六、删除模板中硬编码的URLs

七、URL names的命名空间

相关阅读

go语言gpu，go语言入门

macos入门，macOS实用技巧

hbase中的四维坐标，hbase入门与实践

零基础入门python爬虫，零基础Python爬虫第一课

学习delphi需要什么c语言，delphi入门与提高实用教程

架构设计入门书籍，架构书籍推荐知乎

python爬虫入门进阶，python爬虫快速入门

go语言教程菜鸟学堂，go语言从入门到进阶实战 pdf

目录[+]

该系列教程系个人原创，并完整发布在个人官网刘江的博客和教程

所有转载本文者，需在顶部显著位置注明原作者及www.liujiangblog.com官网地址。

一、概述

二、编写视图

三、编写能实际干点活的视图

注意：在Pycharm中，templates文件夹通常已经帮你创建好了！

四、返回404错误

五、 使用模板系统

六、删除模板中硬编码的URLs

七、URL names的命名空间

相关阅读

go语言gpu，go语言入门

macos入门，macOS实用技巧

hbase中的四维坐标，hbase入门与实践

零基础入门python爬虫，零基础Python爬虫第一课

学习delphi需要什么c语言，delphi入门与提高实用教程

架构设计入门书籍，架构书籍推荐 知乎

python爬虫入门进阶，python爬虫快速入门

go语言教程菜鸟学堂，go语言从入门到进阶实战 pdf

目录[+]

五、使用模板系统

架构设计入门书籍，架构书籍推荐知乎