Django 中的视图的概念是「一类具有相同功能和模板的网页的集合」。比如,在一个博客应用中,你可能会创建如下几个视图:

    • 博客首页——展示最近的几项内容。
    • 内容“详情”页——详细展示某项内容。
    • 以年为单位的归档页——展示选中的年份里各个月份创建的内容。
    • 以月为单位的归档页——展示选中的月份里各天创建的内容。
    • 以天为单位的归档页——展示选中天里创建的所有内容。
    • 评论处理器——用于响应为一项内容添加评论的操作。

    而在我们的投票应用中,我们需要下列几个视图:

    • 问题索引页——展示最近的几个投票问题。
    • 问题详情页——展示某个投票的问题和不带结果的选项列表。
    • 问题结果页——展示某个投票的结果。
    • 投票处理器——用于响应用户为某个问题的特定选项投票的操作。

    在 Django 中,网页和其他内容都是从视图派生而来。每一个视图表现为一个 Python 函数(或者说方法,如果是在基于类的视图里的话)。Django 将会根据用户请求的 URL 来选择使用哪个视图(更准确的说,是根据 URL 中域名之后的部分)。


    polls/views.py里添加更多视图。这些视图有一些不同,因为他们接收参数

    1. def detail(request, question_id):
    2. return HttpResponse("You're looking at question %s." % question_id)
    3. def results(request, question_id):
    4. response = "You're looking at the results of question %s."
    5. return HttpResponse(response % question_id)
    6. def vote(request, question_id):
    7. return HttpResponse("You're voting on question %s." % question_id)

    之后再在polls/urls.py文件里面加入这些新视图

    1. from django.urls import path
    2. from . import views
    3. urlpatterns = [
    4. # ex: /polls/
    5. path('', views.index, name='index'),
    6. # ex: /polls/5/
    7. path('<int:question_id>/', views.detail, name='detail'),
    8. # ex: /polls/5/results/
    9. path('<int:question_id>/results/', views.results, name='results'),
    10. # ex: /polls/5/vote/
    11. path('<int:question_id>/vote/', views.vote, name='vote'),
    12. ]

    然后看看你的浏览器,如果你转到 “/polls/34/“ ,Django 将会运行 detail() 方法并且展示你在 URL 里提供的问题 ID。再试试 “/polls/34/vote/“ 和 “/polls/34/vote/“ ——你将会看到暂时用于占位的结果和投票页。


    写一个真正有用的视图
    每个视图必须要做的只有两件事:返回一个包含被请求页面内容的 HttpResponse 对象,或者抛出一个异常,比如 Http404
    因为 Django 自带的数据库 API 很方便,我们曾在 教程第 2 部分 中学过,所以我们试试在视图里使用它。我们在 index() 函数里插入了一些新内容,让它能展示数据库里以发布日期排序的最近 5 个投票问题,以空格分割:

    1. from django.http import HttpResponse
    2. from .models import Question
    3. def index(request):
    4. latest_question_list = Question.objects.order_by('-pub_date')[:5]
    5. output = ', '.join([q.question_text for q in latest_question_list])
    6. return HttpResponse(output)
    7. # Leave the rest of the views (detail, results, vote) unchanged

    这里有个问题:页面的设计写死在视图函数的代码里的。如果你想改变页面的样子,你需要编辑 Python 代码。所以让我们使用 Django 的模板系统,只要创建一个视图,就可以将页面的设计从代码中分离出来。
    首先,在你的 polls 目录里创建一个 templates 目录。Django 将会在这个目录里查找模板文件。
    在你刚刚创建的 templates 目录里,再创建一个目录 polls,然后在其中新建一个文件 index.html 。换句话说,你的模板文件的路径应该是 polls/templates/polls/index.html 。因为app_directories 模板加载器是通过上述描述的方法运行的,所以Django可以引用到 polls/index.html 这一模板了。
    将代码输入刚刚创建的index.html文件中

    1. {% if latest_question_list %}
    2. <ul>
    3. {% for question in latest_question_list %}
    4. <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
    5. {% endfor %}
    6. </ul>
    7. {% else %}
    8. <p>No polls are available.</p>
    9. {% endif %}

    然后,让我们更新一下 polls/views.py 里的 index 视图来使用模板

    1. from django.http import HttpResponse
    2. from django.template import loader
    3. from .models import Question
    4. def index(request):
    5. latest_question_list = Question.objects.order_by('-pub_date')[:5]
    6. template = loader.get_template('polls/index.html')
    7. context = {
    8. 'latest_question_list': latest_question_list,
    9. }
    10. return HttpResponse(template.render(context, request))

    上述代码的作用是,载入 polls/index.html 模板文件,并且向它传递一个上下文(context)。这个上下文是一个字典,它将模板内的变量映射为 Python 对象。


    一个快捷函数render()
    「载入模板,填充上下文,再返回由它生成的 HttpResponse 对象」是一个非常常用的操作流程。于是 Django 提供了一个快捷函数,我们用它来重写 index() 视图:

    1. from django.shortcuts import render
    2. from .models import Question
    3. def index(request):
    4. latest_question_list = Question.objects.order_by('-pub_date')[:5]
    5. context = {'latest_question_list': latest_question_list}
    6. return render(request, 'polls/index.html', context)

    注意到,我们不再需要导入 loaderHttpResponse 。不过如果你还有其他函数(比如说 detail, results, 和 vote )需要用到它的话,就需要保持 HttpResponse 的导入。


    抛出 404 错误
    现在,我们来处理投票详情视图——它会显示指定投票的问题标题。下面是这个视图的代码:

    1. from django.http import Http404
    2. from django.shortcuts import render
    3. from .models import Question
    4. # ...
    5. def detail(request, question_id):
    6. try:
    7. question = Question.objects.get(pk=question_id)
    8. except Question.DoesNotExist:
    9. raise Http404("Question does not exist")
    10. return render(request, 'polls/detail.html', {'question': question})

    这里有个新原则。如果指定问题 ID 所对应的问题不存在,这个视图就会抛出一个 Http404 异常。
    我们稍后再讨论你需要在 polls/detail.html 里输入什么,但是如果你想试试上面这段代码是否正常工作的话,你可以暂时把下面这段输进去

    1. {{ question }}

    这样你就能测试了。


    一个快捷函数: get_object_or_404()
    尝试用 get() 函数获取一个对象,如果不存在就抛出 Http404 错误也是一个普遍的流程。Django 也提供了一个快捷函数,下面是修改后的详情 detail() 视图代码

    1. from django.shortcuts import get_object_or_404, render
    2. from .models import Question
    3. # ...
    4. def detail(request, question_id):
    5. question = get_object_or_404(Question, pk=question_id)
    6. return render(request, 'polls/detail.html', {'question': question})

    使用模板系统
    回过头去看看我们的 detail() 视图。它向模板传递了上下文变量 question 。下面是 polls/detail.html 模板里正式的代码:

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

    模板系统统一使用点符号来访问变量的属性。在示例 {{ question.question_text }} 中,首先 Django 尝试对 question 对象使用字典查找(也就是使用 obj.get(str) 操作),如果失败了就尝试属性查找(也就是 obj.str 操作),结果是成功了。如果这一操作也失败的话,将会尝试列表查找(也就是 obj[int] 操作)。
    {% for %} 循环中发生的函数调用:question.choice_set.all 被解释为 Python 代码 question.choice_set.all() ,将会返回一个可迭代的 Choice 对象,这一对象可以在 {% for %} 标签内部使用。


    去除模板中的硬编码 URL
    还记得吗,我们在 polls/index.html 里编写投票链接时,链接是硬编码的:

  • {{ question.question_text }}

  • 问题在于,硬编码和强耦合的链接,对于一个包含很多应用的项目来说,修改起来是十分困难的。然而,因为你在 polls.urlsurl() 函数中通过 name 参数为 URL 定义了名字,你可以使用 {% url %} 标签代替它:
  • {{ question.question_text }}

  • 这个标签的工作方式是在 polls.urls 模块的 URL 定义中寻具有指定名字的条目。你可以回忆一下,具有名字 ‘detail’ 的 URL 是在如下语句中定义的:
    path(‘/‘, views.detail, name=’detail’),
    如果你想改变投票详情视图的 URL,比如想改成 polls/specifics/12/ ,你不用在模板里修改任何东西(包括其它模板),只要在 polls/urls.py 里稍微修改一下就行:
    path(‘specifics//‘, views.detail, name=’detail’),


    为 URL 名称添加命名空间
    教程项目只有一个应用,polls 。在一个真实的 Django 项目中,可能会有五个,十个,二十个,甚至更多应用。Django 如何分辨重名的 URL 呢?举个例子,polls 应用有 detail 视图,可能另一个博客应用也有同名的视图。Django 如何知道 {% url %} 标签到底对应哪一个应用的 URL 呢?
    答案是:在根 URLconf 中添加命名空间。在 polls/urls.py 文件中稍作修改,加上 app_name 设置命名空间:

    1. from django.urls import path
    2. from . import views
    3. app_name = 'polls'
    4. urlpatterns = [
    5. path('', views.index, name='index'),
    6. path('<int:question_id>/', views.detail, name='detail'),
    7. path('<int:question_id>/results/', views.results, name='results'),
    8. path('<int:question_id>/vote/', views.vote, name='vote'),
    9. ]

    现在,编辑 polls/index.html 文件,从:

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

    修改为:

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