完整教程https://www.daimapi.com/django/intro/tutorial02/
编写你的第一个 Django 应用,第 2 部分¶
这部分教程从教程第 1 部分结尾的地方继续讲起。我们将建立数据库,创建您的第一个模型,并主要关注 Django 提供的自动生成的管理页面。
数据库配置¶
现在,打开mysite/settings.py。这是个包含了 Django 项目设置的 Python 模块。
通常,这个配置文件使用 SQLite 作为默认数据库。如果你不熟悉数据库,或者只是想尝试下 Django,这是最简单的选择。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应该是此文件的绝对路径,包括文件名。默认值os.path.join(BASE_DIR, 'db.sqlite3')将会把数据库文件储存在项目的根目录。
如果你不使用 SQLite,则必须添加一些额外设置,比如USER、PASSWORD、HOST等等。想了解更多数据库设置方面的内容,请看文档:DATABASES。
SQLite 以外的其它数据库
如果你使用了 SQLite 以外的数据库,请确认在使用前已经创建了数据库。你可以通过在你的数据库交互式命令行中使用 "CREATE DATABASE database_name;" 命令来完成这件事。
另外,还要确保该数据库用户中提供mysite/settings.py具有 "create database" 权限。这使得自动创建的test database能被以后的教程使用。
如果你使用 SQLite,那么你不需要在使用前做任何事——数据库会在需要的时候自动创建。
编辑mysite/settings.py文件前,先设置TIME_ZONE为你自己时区。
此外,关注一下文件头部的INSTALLED_APPS设置项。这里包括了会在你项目中启用的所有 Django 应用。应用能在多个项目中使用,你也可以打包并且发布应用,让别人使用它们。
通常,INSTALLED_APPS默认包括了以下 Django 的自带应用:
django.contrib.admin-- 管理员站点, 你很快就会使用它。
django.contrib.auth-- 认证授权系统。
django.contrib.contenttypes-- 内容类型框架。
django.contrib.sessions-- 会话框架。
django.contrib.messages-- 消息框架。
django.contrib.staticfiles-- 管理静态文件的框架。
这些应用被默认启用是为了给常规项目提供方便。
默认开启的某些应用需要至少一个数据表,所以,在使用他们之前需要在数据库中创建一些表。请执行以下命令:
$ python manage.py migrate
这个migrate命令检查INSTALLED_APPS设置,为其中的每个应用创建需要的数据表,至于具体会创建什么,这取决于你的mysite/settings.py设置文件和每个应用的数据库迁移文件(我们稍后会介绍这个)。这个命令所执行的每个迁移操作都会在终端中显示出来。如果你感兴趣的话,运行你数据库的命令行工具,并输入\dt(PostgreSQL),SHOWTABLES;(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 可以用它来进行数据库的滚动更新,通过这种方式使其能够和当前的模型匹配。
在这个简单的投票应用中,需要创建两个模型:问题Question和选项Choice。Question模型包括问题描述和发布时间。Choice模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。
这些概念可以通过一个简单的 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)