django笔记--3

视图

概况

Django 中的视图的概念是【一类具有相同功能和模板的网页的集合】。

比如，在一个博客应用中，你可能会创建如下几个视图：

博客首页--展示最近的几项内容。
内容“详情”页--详细展示某项内容。
以年为单位的归档页--展示选中的年份里各个月份创建的内容。
以月为单位的归档页——展示选中的月份里各天创建的内容。
以天为单位的归档页——展示选中天里创建的所有内容。
评论处理器——用于响应为一项内容添加评论的操作。

而我们的投票应用中，我们需要如下几个视图：

问题索引页--展示最近的几个投票问题。
问题详情页--展示某个投票的问题和不带结果的选项列表。
问题结果也--展示某个投票的结果。
投票处理器--用于响应用户为某个问题的特定选项投票的操作。

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

Django 里面的 URL patterns 是非常优雅的。
URL 模式是URL的一般形式-如：/newsarchive///

为了将 URL 和视图关联起来，Django 使用了 ‘URLconfs’ 来配置。URLconfs 将 URL 模式映射到视图。

URL调度器详细文档

编写更多视图

写一个真正有用的视图

每个视图必须要做的只有两件事情：

返回一个包含被请求页面内容的 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)

# Leave the rest of the views (detail, results, vote) unchanged

这里有问题：
页面的设计写死在视图函数的代码里的。如果想要改变页面的样子，需要编辑 Python 代码。所以我们可以使用 Django 的模板系统，只要创建一个视图，就可以将页面的设计从代码里分离出来。

首先，在 polls 目录里创建一个 templates 目录。Django 将会在这个目录里查找模板文件。
项目的 TEMPLATES 配置项目（项目根目录下的setting文件中的TEMPLATES）描述了 Django 如何载入和渲染模板。
- 默认的设置文件设置了 DjangoTemplates 后端，并将 APP_DIRS 设置成了 True。
- 这一选项将会让 DjangoTemplates 在每个 INSTALLED_APPS 文件夹中寻找“templates”子目录。
- 这就是为什么尽管我们没有修改 DIRS 设置，Django 也能正确找到 polls 的模板位置的原因。
在刚刚创建 templates 目录里，在创建一个目录 polls，然后在其中新建一个文件 index.html。
- 换句话说，模板文件的路径应该是 polls/templates/polls/index.html 。
- 因为“app_directories”模板加载器hi通过上述方法运行的，所以 Django 可以引用到 polls/index.html 这一模板了。

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

模板文件案例

然后就可以更新 polls/views.py 里的 index 视图来使用模板：

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/”，将会看到一个无需列表，列出之前添加的投票问题，链接指向这个投票的详情页。

一个快捷函数：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。不过如果还有其他函数（比如说 detail， results 和 vote）需要用它的话，就需要保持 HTTPResponse 的导入。

render()函数的参数

第一个参数是请求对象；
第二个参数是模板名称；
第三个参数是字典。
它返回使用给定上下文呈现的给定模板的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 里输入 {{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.

设计哲学
为什么使用辅助函数 get_object_or_404() 而不是自己捕获 ObjectDoesNotExist 异常呢？
为什么模型 API 不直接抛出 ObjectDoesNoteExist 而是抛出 Http404 呢？

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

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

使用模板系统

回头去看看 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 对象使用字典查找（也就是使用 obj.get(str)操作），
如果失败了就尝试属性查找（也就是 obj.str 操作），结果成果了。
如果这一操作也失败的话，将会尝试列表查找（也就是 ibj[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>

这个标签的工作方式是在 pols.urls 模块的 URL 模块的 URL 定义中寻具有指定名字的条目。回忆下，具有名字‘detail’的URL是在如下语句中定义的：

...
# the 'name' value as called by the {% url %} template tag
path('<int:question_id>/', views.detail, name='detail'),
...

如果你想改变投票详情视图的 URL，比如想改成 polls/specifics/12/ ，你不用在模板里修改任何东西（包括其它模板），只要在 polls/urls.py 里稍微修改一下就行：

...
# added the word 'specifics'
path('specifics/<int:question_id>/', views.detail, name='detail'),
...

为 URL 名称添加命名空间

测试项目只有一个应用，polls。在一个真实的 Django 项目中，可能会有五个，十个，二十个，甚至更多应用。Django 如何分辨重名 URL 呢？例如polls 应用有 detail 视图，可能另一个博客应用也有同名的视图。Django 如何知道 {% url %} 标签到底对应哪一个应用的 URL 呢？

答案是：在根 URLconf 中添加命名空间。在 polls/url.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 文件，从：

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

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

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

2020.12.14
hare