18.2.7 Django shell
输入一些数据后，就可通过交互式终端会话以编程方式查看这些数据了。这种交互式环境称 为Django shell，是测试项目和排除其故障的理想之地。下面是一个交互式shell会话示例：
(ll_env)learning_log$ python manage.py shell 1 >>> from learning_logs.models import Topic >>> Topic.objects.all() [<Topic: Chess>, <Topic: Rock Climbing>]
在活动的虚拟环境中执行时，命令python manage.py shell启动一个Python解释器，可使用 它来探索存储在项目数据库中的数据。在这里，我们导入了模块learning_logs.models中的模型 Topic（见1），然后使用方法Topic.objects.all()来获取模型Topic的所有实例；它返回的是一个列表，称为查询集（queryset）。 我们可以像遍历列表一样遍历查询集。下面演示了如何查看分配给每个主题对象的ID：
>>> topics = Topic.objects.all() >>> for topic in topics: ... print(topic.id, topic) ... 1 Chess 2 Rock Climbing
我们将返回的查询集存储在topics中，然后打印每个主题的id属性和字符串表示。从输出可 知，主题Chess的ID为1，而Rock Climbing的ID为2。 知道对象的ID后，就可获取该对象并查看其任何属性。下面来看看主题Chess的属性text和 date_added的值：
>>> t = Topic.objects.get(id=1) >>> t.text 'Chess' >>> t.date_added datetime.datetime(2015, 5, 28, 4, 39, 11, 989446, tzinfo=<UTC>)
我们还可以查看与主题相关联的条目。前面我们给模型Entry定义了属性topic，这是一个 ForeignKey，将条目与主题关联起来。利用这种关联，Django能够获取与特定主题相关联的所有 条目，如下所示：
1 >>> t.entry_set.all() [<Entry: The opening is the first part of the game, roughly...>, <Entry: In the opening phase of the game, it's important t...>]
为通过外键关系获取数据，可使用相关模型的小写名称、下划线和单词set（见1）。例如， 假设你有模型Pizza和Topping，而Topping通过一个外键关联到Pizza；如果你有一个名为my_pizza 的对象，表示一张比萨，就可使用代码my_pizza.topping_set.all()来获取这张比萨的所有配料。 编写用户可请求的网页时，我们将使用这种语法。确认代码能获取所需的数据时，shell很有 帮助。如果代码在shell中的行为符合预期，那么它们在项目文件中也能正确地工作。如果代码引 发了错误或获取的数据不符合预期，那么在简单的shell环境中排除故障要比在生成网页的文件中 排除故障容易得多。我们不会太多地使用shell，但应继续使用它来熟悉对存储在项目中的数据进 行访问的Django语法。
注意
每次修改模型后，你都需要重启shell，这样才能看到修改的效果。要退出shell会话，可 按Ctr + D；如果你使用的是Windows系统，应按Ctr + Z，再按回车键。
18.3 创建网页：学习笔记主页
使用Django创建网页的过程通常分三个阶段：定义URL、编写视图和编写模板。首先，你必 须定义URL模式。URL模式描述了URL是如何设计的，让Django知道如何将浏览器请求与网站 URL匹配，以确定返回哪个网页。
每个URL都被映射到特定的视图——视图函数获取并处理网页所需的数据。视图函数通常调 用一个模板，后者生成浏览器能够理解的网页。为明白其中的工作原理，我们来创建学习笔记的 主页。我们将定义该主页的URL、编写其视图函数并创建一个简单的模板。
鉴于我们只是要确保“学习笔记”按要求的那样工作，我们将暂时让这个网页尽可能简单。 Web应用程序能够正常运行后，设置样式可使其更有趣，但中看不中用的应用程序毫无意义。就 目前而言，主页只显示标题和简单的描述。
18.3.1 映射 URL
用户通过在浏览器中输入URL以及单击链接来请求网页，因此我们需要确定项目需要哪些 URL 。主页的 URL 最重要，它是用户用来访问项目的基础 URL 。当前，基础 URL （http://localhost:8000/）返回默认的Django网站，让我们知道正确地建立了项目。我们将修改这一 点，将这个基础URL映射到“学习笔记”的主页。 打开项目主文件夹learning_log中的文件urls.py，你将看到如下代码：
urls.py
1 from django.conf.urls import include, url from django.contrib import admin 2 urlpatterns = [ 3 url(r'^admin/', include(admin.site.urls)), ]
前两行导入了为项目和管理网站管理URL的函数和模块（见1）。这个文件的主体定义了变 量urlpatterns（见2）。在这个针对整个项目的urls.py文件中，变量urlpatterns包含项目中的应 用程序的URL。3处的代码包含模块admin.site.urls，该模块定义了可在管理网站中请求的所有 URL。 我们需要包含learning_logs的URL：
from django.conf.urls import include, url from django.contrib import admin urlpatterns = [ url(r'^admin/', include(admin.site.urls)), 1 url(r'', include('learning_logs.urls', namespace='learning_logs')), ]
在1处，我们添加了一行代码来包含模块learning_logs.urls。这行代码包含实参 namespace，让我们能够将learning_logs的URL同项目中的其他URL区分开来，这在项目开始扩 展时很有帮助。
默认的urls.py包含在文件夹learning_log中，现在我们需要在文件夹learning_logs中创建另一 个urls.py文件：
urls.py
1 """定义learning_logs的URL模式""" 2 from django.conf.urls import url 3 from . import views 4 urlpatterns = [ # 主页 5 url(r'^$', views.index, name='index'), ]
为弄清楚当前位于哪个urls.py文件中，我们在这个文件开头添加了一个文档字符串（见1）。 接下来，我们导入了函数url，因为我们需要使用它来将URL映射到视图（见2）。我们还导入了 模块views（见3），其中的句点让Python从当前的urls.py模块所在的文件夹中导入视图。在这个 模块中，变量urlpatterns是一个列表，包含可在应用程序learning_logs中请求的网页（见4）。
实际的URL模式是一个对函数url()的调用，这个函数接受三个实参（见）。第一个是一个 正则表达式。Django在urlpatterns中查找与请求的URL字符串匹配的正则表达式，因此正则表达 式定义了Django可查找的模式。
我们来看看正则表达式r'^$'。其中的r让Python将接下来的字符串视为原始字符串，而引号 告诉Python正则表达式始于和终于何处。脱字符（^）让Python查看字符串的开头，而美元符号让 Python查看字符串的末尾。总体而言，这个正则表达式让Python查找开头和末尾之间没有任何东 西的URL。Python忽略项目的基础URL（http://localhost:8000/），因此这个正则表达式与基础URL 匹配。其他URL都与这个正则表达式不匹配。如果请求的URL不与任何URL模式匹配，Django 将返回一个错误页面。
url()的第二个实参（见5）指定了要调用的视图函数。请求的URL与前述正则表达式匹配时， Django将调用views.index（这个视图函数将在下一节编写）。第三个实参将这个URL模式的名称 指定为index，让我们能够在代码的其他地方引用它。每当需要提供到这个主页的链接时，我们 都将使用这个名称，而不编写URL。
注意
正则表达式通常被称为regex，几乎每种编程语言都使用它。它们的用途多得难以置信， 但需要经过一定的练习才能熟悉。如果你不明白前面介绍的内容，也不用担心，你在完 成这个项目的过程中，将会看到很多正则表达式。
18.3.2 编写视图
视图函数接受请求中的信息，准备好生成网页所需的数据，再将这些数据发送给浏览器—— 这通常是使用定义了网页是什么样的模板实现的。 learning_logs中的文件views.py是你执行命令python manage.py startapp时自动生成的，当前 其内容如下：
views.py
from django.shortcuts import render # 在这里创建视图
当前，这个文件只导入了函数render()，它根据视图提供的数据渲染响应。下面的代码演示 了该如何为主页编写视图：
from django.shortcuts import render def index(request): """学习笔记的主页""" return render(request, 'learning_logs/index.html')
URL请求与我们刚才定义的模式匹配时，Django将在文件views.py中查找函数index()，再将 请求对象传递给这个视图函数。在这里，我们不需要处理任何数据，因此这个函数只包含调用 render()的代码。这里向函数render()提供了两个实参：原始请求对象以及一个可用于创建网页 的模板。下面来编写这个模板。
18.3.3 编写模板
模板定义了网页的结构。模板指定了网页是什么样的，而每当网页被请求时，Django将填入 相关的数据。模板让你能够访问视图提供的任何数据。我们的主页视图没有提供任何数据，因此 相应的模板非常简单。 在文件夹learning_logs中新建一个文件夹，并将其命名为templates。
在文件夹templates中，再 新建一个文件夹，并将其命名为learning_logs。这好像有点多余（我们在文件夹learning_logs中创 建了文件夹templates，又在这个文件夹中创建了文件夹learning_logs），但建立了Django能够明确 解读的结构，即便项目很大，包含很多应用程序亦如此。在最里面的文件夹learning_logs中，新 建一个文件，并将其命名为index.html，再在这个文件中编写如下代码：
index.html
<p>Learning Log</p> <p>Learning Log helps you keep track of your learning, for any topic you're learning about.</p>
这个文件非常简单。对于不熟悉HTML的读者，这里解释一下：标签<p></p>
标识段落；标签
指出了段落的开头位置，而标签
指出了段落的结束位置。这里定义了两个段落：第一个 充当标题，第二个阐述了用户可使用“学习笔记”来做什么。 现在，如果你请求这个项目的基础URL——http://localhost:8000/，将看到刚才创建的网页， 而不是默认的Django网页。Django接受请求的URL，发现该URL与模式r'^$'匹配，因此调用函 数views.index()，这将使用index.html包含的模板来渲染网页，结果如图18-3所示。
创建网页的过程看起来可能很复杂，但将URL、视图和模板分离的效果实际上很好。这让我 们能够分别考虑项目的不同方面，且在项目很大时，让各个参与者可专注于其最擅长的方面。例 如，数据库专家可专注于模型，程序员可专注于视图代码，而Web设计人员可专注于模板。
