Django 2.0 学习(06):Django 视图(进阶)

概述

Django中的特方法,该方法代表了Django的Web页面,并且视图具有特定的模板。以博客应用为例进行说明,在博客应用中应该包含下面的视图:

  • 博客主页:显示最近的一些记录;
  • 详细页面:单个详细页面的入口;
  • 年/月/日:存档页面,显示记录的所有年/月/日;
  • 评论动作:分发评论请求到对应入口;

在poll应用中,我们将会创建如下视图:

  • Question "index"页面:显示最近的questions;
  • Question "detail"页面:显示问题内容,没有结果的投票表单;
  • Question "results"页面:显示具体question的结果;
  • Vote action:处理具体问题的投票选择;

在Django中,Web页面或者其他内容都有视图来交付处理,Django通过检查请求的URL来选择对应的视图。关于URL分发处理部分参考URL分发器,或者继续阅读后续博客。

编写更加丰富的视图

在我们的polls/view.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 result of question %s."
    return HttpResponse(response % question_id)


def vote(request, question_id):
    return HttpResponse("You're voting on question %s." % question_id)

接下来,需要把这些新的视图添加到poll.urls模块中去,添加的方式就是通过调用path()函数,代码如下:

from django.urls 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:返回detail()方法对应的内容,其ID是在URL里面提供的;
  • /polls/34/results:显示results页面内容;
  • /polls/34/vote:显示vote页面内容;

当我们需要访问某个页面时,我们在浏览器里面输入"/polls/34"Django是如何寻找到对应视图并显示出来的呢?下面对这个问题做以回答:

  • 首先,Django会根据settings.py文件的ROOT_URLCONF配置项取加载mystie.urls模块;
  • 其次,在mysite.urls模块中顺序遍历urlpatterns变量;
  • 再次,当匹配到"polls/"时,剥离掉匹配的内容"polls/",携带剩余待匹配内容"34/"进入到"polls.urls"模块,继续进行处理;
  • 最后,遍历polls.urls的patterns变量,匹配到"int:question_id/"进而调用detail()视图函数,其结果像下面:
detail(request=<HttpRequest object>,  question_id=34)

上面都是对视图函数的简单操作,接下来我们会学习些实际的东西。
每个视图函数都只做1-2件事情:返回包含请求页面内容的HttpResponse对象,或者抛出Http404异常;视图函数可以读取数据库的记录;可以使用Django自带的模板系统,或者其他第三方Python模板系统;它可以生成PDF,导出XML,创建ZIP文件等,使用Python库函数可以实现一切你想实现的。
由于它非常的方便,我们就使用Django自带的数据库API来进行演示,在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)

# 保持其他视图函数不变

这里有个问题:Web页面是通过视图函数硬编码方式来设计的。如果我们想更改页面,我们必须修改这里的Python代码,这样做非常的不友好。因此,我们将使用Django的模板系统,来分离页面的设计和Python代码的耦合,取而代之的是让视图函数去使用模板。
在polls目录下面创建一个目录:templates,Django会自动到该目录里面查找模板文件。其查找机制是:在项目的配置文件settings.py中,"TEMPLATES"定义了Django如何加载和渲染模板;默认配置了一个APP_DIRS为TRUE的DjangoTemplates后台,按照惯例DjangoTemplates会在每个INSTALLED_APPS中查找"templates"这个子目录。

接下来,在templates目录里面创建空目录:polls,在该空目录里面创建一个index.html文件。换句话说,我们的模板目录应该是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 %}

现在,使用模板更新我们之前的index视图函数polls/views.py,代码如下:

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,并且将该模板传递给上下文环境,该上下文环境是一个将模板变量名映射成Pyhton对象的字典;在浏览器中通过"polls"访问页面,如下图所示:

点击上图的链接,可以看到对应question的详细信息,如下图所示:

快捷方式:render()
Django提供了一个快捷方式:rendered template去加载模板,填充上下文环境并且返回HttpResponse对象,详细代码如下所示:

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了;如果视图函数还有detail,results,vote这几个方法的话,还是需要导入HttpResponse。

render()方法参数:request对象作为第一个参数,模板名作为第二个参数,上下文环境(字典)作为第三个可选择参数;它将根据给定的模板和上下文环境(字典)返回一个HttpResponse对象。

抛出404异常
为了更加丰富我们的视图函数,我们除了对正常情况的处理,还需要对异常进行处理,以视图中的detail()为例进行说明,其代码如下:

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文件,其代码如下所示,具体讲解放在后面:

{{ question }}

快捷方式:get_object_or_404()
通过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_object_or_404()方法参数:第一个参数为Django模型,其余参数是一系列关键字参数,这些参数将会传递给模型管理器的get()方法,如果获取的对象不存在,则抛出Http404异常。
在Django中还存在一个方法get_list_or_404(),其工作机制如同get_object_or_404(),最大的区别就是前者用filter()代替了后者的get(),并且前者在list为空的时候抛出异常。

回顾之前创建的detail()视图函数,在polls/detail.html文件中完善模板,代码如下:

<h1>{{ question.question_text }}</h1>
<ul>
{% for choice in question.choice_set.all %}
    <li>{{ choice.choice_text }}</li>
{% endfor %}
</ul>

关于模板系统的更多使用,请参考

最后,我们需要在模板中删除硬编码的URLs
我们来回顾下polls/index.html模板中的链接的代码,如下所示:

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

在项目中拥有大量模板文件的时候,这种硬编码、紧耦合方式会存在使得对模板的修改变得异常困难(人力、时间、复杂性);幸运的是,在polls.urls模块的path()方法中,我们定义了关键字参数name,在模板里面我们就可以用{% url %}来替换掉具体的URLs路径,其代码如下:

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

工作机制:查找polls.urls模块中定义的特定URL,具体见下面代码:

# name参数的值将会被模板的{% url %}标签调用
path('<int:question_id>/', views.detail, name='detail'),

当我们想更改detail视图函数对应的URL时,我们可以不需要去修改模板文件,而只需要修改polls/urls.py文件即可,如下所示:

# 添加前缀单词 'specifics'
path('specifics/<int:question_id>/', views.detail, name='detail'),

URL名称的命名空间
在我们的mysite项目中,仅有一个应用:polls。但是,实际的Django项目中,可能会有5个,10个,20个甚至更多的应用。那么Django是如何在这些应用中区分URL的名字呢?举个例子:在polls应用中有个detail视图函数,同样的在该项目的blog中也有个detail视图函数。Django如何知道模板中的{% url %}标签,调用的是哪个应用的视图函数呢?
答案是:为URLconf添加namespaces。在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(指明detail视图的命名空间),代码如下所示:

<li>
    <a href="{% url 'polls:detail' question.id  %}">{{ question.question_text }}</a>
</li>
posted @ 2018-03-20 11:34  月缺一格  阅读(450)  评论(1编辑  收藏  举报