第一个Django应用程序_part3

Posted 2020-11-19

一、概述

此文延续第一个Django应用程序part2。

官方文档：https://docs.djangoproject.com/en/1.11/intro/tutorial03/

view是Django应用程序中的“类”网页，它通常使用一个特定的函数提供服务，并且具有一个特定的模版。例如在博客应用程序中，kennel有以下视图：

• 博客首页-显示最新的几个条目。
• 博客“详细”页面 --单篇博客的固定链接页面。
• 基于年份的存档页面-显示给定年份的所有月份。
• 基于月份的存档页面-显示所有日期与给定月份的条目。
• 基于日的存档页面-显示给定日期中的所有条目。
• 评论动作-处理对给定条目的发布评论。

在我们的polls应用程序中，我们将拥有以下四个视图：

• 问题“索引”页面-显示最新的几个问题。
• 问题“详细信息”页面detail-显示单个Question的具体内容，不显示该议题的当前投票结果，而是提供一个投票的表单。
• 问题“结束”页面detail -显示特定问题的结果。
• 投票功能vote-处理特点问题中特定选择的投票。

在Django中，网页和其它内容有视图提供。每个视图都由一个简单的Python函数(或基于类视图的方法)来表示。Django将通过检查所请求的URL(确切的说，域名后的URL部分)，来选择一个视图。

平日你上网时，可能会遇到像 “ME2/Sites/dirmod.asp?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B”这样 "优美" 的URL。很高兴是，Django允许我们使用更加优雅的URL模式。

网址格式只是URL的一般形式，例如：/newsarchive/<year>/<month>/。

要从URL到视图，Django使用所谓的“URLconfs”。URLconf将URL模式（描述为正则表达式）映射到视图。

Django.urls更多信息：https://docs.djangoproject.com/en/1.11/ref/urlresolvers/#module-django.urls

二、添加视图

现在我们再添加一些视图到polls/views.py。

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

def detail(request,question_id):
    return HttpResponse("Your\'re lokking 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))

通过添加以下url()调用，将这些新views连接到polls/urls.py模块中。

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/"。它将运行detail()方法，并显示您在URL中提供的任何ID(Your\'re lokking at question 34.)。

例如："/polls/34/results/"。浏览器显示结果：You\'re looking at the results of question 34.

"/polls/34/vote/"。浏览器显示结果：You\'re voting on question 34.

当有人从您的网站请求一个页面-例如"/polls/34/"时，Django将加载mysite.urls Python模块，因为它被ROOT_URLCONF设置指向。它找到名为urlpatterns的变量，并按照顺序遍历正则表达式。在\'^polls/\'找到匹配后，它将取消匹配的文本("polls/"),并发送剩余的文本-"34/"-到\'polls.urls\'URLconf进行进一步处理。它匹配r\'^(<?Pquestion_id>[0-9]+)/$\',请求detail()视图的结果就像下面一样：

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

question_id = \'34\'部分来自(?P<question_id>[0-9]+)。使用模式周围的括号"捕获"该模式匹配的文本，并将其作为参数发送给视图函数；?P<question_id>定义待处理的question_id;

[0-9]+是匹配数字的正则表达式。

由于其网址格式是正则表达式，所以您可以对他们做什么，实际上没有限制。而且不需要添加URL cruft，例如.html-除非你想，在这种情况下你可以这样做：

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

但是，不要这样做。太愚蠢了。

三、编写实际执行某些操作的视图

每个视图负责执行以下两项操作之一：返回包含所请求页面内容的HttpResponse对象，或引发例如Http404等异常。

你的views可以从数据库读取记录。它可以使用Django的模版系统，也可以使用第三方Python模版系统。它可以生成PDF文件，输出XML，随时创建一个ZIP文件，任何你想要的，使用任何你想要的Python库。

Django想要的就是这个HttpResponse。或者是一个例外。

这是一个新的index()视图，它显示系统中最新的5个polls问题，用逗号分隔，根据发布日期：

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如何价值和呈现模版。默认设置文件匹配APP_DIRS选择设置为True的DjangoTemplates后端。按照惯例DjangoTemplates在INSTALLES_APPS中查找"templates"子目录。

在刚刚创建的模版目录中，创建另一名为polls的目录，并在其中创建一个名为index.html的文件。换句话说，你的模版应该在polls/templates/polls/index.html。由于app_directories模版加载器的工作原理如上所述，您可以将Django中此模版简单地称为polls/index.html。

• 模版命名空间

现在，我们可以直接放在polls/templates中(而不是创建另一个polls子目录)，但是它会其实是一个糟糕的主意。Django将选择其找到的第一个模版，其名称与之匹配，如果您在不同的应用程序汇总具有相同的名称模版，则Django将无法区分他们。我们需要能够将Django指向正确的位置，而通过命名空间来确保这一点的最简单的方法。也就是说，将这些模版放在另一个应用程序命名的目录中。

 将以下代码放在该模版中：

{% 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 .models import Question
from django.template import loader



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/"来加载页面，您应该看到包含第一个Django应用程序part2 中的"What\'s up"问题的项目符号列表。链接指向问题的详细页面。

四、快捷方式：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)

请注意，一旦我们在所有这些视图中完成了这些操作，我们就不再需要导入， loader并且HttpResponse（HttpResponse如果您仍然具有，和的存根方法detail， 您将需要保留）。


render()函数将请求对象作为其第一个参数，模版名作为第二个参数，并将字典作为其可选的第三个参数。它返回使用给定上下文呈现的给定模版的HttpResponse对象。

五、触发404错误

现在，我们来处理问题详细视图(question detail view)-显示给定投票的问题文本的页面，以下是视图：

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()函数，除了使用filter()而不是get()之外，它可以像get_object_or_404()。如果列表为空，它会触发Http404。

七、模版系统

返回到我们的polls应用程序的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上查找。否则，它会尝试一个属性查找-在这种情况下可以工作。如果属性查找失败，它将尝试列表索引查找。

方法调用发生在{% for %}循环:question.choice_set.all被解释为Python代码question.choice_set.all()，它返回一个Choice对象的迭代，适用于{% for %}标签。

删除模版中的硬编码网址

当我们在polls/index.html模版中写入一个question的链接时，链接部分硬件编码如下：

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

这种硬编码，紧密耦合的方法的问题是，在具有大量模版的项目上更改URL变得具有挑战性。但是，由于您在polls.urls模块中的url()函数中定义了name参数，因此可以删除对url配置中定义的特定URL路径的依赖使用{% url %}模版标签：

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

这种方式是通过查找polls.urls模块中指定的URL定义。您可以看到下面定义了"detail"的URL名称：

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

如果您想将polls详细信息视图的URL更改为其它内容，可能polls/specifics/12/不是在模版(或模版)中进行，而是将其更改为polls/urls.py：

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

名称空间URL名称

在项目中只有一个应用程序polls。在实际的Django项目中，可能有五、十、二十个甚至更多个应用。Django如何区分他们之间的URL名称？例如：polls应用程序具有detail视图，同一项目中的应用程序也可能是一个博客。当使用{% url %}时，Django会如何知道哪个应用程序视图为url创建模版标签？

解决的方法是为您的URLconf添加命名空间。在polls/url.py文件中，继续添加一个app_name来设置应用程序命名空间：

from django.conf.urls import url
from . import views


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/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>