django笔记--2

数据库配置

打开 mysite/settings.py 。这是个包含了 Django 项目设置的 Python 模块。

通常，这个配置文件使用SQLite作为默认数据库。python内置SQLite，所以无需安装额外东西即可使用它。

当开始一个真正的项目时，可能更倾向使用一个更具扩展性的数据库，如PostgreSQL,避免中途切换数据库这个令人头疼的问题。

如果想使用其他数据库，需要安装合适的 database bindings，然后改变设置文件中 DATABASES 'default' 项目中的一些键值：

• ENGINE ——可选值有：

  • django.db.backends.sqlite3
  • django.db.backends.postgresql
  • django.db.backends.mysql
  • django.db.backends.oracle

• NAME ——数据库的名称。

  • 使用SQLite，数据库将是电脑上的一个文件，这种情况下，NAME应该是此文件的完整的绝对路径，包括文件名。（默认值BASE_DIR / 'db.sqlite3'将把数据库文件存储在项目的根目录。）
  • 不使用SQLite，则必须添加一些额外设置，如USER、PASSWORD、HOST等等。参考文档

示例:

# 使用SQlite
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': 'mydatabase',
    }
}


# 不使用SQLite示例：
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}

• 编辑 mysite/settings.py 文件前，先设置 TIME_ZONE 为自己的时区。

  • 旧版模板默认为 'America/Chicago',新版默认为'UTC'
  • 注意：这不一定是服务器的时区，比如一个服务器可以搭建多个由Django驱动的站点，每个站点都有单独的时区设置。
  • 详细文档
  • 中国时区只需要更改为 'Asia/Shanghai'

• 还需要关注一下头部文件的 INSTALLED_APPS 设置项。
  这里包括了会在项目中启用的所有 Django 应用。应用能在多个项目中使用，也可以打包并发布应用，让别人用。

通常，INSTALLEN_APPS 默认包括了一下 Django 的自带应用：  
      1. django.contrib.admin -- 管理员站点。
      2. django.contrib.auth -- 认证授权系统。
      3. django.contrib.contenttypes -- 内容类型框架。
      4. django.contrib.sessions -- 会话框架。
      5. django.contrib.messages -- 消息框架。
      6. django.contrib.staticfiles -- 管理静态文件的框架。

这些应用被默认启用是为了给常规项目提供方便。

默认开启的某些应用需要至少一个数据表，所以，在使用他们之前需要在数据库中创建一些表。请执行以下命令：

python manage.py migrate

这个 migrate 命令检查 INSTALLED_APPS 设置，为其中的每个应用创建需要的数据表，至于具体会创建什么，这取决于你的 mysite/settings.py 设置文件和每个应用的数据库迁移文件。这个命令所执行的每个迁移操作都会在终端中显示出来。

如果你感兴趣的话，运行你数据库的命令行工具，并输入 dt (PostgreSQL)， SHOW TABLES; (MariaDB,MySQL)， .schema (SQLite)或者 SELECT TABLE_NAME FROM USER_TABLES; (Oracle) 来看看 Django 到底创建了哪些表。

给极简主义者:为了方便大多数项目，默认激活了一些应用，但并不是每个人都需要它们。如果你不需要某个或某些应用，你可以在运行 migrate 前毫无顾虑地从 INSTALLED_APPS 里注释或者删除掉它们。 migrate 命令只会为在 INSTALLED_APPS 里声明了的应用进行数据库迁移。

---

创建模型

在Django里写一个数据库驱动的web应用的第一步是定义模型--也就是使用数据库结构设计和附加的其他元数据。

设计哲学：模型是真实数据的简单明确的描述。它包含了储存的数据所必要的字段和行为。Django遵循DRY Principle。它的目标是你只需要定义数据模型，然后其他的代码都不需要关心，他们会自动从模型生成。
迁移：不想Ruby On Rails，Django 的迁移代码是由模型文件自动生成的，它本质上是个历史记录，Django 可以用它来进行数据库的滚动更新，通过这种方式使其能够和当前的模型匹配。

在这个投票应用中，需要两个模型：
1. 问题 Question
    1） 问题描述
    2） 发布时间
2. 选项 Choice
    1） 选项描述
    2） 当前得票数
每个选项属于一个问题。

这些概念可以通过一个 Python 类来描述。按下例编辑 polls/models.py 文件：

from django.db import models


class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')


class Choice(models.Model):
    question = models.ForeignKey(Question, on_delete=models.CASCADE)
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

• 模型
  • 每个模型都被表示为 django.db.models.Model 类的子类。
  • 每个模型有许多变量，他们都表示模型里的一个数据库字段。
• 字段 或 Field
  • 每个字段都是 Field 类的实例。
    • 字符字段被表示为 CharField
    • 日期时间字段被表示为 DateTimeField
    • 这将高速Django每个字段要处理的数据类型。
  • 每个 Field 类实例变量的名字也是字段名
    • 例如：question_text 或 pub_date
    • 最好使用对机器友好的格式。
      • 我们将会在 python diamante里使用他们
      • 数据库也会将他们作为列名
  • 用可选项为 field 定义一个人类可读的名字。
    • 这个功能在很多 Django 内部组成部分中都被使用了，而且作为文档的一部分。
    • 如果某个字段没有提供此名称，Django 将会使用对机器友好的名称，也就是变量名。
      • 上例中，只有 Question.pub_date 定义了对人类友好的名字
      • 对于模型内的其他字段，他们的机器友好名也会被作为人类友好名使用
  • 定义某些 Field 类实例需要参数。
    • 如：CharField 需要一个 max_length 参数。
      • 用来定义数据库结构
      • 用来验证数据
  • Field 也能接收多个可选参数
    • 如：将 votes 的 default 也就是默认值，设为0
• 关系
  • 使用 ForeignKey 定义了一个关系。
    • 这将告诉 Django，每个 Choice 对象都关联到一个 Question 对象。
  • Django 支持所有常用的数据库关系：
    • 多对一
    • 多对多
    • 一对一

---

激活模型

上面的一段代码用于创建模型的代码给了 Django 很多信息，通过这些信息，Django 可以：

• 为这个应用创建数据库 schema （生成 CREATE TABLE语句）。
• 创建可以与 Question 和 Choice 对象进行交互的 Python 数据库 API

首先要把 polls 应用安装到项目。

设计哲学
Django 应用是“可插拔”的。你可以在多个项目中使用同一个应用。初次之外，还可以发布自己的应用，因为他们并不会被绑定到单签安装的 Django 上。

为了在我们的工程中包含这个应用，我们需要在配置类 INSTALLED_APPS 中添加设置。
因为 PollsConfig 类写在文件 polls/apps.py 中，所以它的路径是 'polls.apps.PollsConfig'。在文件 mysite/settings.py 中 INSTALLED_APPS 子项添加点式路径后，像这样：

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

现在 Django 就包含了 polls 应用。运行如下命令：

python manage.py makemigrations polls

可以看到类似下面的输出：

Migrations for 'polls':
  polls/migrations/0001_initial.py
    - Create model Question
    - Create model Choice

通过运行 makemigrations 命令，Django会检测你对模型文件的修改（在这种情况下，你已经取得了新的），并且吧修改的部分存储为依次 迁移。

迁移是 Django 对于模型定义（也就是你的数据库结构）的变化的存储形式--他们其实也只是你磁盘上的文件。
如果需要，可以看一下模型的迁移数据，它被存储在 polls/igrations/0001_initial.py 里。不需要每次都月度迁移文件，但是他们被设计成为人类可读的形式，这是为了便于你手动调整 Django 的修改方式。

Django 有一个自动执行数据库迁移并同步管理数据库结构的命令--migrate
sqlmigrate 命令接收一个迁移的名称，然后返回对应的SQL：

python manage.py sqlmigrate polls 0001

将会看到类似下面的输出：

BEGIN;
--
-- Create model Question
--
CREATE TABLE "polls_question" (
    "id" serial NOT NULL PRIMARY KEY,
    "question_text" varchar(200) NOT NULL,
    "pub_date" timestamp with time zone NOT NULL
);
--
-- Create model Choice
--
CREATE TABLE "polls_choice" (
    "id" serial NOT NULL PRIMARY KEY,
    "choice_text" varchar(200) NOT NULL,
    "votes" integer NOT NULL,
    "question_id" integer NOT NULL
);
ALTER TABLE "polls_choice"
  ADD CONSTRAINT "polls_choice_question_id_c5b4b260_fk_polls_question_id"
    FOREIGN KEY ("question_id")
    REFERENCES "polls_question" ("id")
    DEFERRABLE INITIALLY DEFERRED;
CREATE INDEX "polls_choice_question_id_c5b4b260" ON "polls_choice" ("question_id");

COMMIT;

注意以下几点：

• 输出的内容和你使用的数据库有关，上面的输出示例使用的是 PostgreSQL。
• 数据库的表名是由应用名(polls)和模型名的小写形式( question 和 choice)连接而来。（如果需要，你可以自定义此行为。）
• 主键(IDs)会被自动创建。(当然，你也可以自定义。)
• 默认的，Django 会在外键字段名后追加字符串 "_id" 。（同样，这也可以自定义。）
• 外键关系由 FOREIGN KEY 生成。你不用关心 DEFERRABLE 部分，它只是告诉 PostgreSQL，请在事务全都执行完之后再创建外键关系。
• 生成的 SQL 语句是为你所用的数据库定制的，所以那些和数据库有关的字段类型，比如 auto_increment (MySQL)、 serial (PostgreSQL)和 integer primary key autoincrement (SQLite)，Django 会帮你自动处理。那些和引号相关的事情 - 例如，是使用单引号还是双引号 - 也一样会被自动处理。
• 这个 sqlmigrate 命令并没有真正在你的数据库中的执行迁移 - 相反，它只是把命令输出到屏幕上，让你看看 Django 认为需要执行哪些 SQL 语句。这在你想看看 Django 到底准备做什么，或者当你是数据库管理员，需要写脚本来批量处理数据库时会很有用。

如果你感兴趣，你也可以试试运行 python manage.py check ;这个命令帮助你检查项目中的问题，并且在检查过程中不会对数据库进行任何操作。

现在，再次运行 migrate 命令，在数据库里创建新定义的模型的数据表：

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, polls, sessions
Running migrations:
  Rendering model states... DONE
  Applying polls.0001_initial... OK

这个 migrate 命令选中所有还没有执行过的迁移（Django 通过在数据库中创建一个特殊的表 django_migrations 来跟踪执行过哪些迁移）并应用在数据库上 - 也就是将你对模型的更改同步到数据库结构上。

迁移是非常强大的功能，它能让你在开发过程中持续的改变数据库结构而不需要重新删除和创建表 - 它专注于使数据库平滑升级而不会丢失数据。我们会在后面的教程中更加深入的学习这部分内容，现在，你只需要记住，改变模型需要这三步：

1. 编辑 models.py 文件，改变模型。
2. 运行 python manage.py makemigrations 为模型的改变生成迁移文件。
3. 运行 python manage.py migrate 来应用数据库迁移。

数据库迁移被分解成生成和应用两个命令是为了让你能够在代码控制系统上提交迁移数据并使其能在多个应用里使用；这不仅仅会让开发更加简单，也给别的开发者和生产环境中的使用带来方便。

---

初试 API

同过python manage.py shell命令可以进入交互式python命令行。
使用这个命令而不是简单的使用python是因为 manage.py 会设置 DJANGO_SETTINGS_MODULE 环境变量，这个变量会让 Django 根据 mysite/settings.py 文件来设置 python 包的导入路径。

当成功进入命令行后，就可以试试 database API 了。

官方教程

---

介绍 Django 管理页面

设计哲学
为你的员工或客户生成一个用户添加，修改和删除内容的后台是一项缺乏创造性和乏味的工作。因此，Django 全自动地根据模型创建后台界面。
Django 产生于一个公众页面和内容发布者页面完全分离的新闻站点的开发过程中。站点管理人员使用管理系统来添加新闻、事件和体育时讯等，这些添加的内容被显示在公众页面上。Django通过未站点管理人员创建统一的内容编辑界面解决了这个问题。
管理界面不是为了网站的访问者，而是为了管理者准备的。

创建管理员账号

$ python manage.py createsuperuser       # 创建超级用户
Username: admin        # 输入用户名
Email address: admin@example.com            # 输入邮箱地址
Password: ******                  # 输入密码
Password(again): ******            # 重复密码
Superuser created successfully.

启动开发服务器

Django 的管理界面默认就是启动的。
如果开发服务器未启动，用以下命令启动它：
python manage.py runserver

打开浏览器，跳转到本地域名下的/admin/目录，就可以看到管理员登录界面。比如（默认）：“http://127.0.0.1:8000/admin/”

因为翻译功能是开启的，如果你设置了"mysite/setting.py"文件的LABGYAGE_CODE，登录界面将显示你设置的语言（如果 Django 有相应的翻译）。

中文设置：在mysite/setting.py文件下设置 LANGUAGE_CODE = 'zh-hans' 即可。

---

进入管理站点页面

用超级用户登录后就可以看到可编辑的内容：组和用户。他们是由 django.contrib.auth 提供的，这是 Django 开发的认证框架。

---

向管理页面中加入投票应用

我们得告诉管理员，问题 Question 对象需要一个后台接口。打开 polls/admin.py 文件，编辑成如下样子：

from django.contrib import admin

from .models import Question

admin.site.register(Question)

体验便捷的管理功能

现在我们想管理页面注册了问题 Question 类。 Django 知道它应该被显示在索引页里。

• 注意事项：
  • 这个表单是从问题 Question 模型中自动生成的
  • 不同的字段类型（日期时间字段DateTimeField、字符字段CharField）会生成对应的 HTML 输入控件。每个类型的字段都知道他们应该如何在管理页面里显示自己。
  • 每个日期时间字段DateTimeField都有JavaScript写的快捷按钮。日期有转到今天（Today）的快捷按钮和一个弹出式日历界面。时间有设为现在（Now）的快捷按钮和一个列出常用时间的方便的弹出列表。
• 页面的底部提供几个选项：
  • 保存（Save）-保存改变，然后返回对象列表。
  • 保存并继续编辑（Save and continue editing）-保存改变，然后重新载入当前对象的修改界面。
  • 保存并新增（Save and add another）-保存改变，然后添加一个新的孔对象并载入修改界面。
  • 删除（Delete）-显示一个确认删除页面。

如果显示的 “发布日期(Date Published)” 和你在 教程 1 里创建它们的时间不一致，这意味着你可能没有正确的设置 TIME_ZONE 。改变设置，然后重新载入页面看看是否显示了正确的值。

通过点击 “今天(Today)” 和 “现在(Now)” 按钮改变 “发布日期(Date Published)”。然后点击 “保存并继续编辑(Save and add another)”按钮。然后点击右上角的 “历史(History)”按钮。你会看到一个列出了所有通过 Django 管理页面对当前对象进行的改变的页面，其中列出了时间戳和进行修改操作的用户名.

2020.12.9
hare