创建模型
在 Django 里写一个数据库驱动的 Web 应用的第一步是定义模型 - 也就是数据库结构设计和附加的其它元数据。
在这个投票应用中,需要创建两个模型:
问题 Question
和选项 Choice
。
Question
模型包括问题描述和发布时间。
Choice
模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。
我们通过编写mysite/polls/models.py
来创建Question和Choice模型
from django.db import models
# 创建Question模型,并继承models.Model(在数据库中表现为表)
class Question(models.Model):
# 创建question_text属性,即数据库中的question_text列,并指定为CharField字符串属性,最大长度为200
question_text = models.CharField(max_length=200)
# 创建pub_date属性,即数据库中pub_date列,并指定为DateTimeField时间数据
pub_date = models.DateTimeField('date published')
# 创建Choice模型,并继承models.Model(在数据库中表现为表)
class Choice(models.Model):
# 通过ForeignKey创建关联到Question的外链,on_delete属性指定删除外键数据时的操作,CASCED表示同时删除
question = models.ForeignKey(Question, on_delete=models.CASCADE)
# 创建choice_text属性,即数据库中choice_text列,并指定为CharField字符串属性,最大长度为200
choice_text = models.CharField(max_length=200)
# 创建votes属性,即数据库中votes列,并指定为IntegerField数字属性,默认为0
votes = models.IntegerField(default=0)
激活模型
Django 应用是“可插拔”的。你可以在多个项目中使用同一个应用。除此之外,你还可以发布自己的应用,因为它们并不会被绑定到当前安装的 Django 上。
因为Django的应用是可插拔的,所以我们在创建好一个应用之后,需要将项目插入Django项目中,这样我们才可以正常的访问。
插入应用的方式,是需要在mysite/setting - INSTALLED_APPS
中添加设置,因为PollConfig
类写在文件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',
]
...
插入项目之后,我们通过makemigrations
命令把修改的部分转存
python manage.py makemigrations polls
# output
Migrations for 'polls':
polls\migrationspolls/migrations/0001_initial.py
01_initial.py
- Create model Question
- Create model Choice
迁移是 Django 对于模型定义(也就是你的数据库结构)的变化的储存形式 - 它们其实也只是一些你磁盘上的文件。如果你想的话,你可以阅读一下你模型的迁移数据,它被储存在 migrate
里。别担心,你不需要每次都阅读迁移文件,但是它们被设计成人类可读的形式,这是为了便于你手动调整 Django 的修改方式。
Django 有一个自动执行数据库迁移并同步管理你的数据库结构的命令 - 这个命令是 sqlmigrate
,我们马上就会接触它 - 但是首先,让我们看看迁移命令会执行哪些 SQL 语句。python manage.py sqlmigrate polls 0001
命令接收一个迁移的名称,然后返回对应的 SQL:
迁移数据
python manage.py migrate
# output
Operations to perform:
Apply all migrations: admin, auth, contenttypes, polls, sessions
Running migrations:
Applying polls.0001_initial... OK
migrate
这个 django_migrations
命令选中所有还没有执行过的迁移(Django 通过在数据库中创建一个特殊的表 models.py
来跟踪执行过哪些迁移)并应用在数据库上 - 也就是将你对模型的更改同步到数据库结构上。
迁移是非常强大的功能,它能让你在开发过程中持续的改变数据库结构而不需要重新删除和创建表 - 它专注于使数据库平滑升级而不会丢失数据。我们会在后面的教程中更加深入的学习这部分内容,现在,你只需要记住,改变模型需要这三步:
- 编辑
python manage.py makemigrations
文件,改变模型。 - 运行
python manage.py migrate
为模型的改变生成迁移文件。 - 运行
初试API
来应用数据库迁移。
数据库迁移被分解成生成和应用两个命令是为了让你能够在代码控制系统上提交迁移数据并使其能在多个应用里使用;这不仅仅会让开发更加简单,也给别的开发者和生产环境中的使用带来方便。
python manage.py shell
我们可以通过以下命令进入交互界面
>>> from polls.models import Question, Choice
>>> Question.objects.all()
<QuerySet []>
# 创建一个问题,并引入时间模块
>>> from django.utils import timezone
>>> q = Question(question_text="What's new?", pub_date=timezone.now())
>>> q.save() # 保存问题,此时我们可以通过查看数据库发现,question表中已经有一条数据了
>>> q.id
1
# 更改内容
>>> q.question_text="What's up?"
>>> q.save()
>>> Question.objects.all()
<QuerySet [<Question: Question object (1)>]>
进入之后来测试一下数据库API
Question.objects.all()
当我们通过__str__
查看时,接口返回了一个对象细节,但是这个并不是我们想要的,所以我们可以给Question和Choice增加from django.db import models
# Create your models here.
class Question(models.Model):
...
def __str__(self) -> str:
return self.question_text
class Choice(models.Model):
...
def __str__(self) -> str:
return self.choice_text
方法来修复
Question
再为was_published_recently
添加一个自定义方法(这个import datetime
from django.db import models
from django.utils import timezone
# Create your models here.
class Question(models.Model):
...
def was_published_recently(self):
return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
是为了后面做测试使用的,现在可以不用管,就是一个判断)
python manage.py shell
然后,我们再次通过shell来调用api试试
>>> from polls.models import Question, Choice
>>> from django.utils import timezone
# Django提供了一个关键字查找的API
>>> Question.objects.filter(id=1)
<QuerySet [<Question: What's up?>]>
# 通过查询年份来获取
>>> current_year = timezone.now().year
>>> Question.objects.get(pub_date__year=current_year)
<Question: What's up?>
# 通过主键查询
>>> Question.objects.get(pk=1)
<Question: What's up?>
# 验证自定义函数was_published_recently
>>> q = Question.objects.get(pk=1)
>>> q.was_published_recently()
True
# 下面通过API创建一个问题的答案并验证
# 查看现有问题答案
>>> q = Question.objects.get(pk=1)
>>> q.choice_set.all()
<QuerySet []>
# 创建问题答案
>>> q.choice_set.create(choice_text='Not much', votes=0)
<Choice: Not much>
>>> q.choice_set.create(choice_text='The sky', votes=0)
<Choice: The sky>
>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0)
>>> c.question
<Question: What's up?>
# 通过Question的对象也可以访问问题答案
>>> q.choice_set.all()
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
>>> q.choice_set.count()
3
>>> Choice.objects.filter(question__pub_date__year=current_year)
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
# Let's delete one of the choices. Use delete() for that.
>>> c = q.choice_set.filter(choice_text__startswith='Just hacking')
>>> c.delete()
创建管理员
python manage.py createsuperuser
我们可以通过运行以下命令来创建一个可以登录管理页面的用户(然后输入用户名/邮箱/密码)
python manage.py runserver 0.0.0.0:8000
创建完成后,通过127.0.0.1:8000/admin
来启动django,并通过本机浏览器访问polls.py/admin.py
[图片上传失败...(image-5a00ad-1678067471566)]
我们可以看到Django的页面,这些是默认初始的架构里的组件,但是并没有看到polls投票的应用,因为,这个还需要在from django.contrib import admin
from .models import Question
# Register your models here.
admin.site.register(Question)
,给polls增加一个后台接口,这样Django才能将polls添加到后台里面
重新启动Django后,我们可以看到添加的polls应用,以及Question选项