Django快速入门——投票程序(3)视图

Python
109
0
0
2024-01-06
Django快速入门——投票程序(7) 自定义后台
上一篇
Django快速入门——投票程序(1、2)创建项目&模型
下一篇
标签   Django

第3部分（视图）

视图概念

原教程说的比较抽象，这里简单认为视图就是views.py中的函数，用于处理数据并渲染网页。我们的投票应用中，需要下列几个视图：

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

Django将会根据用户请求的URL来选择使用哪个视图。为了将URL和视图关联起来，Django使用了URLconfs将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和视图的映射：

#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/ ，Django 将会调用detail()函数并且展示你在URL里提供的问题ID。再试试 /polls/34/results/和 /polls/34/vote/——你将会看到暂时用于占位的结果和投票页。

当用户在你的网站上请求一个页面，如/polls/34/，Django会加载mysite.urls模块（因为这是 ROOT_URLCONF的设置）。Django会查找变量urlpatterns并遍历其中的模式。当Django找到了匹配的模式polls/，Django会分离匹配的文字polls/并发送剩余的文字34/到polls.urls进一步处理。然后在polls.urls中匹配到<int:question_id>/，调用对应的函数detail,调用的形式类似detail(request=<HttpRequest object>, question_id=34)。

参数question_id=34 来自 <int:question_id>。使用尖括号获得网址部分后作为一个关键字参数发送给视图函数。 question_id 定义了参数名称，而int是一种转换形式，用来确定应该匹配网址路径的什么模式（这里使用int表示整数，另一个常用的是str表示字符串）。冒号 (:) 将两者分隔。

更多关于匹配URL的内容，参考URL调度器：https://docs.djangoproject.com/zh-hans/4.2/topics/http/urls/

写一个真正有用的视图

视图函数返回值为HttpResponse对象或一个异常（如HTTP404）。函数的其它部分（如处理数据）由你决定。

我们修改了index函数，获取数据库中最近5个问题并显示。

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)

这里有个问题：页面的设计写死在视图函数的代码里的。如果你想改变页面的样子，你需要编辑 Python 代码。所以让我们使用 Django 的模板系统，只要创建一个视图，就可以将页面的设计从代码中分离出来。

首先，在你的polls目录里创建一个 templates目录。Django将会在这个目录里查找模板文件。

项目的TEMPLATES配置项描述了Django 如何载入和渲染模板。默认的设置文件设置了 DjangoTemplates后端，并将APP_DIRS设置成了True。这一选项将会让 DjangoTemplates在每个 INSTALLED_APPS文件夹中寻找 "templates"子目录。这就是为什么尽管我们没有像在第二部分中那样修改 DIRS 设置，Django 也能正确找到 polls 的模板位置的原因。

在你刚刚创建的templates目录下，再创建一个目录polls，然后在其中新建一个文件index.html 。换句话说，你的模板文件的路径应该是polls/templates/polls/index.html。因为app_directories 模板加载器是通过上述描述的方法运行的，所以Django可以引用到polls/index.html这一模板了。

模板命名空间 虽然我们现在可以将模板文件直接放在 polls/templates 文件夹中（而不是再建立一个 polls 子文件夹），但是这样做不太好。Django 将会选择第一个匹配的模板文件，如果你有一个模板文件正好和另一个应用中的某个模板文件重名，Django 没有办法 区分 它们。我们需要帮助 Django 选择正确的模板，最好的方法就是把他们放入各自的 命名空间 中，也就是把这些模板放入一个和自身应用重名的子文件夹里。

将下面的代码输入到刚刚创建的模板文件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视图来使用模板：

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模板文件，并且向它传递一个上下文(context)。这个上下文是一个字典，它将模板内的变量映射为 Python 对象。

用你的浏览器访问 "/polls/" ，你将会看见一个无序列表，列出了我们在 教程第 2 部分 中添加的投票问题，链接指向这个投票的详情页。

一个快捷函数：render()

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

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)

抛出 404 错误

现在，我们来处理投票详情视图——它会显示指定投票的问题标题。下面是这个视图的代码：

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/templates/polls/detail.html中写入：

{{ question }}

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

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_list_or_404() 函数，工作原理和 get_object_or_404() 一样，除了 get() 函数被换成了 filter() 函数。如果列表为空的话会抛出 Http404 异常。

使用模板系统

回过头去看看我们的detail()视图。它向模板传递了上下文变量 question 。下面是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 对象使用字典查找（也就是使用 obj.get(str) 操作），如果失败了就尝试属性查找（也就是 obj.str 操作），结果是成功了。如果这一操作也失败的话，将会尝试列表查找（也就是 obj[int] 操作）。

在{% for %}循环中发生的函数调用：question.choice_set.all 被解释为 Python 代码 question.choice_set.all() ，将会返回一个可迭代的 Choice 对象，这一对象可以在 {% for %} 标签内部使用。

查看 模板指南 可以了解关于模板的更多信息。

去除模板中的硬编码 URL

还记得吗，我们在polls/index.html里编写投票链接时，链接是硬编码的 <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>

问题在于，硬编码和强耦合的链接，对于一个包含很多应用的项目来说，修改起来是十分困难的。我们在polls.urls的url()函数中通过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"),
...

如果你想改变投票详情视图的 URL，比如想改成 polls/specifics/12/ ，你不用在模板里修改任何东西（包括其它模板），只要在polls/urls.py里稍微修改一下就行：

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

为 URL 名称添加命名空间

教程项目只有一个应用:polls 。在一个真实的 Django 项目中，可能会有五个，十个，甚至更多应用。Django 如何分辨重名的 URL 呢？举个例子，polls应用有detail视图，可能另一个博客应用也有同名的视图。Django 如何知道{% url %}标签到底对应哪一个应用的URL呢？

答案是：在根URLconf中添加命名空间。在polls/urls.py文件中稍作修改，加上app_name设置命名空间

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文件，从 <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>

Django快速入门——投票程序(7) 自定义后台
上一篇
Django快速入门——投票程序(1、2)创建项目&模型
下一篇