Python编程：Django 入门

最新推荐文章于 2024-10-02 11:31:21 发布

Bruce_xiaowei

最新推荐文章于 2024-10-02 11:31:21 发布

阅读量625

点赞数

分类专栏：编程文章标签： django python 后端

本文链接：https://blog.csdn.net/weixin_41905135/article/details/125288438

版权

编程专栏收录该内容

320 篇文章 6 订阅

订阅专栏

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

1.3 激活虚拟环境

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

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

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

在这种情况下，你可以在环境中安装包，并使用已安装的包。而且在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

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

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

(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/；将看到如下图所示的页面：

这个页面是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/，并输入刚刚创建的超级用户的用户名和密码，如下图所示：

3. 添加主题

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

本案例创建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。

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网页。如下图所示：

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。单击这个链接，将看到如下图所示的网页：

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---

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

Bruce_xiaowei

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
打赏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

专栏目录