Django 2.0.1 官方文档翻译: 编写你的第一个 Django app，第三部分（Page 8）

编写你的第一个 Django app，第三部分（Page 8）转载请注明链接地址

本页教程接前面的第二部分。我们继续开发 web-poll app，我们会专注于创建公共接口上 —— “视图”。

概述

在你的 Django app中，视图是一个 web 页面的类型，一般服务于一个特定的函数，并拥有一个特定的模板（template）。例如：在 blog app中，你可能有下面这些视图：

Blog homepage – 显示少量最新的条目
Entry “detail” page – 一个独立的永久链接入口
Year-based archive page – 显示指定年份中所有月份的入口
Month-based archive page – 显示指定月份所以天的的入口
Day-based archive page – 显示指定天的所有入口
Comment action – 处理给定条目提交的评论

在我们的 poll app中，我们会用到下面四个视图

Question “index” page – 显示一些最新的问题
Question “detail” page – 显示一个问题的内容，有一个用于投票的表单但没有结果
Question “results” page – 显示特定问题的结果
Vote action – 处理特定问题中特定选择的投票操作

在 Django 中，web 页面和其他内容被视图投递，每一个视图相当于一个简单的 Python 函数（或在基于类的视图中是方法）。Django 会检查被请求的 URL 来选择一个视图（确切的讲，是URL 中域名之后的部分）。

你在网络中可能遇到过类似“ME2/Sites/dirmod.asp?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B”这样的URL。你会很高兴的知道 Django 允许比它更优雅的 URL 模式。
URL 模式只是 URL 的一般形式，—— 例如 /newsarchive/<year>/<month>/.
从一个 URL 中获取一个视图，Django 使用我们学过的 “URLconf”。 URLconf 映射 URL 到视图。
本教程提供了使用 URLconfs 的基本指令，你可以在 URL dispatcher（这里少一个链接）中了解更多信息。

编写更多的视图

现在让我们在 polls/views.py 中在多添加一些视图，这些视图会有些许的不同，他们都接收一个同样的参数：

# 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)

通过在 path()添加下面的调用，将这些新视图链接到 polls.urls模块：

# polls/urls.py
from django.urls import path

from . import views

urlpatterns = [
    # ex: /polls/
    path('', views.index, name='index'),
    # ex: /polls/5/
    path('<int:question_id>/', views.detail, name='detail'),
    # ex: /polls/5/results/
    path('<int:question_id>/results/', views.results, name='results'),
    # ex: /polls/5/vote/
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

现在在浏览器中访问一下 “/polls/34/”，它运行的是 detail()方法，显示了你在 URL 中提供的ID，再试着访问一下“/polls/34/results/” 和 “/polls/34/vote/” —— 这会显示占位符的结果（占位符的结果：the placeholder results，没理解这个的意思）和投票页。
当有人在你的站点请求一个页面时 —— “/polls/34/” ，django 会加载mysite.urls 模块，因为它在 ROOT_URLCONF 的配置中被设置。他会找到名为 urlpatterns的变量并按顺序遍历模式。当找到匹配的 “polls/”后，它会去掉匹配的文本（“polls/”）并发送文本——“34/”——到“polls.urls” URLconf,以便后续处理。这里匹配到 '<int:question_id>/'，因此去调用 detail()视图，就像下面一样：

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

question_id=34这一部分来自 <int:question_id>。使用尖括号捕获 URL 的一部分，并将其作为关键字参数发送费视图函数。字符串的部分:question_id>用于定义名称，它会被用于识别匹配的模式；<int:这一部分是一个转换器，它决定 URL 路径中的这一部分应该匹配什么模式。

不需要在 URL 中添加如“.html”一类的东西 —— 除非你想添加，这时你可以这样做：

path('polls/latest.html', views.index),

但是不要这样，这看起来太蠢了。

编写可以搞事情的视图

搞事情 == actually do something。
每一个视图负责做两件事情：返回一个包行请求页面内容的 HttpResponse（这里少一个链接）对象，或者报告一个例如 Http404 的异常。剩下的就看你了。
你的视图可以从数据库中读取记录，或者不读。它可以使用一个模板系统，例如 Django 的或者第三方的 Python 模板系统，或者不使用。它可以使用你想用的 Python 库生成一个 PDF 文件、输出 XML、实时创建一个 ZIP 文件、任何你想创建的。

Django 想要的是一个 HttpResponse（这里少一个链接）或者一个异常。
因为这样很方便，让我们使用我们在前一节提到的 Django 自己的数据库 API。在 index()视图有一行新增的内容，它显示系统中最新的5个投票问题，根据发布日期使用都好分开。

# polls/views.py
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)

# Leave the rest of the views (detail, results, vote) unchanged

但这里会有一个问题：页面的设计（样式、外观）是被硬编码在视图中的，如果你想要更改页面的外观，你就必须编辑这些 Python 代码。所以我们可以在Django 的末班系统中创建一个视图可以使用的模板，将设计（外观、样式）从Python 中分离出来。
首先，在你的 polls 目录中创建一个名为 templates的目录。Django 会从它里面查找模板。
你的项目的 TEMPLATES（这里少一个链接）设置用来告诉 Django 如何加载和渲染模板。默认配置文件设置一个DjangoTemplates后端，其 APP_DIRS选项被设置为 True。按照惯例，DjangoTemplates会在每个INSTALLED_APPS（这里少一个链接）的子目录中查找模板。

在刚刚创建的 templates 目录中，创建另外一个叫 polls 的目录，并在里面创建 indexl.html文件。换句话说，你的模板应该放在polls/templates/polls/index.html。因为 app_directories模板加载器的工作方式和上面说的一样，你可以引用这个模板就像 django 引用polls/index.html一样。

模板命名空间
现在我们可以直接将模板放入 polls/templates 中(而不是创建另外一个 polls 的子目录)，但其实这并不是一个好主意。Django 会选择他找到的第一个名字匹配的模板，并且如果你的不同的app中有相同名字的模板，Django 会无法区分他们。我们需要 django 指向正确的那一个，最简单的方法就是通过命名空间来保证它正确。也就是说，将这些模板放入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 视图。

polls/views.py
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”问题的列表。链接指向问题的详细页面。

快捷方式：render()

加载模板的一个常用习惯是，填充上下文并返回一个以渲染后的模板为结果的 HttpResponse（这里少一个链接）对象。Django 提供一种便捷方法。下面是重写后的完整的 index()视图：

# 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)

注意，一旦我们在所有的视图中都这么做了，我就不在需要导入 loader（这里少一个链接）和 HttpResponse这里少一个链接）（如果你没有修改之前的detail、results和 vote方法，你将需要保留 HttpResponse）

render()函数第一个参数是一个 request 对象，第二个参数是一个模板的名字，第三个参数是可选的，是一个字典。它返回一个使用给定上下文渲染模板后返回的 HttpResponse 对象。

引发一个404错误

现在我们来处理问题的 detail 视图 —— 显示给定投票的问题文本的页面。下面是视图的代码：

# 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中存放什么内容，但如果你想要快速得到和上面例子一样的效果，仅仅需要一个包含：

<!-- polls/templates/polls/detail.html -->
{{ question }}

的文件就可以让你做到。

快捷方式： get_object_or_404()

一个常见的习惯是使用 get()(这里少一个链接)获取对象，如果对象不存在的时候则引发 Http404错误。Django 提供一个便捷方法。下面是重写后的 detail()视图：

# 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})

get_object_or_404(这里少一个链接)函数的将一个 Django 模型作为第一个参数，后跟任意数量的关键字参数，并将其传递给模型管理器的 get()（这里少一个链接）函数。如果对象不逊在会引发一个 Http404 (这里少一个链接)。

设计哲学
为什么我们要使用辅助性函数 get_object_or_404()（这里少一个链接）来而不是在更高层自动捕捉 ObjectDoesNotExist 异常，或是使模型API引发 Http404（这里少一个链接）来替代ObjectDoesNotExist 。
这是为了让模型层和视图层耦合。django 最重要的一个设计就是保存松耦合。一些可控的耦合会在 django.shortcuts（这里少一个链接）模块中介绍。

还有一个 get_list_or_404()（这里少一个链接）函数，它的工作方式类似get_object_or_404()(这里少一个链接) —— 除了用 filter()(这里少一个链接) 替带了 get()(这里少一个链接)。如果列表是空的，它会引发 Http404(这里少一个链接)

使用模板系统

返回我们 poll app中的 detail() 视。给定context 变量 question，polls/detail.html 看起来的样子可能像下面一样：

<!--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 对象上进行字典查询，如果失败，它会再尝试查找属性 —— 在这里的例子中，属性查找会成功，如果属性查找失败，Django会再尝试进行索引列表查询。

在 {% for %}（这里少一个链接）中发生的方法调用：question.choice_set.all 被解释成 python 代码中的 question.choice_set.all()，他会返回一个可迭代的 Choice 对象，并且适用于{% for %}（这里少一个链接）标签。

查看模板指南了解更多管理模板的内容（这里少一个链接）

移除模板中硬编码的 URLs

请牢记，在我们在polls/index.html中编写一个question的链接的时候，链接的一部分是像下面一样硬编码的：

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

硬编码的问题是，在项目中有许多模板要修改 URLs 的时候，会变得很困难。然而，你在 polls.urls 模块的 path()函数中定义了 name 参数，这样你就可以通过使用{% url %}模板标签，在你的 url 配置中移除对特定 URL 路径的依赖。

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

它的工作原理是通过在 polls.urls 模块中查找指定的 URL 定义。你可以看到“detail”的 URL 名称在下面被定义：

...
# the 'name' value as called by the {% url %} template tag
path('<int:question_id>/', views.detail, name='detail'),
...

如果你想要修改 polls中 detail 的 URL 修改成其他的样子，可能就像polls/specifics/12/，你可以在 polls/urls.py中完成修改，而不需要去修改模板：

...
# added the word 'specifics'
path('specifics/<int:question_id>/', views.detail, name='detail'),
...

命名空间的 URL 名字

教程中的项目只有一个app——polls。在实际的 django 项目中，可能会有5个、10个、20个或更多个。Django 是如何区分他们的 URL 名字的呢？例如 polls app有一个 detail视图，该项目下还有一个 blog app也有一个相同的视图。当使用{% url %}标签时，如何让 Django 知道为 url 调用那个app的视图？

答案是在URLconf 中添加一个命名空间。在 polls/urls.py文件中，添加一个app名来设置app的命名空间。

# polls/urls.py
from django.urls import path

from . import views

app_name = 'polls'
urlpatterns = [
    path('', views.index, name='index'),
    path('<int:question_id>/', views.detail, name='detail'),
    path('<int:question_id>/results/', views.results, name='results'),
    path('<int:question_id>/vote/', views.vote, name='vote'),
]

现在修改你的 polls/index.html 模板，讲下面的内容：

<!--polls/templates/polls/index.html-->
<li><a href="{% url 'detail' question.id %}">{{ question.question_text }}</a></li>

修改成有命名空间的 detail 视图：

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

当你熟悉了编写视图，就可以继续学习下一节的内容了，学习简单的表单处理和通用视图。