编写你的第一个django应用程序3

这一篇从教程第2部分结尾的地方继续讲起。我们将继续编写投票应用,并且专注于如何创建公用界面--也被称为视图

概况

django视图概念是一类具有相同功能和末班的网页的集合,比如,在一个博客应用中,你可能会创建如下几个视图

博客首页--展示最近几项内容

内容详情页--详细展示某项内容

以年为单位的归档页--展示选中的年份里各个月份创建的内容

以月为单位的归档页--展示选中天里创建的所有内容

评论处理器--用于响应为一项内容添加评论的操作

而在我们的投票应用中,我们需要以下几个视图:

问题索引页--展示最近几个投票问题

问题详情页--展示某个投票的问题和不带结果的选项列表

问题结果也--展示某个投票的结果

投票处理器--用于响应用户为某个问题的特定选项投票的操作

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

在你上网的过程中,很可能看见过像这样美丽的URL: "ME2/Sites/dirmod.asp?sid=&type=gen&mod=Core+Pages&gid=A6CD4967199A42D9B65B1B" 。

别担心,django里的url规则要比这优雅的多

一个url模式定义了某种url的基本格式--举个例子:/newsarchive/<year>/<month>/

为了将url和视图关联起来,django使用了‘urlconfs’来配置,urlconf将url模式映射到视图

本教程只会介绍urlconf的基础内容,你可以看看url调度器以获取更多内容

编写更多视图

现在让我们向polls/views.py里添加更多视图。这些视图有一些不同,因为它们接收参数

polls/views.py
def
detail(request,question_id): return HttpResponse(''you're looking at question %s."%question_id) def results(): 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模块里,只要添加几个url()函数调用就行

polls/urls.py
from django.url import path 
from . import views 

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/34’,django将会运行detail()方法并且展示你在url里提供的问题iD,再试试‘/polls/34/vote/’和‘/polls/34/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)

question_id=34由<int:question_id>匹配生成,使用尖括号'捕获'这部分url,且以关键字参数的形式发送给视图函数。上述字符串的:question_id>部分定义了将被用于区分匹配模式的变量名,而int:则是一个转化器决定了应该以什么变量类型匹配这部分的url路径。

为每个url加上不必要的东西,例如.html,是没有必要的,不过如果你非要加的话,也是可以的

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

但是,别这样做,这太傻了

写一个真正有用的视图

每个视图必须要做的只有两件事:返回一个包含被请求页面内容的HttpResponse对象,或者抛出一个异常,比如Http404。至于你还想干什么,随便你

你的视图可以从数据库里读取记录,可以使用一个模板引擎(比如django自带的,或者其他第三方的),可以生成一个pdf文件,可以输出一个xml,创建一个zip文件,你可以做任何你想做的事,使用任何你想用的python库。

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)

这里有个问题:页面的设计写死在视图函数的代码里的。如果你想改变页面的样子,你需要编辑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。因为django会寻找到对应的app_directories,所以你只需要使用polls/index.html就可以引用到这一模板了。

模板命名空间

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

将下面的代码输入到刚刚创建的模板文件中:

polls/template/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():
    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/’,你将会看见一个无序列表,列出了我们在教程第二部分中添加的"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':last_question_list}
    return render(request,'polls/index.html',context)            

注意到,我们不再需要导入loader和HttpResponse。不过如果你还有其他函数(比如说detail,results,和vote)需要用到它的话,就需要保持HttpResponse的导入

抛出404错误

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

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

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而不是自己捕获objectdoesnotexist异常呢?还有,为什么模型API不直接抛出objectdoesnotexist而是抛出Http404呢

因为这样做会增加模型层和视图层的耦合性,指导django设计的最重要的思想之一就是要保证松散耦合,一些受控的耦合将会被包含在django.shortcuts模块中

也有get_list_or_404函数,工作原理和get_object_or_404()一样,除了get()函数被换成了filter()函数。如果列表为空的话会抛出Http404异常

使用模板系统

回过头看看我们的detail()视图,它向模板传递了上下文变量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对象使用字典查找(也就是使用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 %}标签代替它

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

这个标签的工作方式是在polls.urls模块的url定义中寻具有指定名字的条目。你可以回忆一下,具有名字‘detail’的url是在如下语句中定义的

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

如果你想改变投票详情视图的url,比如想改成polls/specifics/12/,你不用在模板里修改任何东西(包括其他模板)

只要在polls/urls.py里稍微修改一下就行

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设置命名空间

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>

修改为指向具有命名空间的详细视图

polls/templates/polls/index.html

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

修改为指向具有命名空间的详细视图

polls/templates/polls/index.html

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

当你对你写的视图感到满意后,请阅读教程的第四部分了解简单的表单处理和通用视图

原文地址:https://www.cnblogs.com/z-x-y/p/9606418.html