从零搭建一个Django项目(三): 视图和模板

这里接着上一篇的内容继续从零搭建一个Django项目(二)

视图

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

编写一个有实际功能的视图

每个视图必须要做的只有两件事：返回一个包含被请求页面内容的 HttpResponse 对象，或者抛出一个异常，比如 Http404 。

你的视图可以从数据库里读取记录，可以使用一个模板引擎（比如 Django 自带的，或者其他第三方的），可以生成一个 PDF 文件，可以输出一个 XML，创建一个 ZIP 文件，你可以做任何你想做的事，使用任何你想用的 Python 库。

Django 只要求返回的是一个 HttpResponse ，或者抛出一个异常。

在第一部分里，我们编写了一个简单的视图

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

以及第二部分中我们已经创建好了模型并已经将其应用到数据库中，接下来我们将模型融入到视图中

def index(request):
    latest_question_list = Question.objects.order_by('-pub_date')[:5]
    return HttpResponse(latest_question_list)

此时再访问 http://127.0.0.1:8000/polls/ ，就会展示出数据库中最新的5条记录

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配置:

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 将会载入 mysite.urls 模块，因为这在配置项 ROOT_URLCONF 中设置了。然后 Django 寻找名为 urlpatterns 变量并且按序匹配正则表达式。在找到匹配项 'polls/'，它切掉了匹配的文本（"polls/"），将剩余文本——"34/"，发送至 'polls.urls' URLconf 做进一步处理。在这里剩余文本匹配了 'int:question_id/'，使得我们 Django 以如下形式调用 detail():

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

有时，我们往往需要返回的内容不只是单纯的数据，需要返回一个包含样式、数据等一个完整的页面，这时就需要用到模板

模板

模板语法

在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 %}

创建好模板后，在视图中应用模板，方式如下

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

避免在模板中硬编码url

可以看到，上述模板中的跳转地址是通过硬编码实现的

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

这种方式下，如果目标接口的url发生改变，那么还需要对模板进行修改，为了避免这种过高的耦合性，Django推荐使用使用 {% url %} 标签代替它。回顾下之前，我们针对detail对应的url设置了name属性，可以在url便签中使用name指明url

···
    path('<int:question_id>/', views.detail, name='detail'),
···

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

这样，当我们想修改url时只需要修改urls.py文件即可

为url名称设置命名空间

我们当前只有一个应用polls，因此可以通过detail这个name找到唯一的url。但在一个真实的 Django 项目中，可能会有很多应用。Django 如何分辨重名的 URL 呢？举个例子，polls 应用有名为 detail 的url，可能另一个博客应用也有同名的url。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'),
]

并在模板中使用url名称时，指明命名空间

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

Django快捷函数

1.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)

2.get_object_or_404()

下面我们填充下detail视图，使其能够查询数据并在查询不到时返回404

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

我们稍后再讨论你需要在 polls/detail.html 里输入什么，但是如果你想试试上面这段代码是否正常工作的话，你可以暂时把下面这段输进去：

{{ question }}

尝试用 get() 函数获取一个对象，如果不存在就抛出 Http404 错误也是一个普遍的流程。Django 也提供了一个快捷函数，下面是修改后的详情 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 异常。