Python编程:Django 入门

当今的网站实际上都是富应用程序(rich application), 就像成熟的桌面应用程序一样。Python提供了一组开发Web应用程序的卓越工具。使用Django开发一个名为“学习笔记”(Learning Log)的项目,这是一个在线日志系统,让你能够记录所学习的有关呢特定主题的知识。

Django是一个Web框架—一套用于帮助开发交互式网站的工具。Django能够响应网页请求,还能让你更轻松地读写数据库、管理用户等。

1. 建立项目

1.1 制定规范

我们要编写一个名为“学习笔记”的Web应用程序, 让用户能够记录感兴趣的主题、并在学习每个主题的过程中添加日志条目。“学习笔记”的主页对这个网站进行描述,并邀请用户注册或登录。用户登录后,就可以创建新主题、添加新条目以及阅读既有的条目。

1.2 建立虚拟环境

要使用Django, 首先需要建立一个虚拟工作环境。虚拟环境是系统的一个位置,你可以在其中安装包,并将其与其他Python包隔离。将项目的库与其他项目分离是有益的,为项目新建一个目录,将其命名为learning_log,再在终端切换到这个目录,并创建一个虚拟环境。

⚠️:本人的操作环境:

macOS Monterey Version 12.4

开发环境:PyCharm2020

命令如下:

(venv) (base) liuxiaowei@localhost learning_log % python -m venv 11_env

Python的计算生态 python计算生态通过django_Python的计算生态

1.3 激活虚拟环境

建立虚拟环境后,需要使用下面的命令激活它:

(venv) (base) liuxiaowei@localhost learning_log % source 11_env/bin/activate
(11_env) (base) liuxiaowei@localhost learning_log %

这个命令11_env/bin中的脚本activate。环境处于活动状态时,环境名将包含在括号内,如下图所示:

Python的计算生态 python计算生态通过django_后端_02

在这种情况下,你可以在环境中安装包,并使用已安装的包。而且在11_env中安装的包仅在该环境处于活动状态时才可用。要停止使用虚拟环境,可执行命令deactivate:

(11_env) (base) liuxiaowei@localhost learning_log % deactivate

如果关闭运行虚拟环境的终端,虚拟环境也将不再处于活动状态。

1.4 安装Django

创建并激活虚拟环境后,就可以安装Django了(本案例使用1.11版):

(11_env) (base) liuxiaowei@localhost learning_log % pip install Django==1.11
Collecting Django==1.11
  Using cached Django-1.11-py2.py3-none-any.whl (6.9 MB)
Collecting pytz
  Using cached pytz-2022.1-py2.py3-none-any.whl (503 kB)
Installing collected packages: pytz, Django
Successfully installed Django-1.11 pytz-2022.1

备注:Django仅在虚拟环境处于活动状态时才可用。

1.5 在Django中创建项目

在依然处于活动的虚拟环境的情况下(11_env包含在括号内),执行如下命令来新建一个项目:

(11_env) (base) liuxiaowei@localhost learning_log % django-admin.py startproject learning_log .
(11_env) (base) liuxiaowei@localhost learning_log % ls
11_env          learning_log    manage.py
(11_env) (base) liuxiaowei@localhost learning_log % ls learning_log
__init__.py     settings.py     urls.py         wsgi.py

这个命令末尾的句点让新项目使用合适的目录结构,这样开发完成后可以轻松地将应用程序部署到服务器。目录learning_log包含4个文件,其中最重要的是settings.py、urls.py和wsgi.py。文件settings.py指定Django如何与你的系统交互以及如何管理项目。文件urls.py告诉Django应创建哪些网页来响应浏览器请求。文件wsgi.py帮助Django提供它创建 的文件,这个文件名是web server gateway interface(Web服务器网关接口)的首字母缩写。

1.6 创建数据库

Django将大部分与项目相关的信息都存储在数据库中,因此我们需要创建一个供Django使用的数据库。为给项目“学习笔记”创建数据库,请在处于活动虚拟环境中情况下执行下面的命令:

(11_env) (base) liuxiaowei@localhost learning_log % python manage.py migrate
Traceback (most recent call last):
......
SyntaxError: Generator expression must be parenthesized

注意:本人执行这个命令的时候,报错。如下图所示:

Python的计算生态 python计算生态通过django_python_03

Python的计算生态 python计算生态通过django_django_04

解决办法:如上图箭头所指,去掉这个逗号就可以解决了。

Python的计算生态 python计算生态通过django_Python的计算生态_05

(11_env) (base) liuxiaowei@localhost learning_log % ls
11_env          db.sqlite3      learning_log    manage.py

我们将修改数据库称为迁移数据库。首先执行命令migrate时,将让Django确保数据库与项目的当前状态匹配。运行命令ls,其输出表明Django又创建了一个文件—db.sqlite3。SQLite时一种使用单个文件的数据库,是编写简单应用程序的理想选择。

1.7 查看项目

核实Django是否正确地创建了项目。执行命令runserver, 如下所示:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py runserver
Performing system checks...

System check identified no issues (0 silenced).
June 14, 2022 - 03:57:41
Django version 1.11, using settings 'learning_log.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Django启动一个服务器,让你能够查看系统中的项目,了解它们的工作情况。在浏览器中输入URL以请求网页时,该Django服务器将进行响应:生成合适的网页,并将其发送给浏览器。现在打开一款Web浏览器,并输入URL:http://127.0.0.1:8000/;将看到如下图所示的页面:

Python的计算生态 python计算生态通过django_Python的计算生态_06

这个页面是Django创建的,上图表示一切正常。现在暂时不关闭这个服务器,若要关闭这个服务器,按Ctrl+C即可。

2. 创建应用程序

Django项目由一系列应用程序组成,它们协同工作,让项目成为一个整体。在前面打开的终端窗口中应该还运行着runserver。请再打开一个终端窗口,并切换到manage.py所在的目录。激活该虚拟环境,再执行命令startapp:

(venv) (base) liuxiaowei@MacBook-Air learning_log % source 11_env/bin/activate
(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py startapp learning_logs
(11_env) (base) liuxiaowei@MacBook-Air learning_log % ls
11_env          db.sqlite3      learning_log    learning_logs   manage.py
(11_env) (base) liuxiaowei@MacBook-Air learning_log % ls learning_logs/
__init__.py     admin.py        apps.py         migrations      models.py       tests.py        views.py

命令startup appname让Django建立创建应用程序所需的基础设施。查看项目目录,将看到其中新增一个文件夹learning_logs,打开这个文件夹,其中最重要的文件是models.py、admin.py和views.py。models.py来定义要在应用程序中管理的数据。

2.1 定义模型

打开models.py,创建自己的模型。模型告诉Django如何处理应用程序中的存储数据。在代码层面,模型就是一个类,包含属性和方法。下面表示用户将要存储的主题的模型。代码如下:

models.py

from django.db import models

# Create your models here.
class Topic(models.Model):
    """用户学习的主题"""
    text = models.CharField(max_length=200)  # 存储少量文本,如名称、标题和城市等
    date_added = models.DateTimeField(auto_now_add=True) # 当用户创建主题时,自动设置成当前日期和时间
    
    
    def __str__(self):
        """返回模型的字符串表示"""
        return self.text

我们创建了一个Topic的类,它继承了Model–Django中一个定义了模型基本功能的类。Topic类只有两个属性:text和date_added。

2.2 激活模型

要使用模型,必须让Django将应用程序包含到项目中。为此,打开settings.py(位于目录learning_log/learning_log中),看到如下内容:

settings.py

---snip---
# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]
---snip---

这是一个列表,告诉Django项目是由哪些应用程序组成的。请将INSTALLED_APPS修改成如下所示:

---snip---
# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
  	# My app
  	'learning_logs',
]
---snip---

这里新建一个名为My app的片段,当前它只包含应用程序learning_logs。然后在终端窗口中执行如下命令:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py makemigrations learning_logs
Migrations for 'learning_logs':
  learning_logs/migrations/0001_initial.py
    - Create model Topic

命令makemigrations让Django确定该如何修改数据库,使其能够存储与我们定义的新模型相关联的数据。输出表明Django创建了一个名为0001_initial.py的迁移文件,这个文件将在数据库中为模型Topic创建一个表。下面应用这种迁移,让Django替我们修改数据库;命令如下:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, learning_logs, sessions
Running migrations:
  Applying learning_logs.0001_initial... OK

备注: 每当需要修改“学习笔记”管理的数据时,都采取如下三个步骤:修改models.py;对learning_logs调用make migrations;让Django迁移项目。

2.3 Django管理网站

1. 创建超级用户

Django允许你创建具备所有权限的用户–超级用户。权限决定了用户可执行的操作。在Django中创建超级用户,执行如下命令:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py createsuperuser
Username (leave blank to use 'liuxiaowei'): lxw_admin  
Email address: 115323222@qq.com
Password: 
Password (again): 
Superuser created successfully.

2. 向管理网站注册模型

我们创建应用程序learning_logs时,Django在models.py所在目录中创建了一个名为admin.py的文件,为向管理网站注册Topic,请在admin.py中输入如下代码:

admin.py

from django.contrib import admin

from learning_logs.models import Topic

# Register your models here.

admin.site.register(Topic)

这些代码导入我们要注册的模型Topic,再使用admin.site.register()让给你Django通过管理网站管理我们的模型。现在使用超级用户账户访问管理网站:访问http://localhost:8000/admin/,并输入刚刚创建的超级用户的用户名和密码,如下图所示:

Python的计算生态 python计算生态通过django_python_07

Python的计算生态 python计算生态通过django_python_08

3. 添加主题

单击Topics进入主题网页,几乎是空的,因为我们没有添加任何主题,单击Add,打开一个添加新主题的表单,在第一个框内输入Chess,再单击Save,返回到主题管理页面,其中包含刚刚创建的主题。如下图所示:

Python的计算生态 python计算生态通过django_应用程序_09

Python的计算生态 python计算生态通过django_Python的计算生态_10

本案例创建Chess和Rock Climbing两个主题。

2.4 定义模型Entry

要记录学到的国际象棋和攀岩知识,需要为用户可在学习笔记中添加的条目定义模型。每个条目都与特定主题相关联,这种关系被称为多对一关系,即多个条目可关联到同一个主题。

下面是模型Entry的代码:

models.py

from django.db import models

# Create your models here.
class Topic(models.Model):
    ---snip---

class Entry(models.Model):
    """学到的有关某个主题的具体知识"""
    topic = models.ForeignKey(Topic, on_delete = models.CASCADE)
    text = models.TextField()
    date_added = models.DateTimeField(auto_now_add=True)


    class Meta:
        verbose_name_plural = 'entries'

        def __str__(self):
            """返回模型的字符串表示"""
            return self.text[:50] + '...'

2.5 迁移模型Entry

由于我们添加了一个新模型因此需要再次迁移数据库。修改models.py,执行命令 python manage.py makemigrations app_name ,再执行命令python manage.py migrate。

命令如下:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py makemigrations learning_logs
Migrations for 'learning_logs':
  learning_logs/migrations/0002_entry.py
    - Create model Entry
(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, learning_logs, sessions
Running migrations:
  Applying learning_logs.0002_entry... OK

生成了一个新的迁移文件—0002_entry.py, 它告诉Django如何修改数据库,使其能够存储与模型Entry相关的信息。执行命令migrate,我们发现Django应用了这种迁移且一切顺利。

2.6 向管理网站注册Entry

我们还需要注册模型Entry。为此需要将admin.py修改成类似如下的内容:

admin.py

from django.contrib import admin

from learning_logs.models import Topic, Entry

# Register your models here.

admin.site.register(Topic)
admin.site.register(Entry)

返回到http://localhost:8000/admin/,你将看到learning_logs下列出了Entries。单击Entries的Add链接,或者单击En tries再选择Add entry。

Python的计算生态 python计算生态通过django_django_11

Python的计算生态 python计算生态通过django_应用程序_12

2.7 Django shell

输入一些数据以后, 就可以通过交互式终端会话以编程方式查看这些数据了。这种交互式环境称为Django shell,是测试项目和排除其故障的理想之地。下面是一个交互式shell会话示例:

(11_env) (base) liuxiaowei@MacBook-Air learning_log % python manage.py shell
Python 3.9.12 (v3.9.12:b28265d7e6, Mar 23 2022, 18:17:11) 
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from learning_logs.models import Topic
>>> Topic.objects.all()
<QuerySet [<Topic: Chess>, <Topic: Rock Climbing>]>

在活动的虚拟环境中执行时,命令python manage.py shell 启动一个python解释器,可使用它来探索存储在项目数据库中的数据。在这里,我们导入模块learning_logs.models中的模型Topic,然后使用方法Topic.objects.all()来获取模型Topic的所有实例;它返回的是一个列表,称为查询集(queryset)。

下面演示如何查看分配给每个主题对象的ID:

>>> topics = Topic.objects.all()
>>> for topic in topics:
...     print(topic.id, topic)
... 
1 Chess
2 Rock Climbing

从以上输出可知,主题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(2022, 6, 14, 9, 4, 29, 528211, tzinfo=<UTC>)

还可以查看与主题关联的条目。利用这种关联,Django能够获取与特定主题相关联的所有条目,如下所示:

>>> t.entry_set.all()
<QuerySet [<Entry: Entry object>, <Entry: Entry object>, <Entry: Entry object>]>

注意: 每次修改模型后,都要重启shell, 这样才能看到修改的效果。要退出shell会话,可按Ctrl+D ,如果是Windows系统,按Ctrl+Z,再按回车键。

3. 创建网页:学习笔记主页

使用Django创建网页过程通常分三个阶段:定义URL、编写视图和编写模板。每个URL都被映射到特定视图——视图函数获取并处理网页所需的数据。

3.1 映射URL

用户通过在浏览器中输入URL以及单击链接来请求网页,因此我们需要确定项目需要哪些URL。主页的URL最重要,它是用户用来访问项目的基础URL。当前,基础URL(http://localhost:8000/)返回默认的Django网站,让我们知道正确地建立了项目。我们将修改这一点,将这个基础URL映射到“学习笔记”的主页。

打开项目文件夹learning_log中的文件urls.py,看到如下代码:

urls.py

from django.conf.urls import url, include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', include(admin.site.urls)),
]

我们需要包含learning_logs的URL:

from django.conf.urls import url, include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', include(admin.site.urls)),
    url(r'', include('learning_logs.urls', namespace='learning_logs')),
]

添加了一行代码来包含模块learning_logs.urls。这行代码包含实参namespace。默认的urls.py包含在文件夹learning_log中,现在我们需要在文件夹learning_logs中创建另一个urls.py文件:

urls.py

"""定义learning_logs的URL模式"""

from django.conf.urls import url

from . import views

urlpatterns = [
    # 主页
    url(r'^$', views.index, name='index')
]

3.2编写视图

视图函数接收请求中的信息,准备好生成网页所需的数据,再将这些数据发送给浏览器——这通常是使用定义了网页是什么样的模版实现的。

learning_logs中的文件views.py是你执行命令python manage.py startapp时自动生成的, 其内容如下:

views.py

from django.shortcuts import render

# Create your views here.

当前这个文件只导入了函数render(), 它根据视图提供的数据渲染响应。如何为主页编写视图,代码如下:

from django.shortcuts import render

# Create your views here.
def index(request):
    """学习笔记的主页"""
    return render(request, 'learning_logs/index.html')

3.3编写模版

模版定义了网页的结构。模版指定了网页时什么样的,而每当网页被请求时,Django将填入相关的数据。模板让你能够访问视图提供的任何数据。我们的主页视图没有提供任何数据,因此模板非常简单。

在文件夹learning_logs中新建一个文件夹,并将其命名为templates。在文件夹templates中,再新建一个文件夹,并将其命名为learning_logs。在最里面的文件夹learning_logs中,新建一个文件,并将其命名为index.html,再在这个文件中编写如下代码:

index.html

<p>Learning Log</p>

<p>Learning Log helps you keep track of your leanring, for any topic you're learning about.</p>

现在请求这个项目的基础URL–http://localhost:8000/,将看到刚才创建的网页,而不是默认的Django网页。如下图所示:

Python的计算生态 python计算生态通过django_python_13

4. 创建其他网页

制定创建网页的流程后,可以开始扩充“学习笔记”项目了。创建两个显示数据的网页,其中一个列出所有的主题,另一个显示特定主题的所有条目。对于每个网页,我们都将指定URL模式,编写一个视图函数,并编写一个模板。

4.1 模板继承

1. 父模板

首先创建一个名为base.html的模板,并将其存储在index.html所在目录中。这文件包含所有页面的元素;其他模板都继承base.html。

base.html

<p>
    <a href = "{% url 'learning_logs:index' %}">Learning Log</a>
</p>

{% block content %}{% endblock content %}

2. 子模板

重新编写index.html,使其继承base.html,如下所示:

index.html

<p>Learning Log</p>
{% extends "learning_logs/base.html" %}

{% block content %}
<p>Learning Log helps you keep track of your leanring, for any topic you're learning about.</p>
{% endblock content %}

4.2 显示所有主题的页面

1. URL模式

定义显示所有主题的页面的URL。通常,使用一个简单的URL片段来指出网页显示的信息;这里使用topics, 因此URL http://localhost:8000/topics/将返回显示所有主题的页面。先修改learning_logs/urls.py:

urls.py

"""定义learning_logs的URL模式"""

from django.conf.urls import url

from . import views


urlpatterns = [
    # 主页
    url(r'^$', views.index, name='index'),

    # 显示所有的主题
    url(r'^topics/$', views.topics, name='topics'),
]

2. 视图

在views.py中添加代码如下:

views.py

from django.shortcuts import render

from .models import Topic

# Create your views here.
def index(request):
    """学习笔记的主页"""
    return render(request, 'learning_logs/index.html')

def topics(request):
    """显示所有的主题"""
    topics = Topic.objects.order_by('date_added')
    context = {'topics':topics}
    return render(request, 'learning_logs/topics.html', context)

3. 模板

创建一个文件,命名为topics.html,存储到index.html所在的目录中。如下所示:

topics.html

{% extends "learning_logs/base.html" %}

{% block content %}

<p>Topics</p>

<ul>
    {% for topic in topics %}
        <li>{{ topic }}</li>
    {% empty %}
    <li>No topics have been added yet.</li>
    {% endfor %}
</ul>

{% endblock content %}

修改父模板,使其包含到显示所有主题的页面链接:

base.html

<p>
    <a href = "{% url 'learning_logs:index' %}">Learning Log</a>
    <a href = "{% url 'learning_logs:topics' %}">Topics</a>
</p>

{% block content %}{% endblock content %}

现在刷新浏览器的中主页,将看到链接Topics。 单击这个链接,将看到如下图所示的网页:

Python的计算生态 python计算生态通过django_后端_14

4.3 显示特定主题的页面

1. URL模式

显示特定主题的页面的UR L模式与前面的所有URL模式稍有不同,因为它将使用主题的id属性来指出请求的是哪个主题。

修改learning_logs/urls.py:

urls.py

---snip---
urlpatterns = [
   ---snip--

  # 显示特定主题
    url(r'^topics/(?P<topic_id>\d+)/$', views.topic, name='topic'),
]

2. 视图

函数topic()需要从数据库中获取指定的主题以及与之相关联的所有条目,如下所示:

views.py

---snip---
def topic(request):
    """显示单个主题机器所有的条目"""
    topic = Topic.objects.get(id=topic_id)
    entries = topic.entry_set.order_by('-date_added')
    context = {'topic': topic, 'entries': entries}
    return render(request, 'learning_logs/topic.html', context)

3. 模板

这个模板需要显示主题的名称和条目的内容;如果当前主题不包含任何条目,我们还需向用户指出这点:

topic.html

{% extends 'learning_logs/base.html' %}

{% block content %}
<p>Topic:{{ topic }}</p>
<p>Entries:</p>
<ul>
    {% for entry in entries %}
    <li>
        <p>{{ entry.date_added|date:'M d, Y H:i' }}</p>
        <p>{{ entry.text|linebreaks }}</p>
    </li>
    {% empty %}
    <li>There are no entries for this topic yet.</li>
    {% endfor %}
</ul>
{% endblock content %}

4. 将显示所有主题的页面中的每个主题都设置为链接

修改模版topics.html,如下所示:

topics.html

---snip---
{% for topic in topics %}
<li><a href="{% url 'learning_logs:topic' topic.id %}">{{ topic }}</a></li>
    {% empty %}
---snip---

刷新显示所有主题的页面,再单击其中一个主题,页面如下图所示:

Python的计算生态 python计算生态通过django_django_15

Python的计算生态 python计算生态通过django_python_16