仓库源文，站点原文

layout: post title: "Django - 基础学习笔记" date: 2021-8-3 00:15:39 +0800

categories: [Work]

此文档是我在阅读学习Django时所做的笔记。学习网站：https://docs.djangoproject.com/en/3.2/

0. Overview

Django是python的web开发框架，遵循MVC(model-view-controller)的设计模式，但在Django中通常称为MTV(model-template-views)。model是数据持久层，主要存放实体映射、实体关系以及实体的一些方法。template是表示层，主要是用来显示数据，Django的视图引擎可以将其渲染成HTML并显示。views是业务逻辑层，在Django中充当着链接model与template的桥梁，处理模型并向template提交数据，同时也接受template的请求和参数，完成相应的逻辑后提交模型修改。

Views和URL

Views是业务逻辑层，在Django里面views通常是一个的views.py模块，放在对应的包里。views.py里面是具体的逻辑函数，每一个函数对应着一个或多个模版，为了建立模版与视图的联系，还要有一定的路由机制，于是Django通常在根目录有一个路由程序urls.py。路由由patterns来创建，用正则表达式来描述，极大地提高了路由机制的灵活性。

模版(Template)

模版在Django中是显示数据的地方，通常为HTML格式，在模版中Django的处理逻辑要写在{\% \%}中，而要显示的变量要写在{{ }}中。Django的母板页可以用任何文档充当，前提是要用{\% block name \%}{\% endblock \%}声明要填充或替换的块，而使用时只需{\% extends 母版名字 \%}然后调用相应的块就可以了。

模型

在setting.py 中的database的字典中配置数据库。配置完成后 使用manage.py startapp来创建app在models中编写python代码描述实体映射。models.py

1. 创建初始项目

创建新的初始项目指令：
$ django-admin startproject mysite

初始项目的框架构成为：

mysite/
    manage.py  
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

其中，manage.py是命令行工具，用来和本项目交互和管理。
__init__.py用来表明本目录是python包。
setting.py是配置文件，查看项目如何工作。
urls.py是URL声明，就像是网站的“目录”。
asgi.py是ASGI兼容的web服务器入口，用来运行项目。
wsgi.py是WSGI兼容的web服务器入口，用来运行项目。

2. 启动服务器

启动服务器的命令为：
python3 manage.py runserver 0.0.0.0:8000
之后在浏览器输入服务器ip:127.0.0.1:8000,就可以显示了。

用于开发的服务器在需要的情况下会对每一次的访问请求重新载入一遍 Python 代码。所以你不需要为了让修改的代码生效而频繁的重新启动服务器。然而，一些动作，比如添加新文件，将不会触发自动重新加载，这时你得自己手动重启服务器。

3. 创建应用

创建应用的命令为：
python manage.py startapp polls
应用的目录结构为：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

3. 添加视图文件

视图文件是在polls目录下的views.py文件。

内容为：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

当视图文件的index function被调用时，网站会通过http回复string “Hello, world. You're at the polls index.”。

4. 修改URL配置

在polls下创建一个urls.py，内容为：

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

目的是创建url映射到index.
然后在mysite/urls.py的urlpatterns插入一个include().

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]

include()的设计理念是使其可以即插即用，在其他路径下，应用都能正常工作。

path()参数： route, view, kwargs, name.
route -- 匹配url
view -- 调用视图函数

5. 数据库配置

在mysite/settings.py中设置DATABASES 'default' ENGINE后端以及NAME数据库名称。还有USER, PASSWORD, HOST等等。
TIME_ZONE应设置为自己的时区。

INSTALLED_APPS 默认包括了以下 Django 的自带应用：

我们可以通过python manage.py migrate来检查INSTALLED_APPS设置，为其中的每个应用创建需要的数据表，具体取决于mysite/settings.py设置文件和每个应用的数据库迁移文件。

对于MySQL来说，输入SHOW TABLES可以看到Django创建了哪些表。

6. 创建模型

模型在polls/models.py进行创建。这里我们创建两个模型：问题Question和选项Choice。
Question模型包括问题描述和发布时间。Choice模型有两个字段，选项描述和当前得票数。每个选项属于一个问题。

模型被表示为django.db.models.Model类的子类。每个模型有许多类变量，它们都表示模型里的一个数据库字段。

每个字段都是Field类的实例 - 比如，字符字段被表示为CharField，日期时间字段被表示为DateTimeField。这将告诉Django每个字段要处理的数据类型。

每个 Field 类实例变量的名字（例如 question_text 或 pub_date ）也是字段名，所以最好使用对机器友好的格式。你将会在 Python 代码里使用它们，而数据库会将它们作为列名。

定义某些 Field 类实例需要参数或者可选参数 default 。例如 CharField 需要一个 max_length 参数。这个参数的用处不止于用来定义数据库结构，也用于验证数据。

使用 ForeignKey 定义了关系。告诉 Django，每个 Choice 对象都关联到一个 Question 对象。Django 支持所有常用的数据库关系：多对一、多对多和一对一。

7. 激活模型

将polls安装进项目，在INSTALLED_APPS 中添加设置。因为 PollsConfig 类写在文件 polls/apps.py 中，所以它的点式路径是 'polls.apps.PollsConfig'。在文件 mysite/settings.py 中 INSTALLED_APPS 子项添加点式路径。

通过运行python manage.py makemigrations polls， Django 会检测你对模型文件的修改（在这种情况下，你已经取得了新的），并且把修改的部分储存为一次迁移。
通过运行python manage.py sqlmigrate polls 0001， 我们会看到迁移命令会执行哪些 SQL 语句。

改变模型需要这三步：

8. 使用API

通过python manage.py shell来进入交互式Python命令行。manage.py 会设置 DJANGO_SETTINGS_MODULE 环境变量，这个变量会让 Django 根据 mysite/settings.py 文件来设置 Python 包的导入路径。

all(), filter(), include(), exclude(), save(), add(), get(), delete(), count()......

在models.py给模型增加 str() 能使其在命令行里使用更方便。

9. Django管理页面

通过python manage.py createsuperuser键入用户名，邮件地址和密码，创建一个能登录管理页面的用户。

Django 的管理界面默认就是启用的。在'http://127.0.0.1:8000/admin/' 可以看到管理员登录界面。

在polls/admin.py中为Question对象设置一个后台接口。

from django.contrib import admin

from .models import Question

admin.site.register(Question)

进入Question页面后，页面的底部提供了几个选项：

10. 编写更多视图

首先，在你的 polls 目录里创建一个 templates 目录。Django 将会在这个目录里查找模板文件。

你项目的 TEMPLATES 配置项描述了 Django 如何载入和渲染模板。默认的设置文件设置了 DjangoTemplates 后端，并将 APP_DIRS 设置成了 True。这一选项将会让 DjangoTemplates 在每个 INSTALLED_APPS 文件夹中寻找 "templates" 子目录。这就是为什么尽管我们没有像在第二部分中那样修改 DIRS 设置，Django 也能正确找到 polls 的模板位置的原因。

在你刚刚创建的 templates 目录里，再创建一个目录 polls，然后在其中新建一个文件 index.html 。换句话说，你的模板文件的路径应该是 polls/templates/polls/index.html 。因为app_directories 模板加载器是通过上述描述的方法运行的，所以 Django 可以引用到 polls/index.html 这一模板了。

然后在views中使用模板：

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

render()是一个快捷函数。使用它可以不再需要导入 loader 和 HttpResponse 。不过如果你还有其他函数（比如说 detail, results, 和 vote ）需要用到它的话，就需要保持 HttpResponse 的导入。

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)

11. 抛出404

我们可以加入一个try except，如果指定问题 ID 所对应的问题不存在，这个视图就会抛出一个 Http404 异常。

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

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