欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

第一个Django应用程序_part3

程序员文章站 2022-03-01 15:38:02
一、概述 此文延续第一个Django应用程序part2。 官方文档:https://docs.djangoproject.com/en/1.11/intro/tutorial03/ view是Django应用程序中的“类”网页,它通常使用一个特定的函数提供服务,并且具有一个特定的模版。例如在博客应用 ......

一、概述

此文延续

官方文档:

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更多信息:

二、添加视图

现在我们再添加一些视图到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/"来加载页面,您应该看到包含 中的"What's up"问题的项目符号列表。链接指向问题的详细页面。

第一个Django应用程序_part3

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

请注意,一旦我们在所有这些视图中完成了这些操作,我们就不再需要导入, 并且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>