第二节:模型(Models)和管理后台(Admin site)

本节内容我们将配置数据库,创建第一个model并且快速了解Django自动生成的管理后台(admin site)

目录

数据库配置

打开上一节中新建的项目的配置文件,它是一个普通的python模块。

默认情况下,数据库配置使用SQLite,如果你数据库的新手,或者你仅仅是对Django感兴趣,这是最好的选择。SQLite包含在Python,所以不需要安装任何东西。当你开始你的第一个真正的项目的时候,你可能想

要使用更强大的数据库如PostgreSQL,去避免切换数据库的痛苦。

如果你希望使用另外一个数据库,需要安装对应的数据库驱动并且修改键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以外的数据库,请确保你已经创建了一个数据库,也要确保在mysite/settings.py中提供的用户具有“创建数据库”的权限,允许自动创建一个测试数据库在后面的教程中将会用。如果你使用SQLite不需要做任何事情,数据库文件将会在你需要的时候自动创建。

另外,注意在mysite/settings.py文件的顶部INSTALLED_APPS设置,里面包含当前项目中所有被激活的Django应用的名称。应用可以在多个项目中使用,你可以打包并分发给其他的项目使用。

默认情况下,INSTALLED_APPS包含如下应用:

  • django.contrib.admin - 一个管理后台。下面很快将会用到它
  • django.contrib.auth - 一个认证系统。
  • django.contrib.contenttypes - 一个文档内容类型的框架
  • django.contrib.sessions - 一个session框架
  • django.contrib.messages - 一个消息框架

这些应用至少使用数据库中的一个表,虽然如此,在我们使用它们之前我们需要在一个数据库里面创建表,可以运行下面的命令做到它:

$ python manage.py migrate

migrate命令将查找INSTALLED_APPS的设置,并且创建符合你在mysite/settings.py文件中配置的数据库的任何有必要的数据库表并且随应用迁移,如果说INSTALLED_APPS里面的应用不需要的话那么在运行migrate之前把它注释或删除掉即可。

创建模型

现在我们定义模型,在我们创建的投票应用中,我们创建两个模型:QuestionChoice。Question模型有一个问题内容和一个发布时间。Choice有两个字段:选择文本和投票数。ChoiceQuestion是多对一的关系。

这些概念我们用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类的实例来表示,例如,CharField代表字符字段和DateTimeField代表日期字段。这就告诉Django每一个字段是什么数据类型。Field类的实例的名称(如,choice_text),就是数据库表的字段名。

有些Field类是需要必须参数的,比如CharField,必须要提供max_length的参数。它不仅仅会在数据库架构中用,在验证中也会用到。一个字段可以有多个可选参数,在本例中,我们设置votes的默认值为0;

最后,注意在本例中使用ForeignKey定义了一个关系,它告诉Django每个Choice对应一个Question。Django支持所有的数据库关系:多对一,多对多,一对一。

激活模型

简单的模型定义告诉Django很多信息,有了他,Django可以:

  • 创建一个针对这个应用的数据库架构。
  • 创建一个Python数据库访问API来访问QuestionChoice对象。

但是首先需要告诉我们的Django项目polls应用已经被安装了。再次编辑mysite/settings.py文件,修改INSTALLED_APPS,把'polls.apps.PollsConfig'加入列表,如下所示:

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

  注意:INTALLED_APPS列表直接写应用的名称也是可以的(如,'polls'),官方建议是写AppConfig的子类,'polls.apps.PollsConfig'PollsConfig,这个类在创建应用时已经自动创建好了,在polls/apps.py文件里面定义,这个类里面可以定义关于应用的一些元数据如应用名称,描述等信息,Django提供了一些公用API可以读取里面的配置信息,暂时没有发现其他什么特别的用处。

现在Django已经知道包含了polls应用了,运行另外一个命令:

$ python manage.py makemigrations polls

你可以看到如下的内容:

Migrations for 'polls':
polls/migrations/0001_initial.py:
- Create model Choice
- Create model Question
- Add field question to choice

通过运行makemigrations,就是告诉Django项目模型已经有了那些修改,并且存储这些修改信息在polls/migrations/0001_initial.py文件中。

如果你想查看迁移将在数据库中执行哪些操作,可以运行命令:

$ python manage.py sqlmigrate polls 0001

你将可以看到迁移所用到的Sql语句。

注意以下几点:

  • 输出的内容会根据你使用的数据库的不同而不同。
  • 表明是通过合并应用名称和模型名字的小写自动生成的(如,polls_question)(可以重写)。
  • 主键(id)是自动添加的(可以重写)
  • 通常情况下,Django会在模型名字基础上追加“_id”作为外键字段的名字。(可以重写)
  • sqlmigrate命令不在数据库上更改,仅仅是打印迁移的sql语句。

如果你感兴趣的话可以运行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

迁移的命令是非常强大的,让你可以随时修改你的模型,而不需要删除你的数据库或表,可以很方便升级你的数据库,不会丢失数据,后面会详细介绍他们,现在你只要记住需要三步来应用模型的变化:

  • 修改模型(在models.py)。
  • 运行python manage.py makemigrations创建这些修改迁移。
  • 运行python manage.py migrate应用这些修改到数据库。

使用API

现在,让我们进入Python shell的交互式环境并且使用Django提供的免费API。使用如下命令进入python shell:

$ python manage.py shell

这个命令是进入我们项目的shell交互环境,现在我们可以使用API来操作表:

# 创建一个问题,Django默认有日期模块,所以这儿使用timezone
>>> from django.utils import timezone
>>> q = Question(question_text=”What’s New?”,pub_date=timezone.now())
# 保存对象到数据库,你必须明确调用save()方法
>>> q.save()
# 现在你可以访问model字段的值了
>>> q.id
1
>>> q.question_text
What’s new?”
# 修改你要修改的属性,然后调用save()方法
>>> q.question_text=”What’s up?”
>>> q.save()
# 查询所有问题信息
>>> Question.objects.all()
<QuerySet [<Question: Question object>]>
# 查询投票选择
>>> q.choice_set.all()

上面的查询信息返回<QuerySet [<Question: Question object>]>,我们不知道这个对象都有什么东西,那么怎么解决这个问题呢,接下来分别在QuestionChoice增加__str__方法,编辑文件polls/models.py

from django.db import models
from django.utils.encoding import python_2_unicode_compatible @python_2_unicode_compatible # 如果需要支持python 2.x的话,加上这个修饰符
class Question(models.Model):
# ...
def __str__(self):     # 在python 2.x中,函数名为__unicode__
return self.question_text @python_2_unicode_compatible # 如果需要支持python 2.x的话,加上这个修饰符
class Choice(models.Model):
# ...
def __str__(self):     # 在python 2.x中,函数名为__unicode__
return self.choice_text

再次进入python shell环境,查看所有信息:

>>> Question.objects.all()
<Question: What’s up>

介绍Django管理后台

这个后台主要是方便客户或员工来管理网站内容的

创建管理员

首先我们需要创建一个可以登录到管理站点的用户,运行下面的命令:

$ python manage.py createsuperuser

按照提示输入用户名、邮箱地址、密码;现在管理员用户已经创建好了,输入命令python manage.py runserver启动开发服务器,然后在浏览器输入地址 http://127.0.0.1:8000/amdin,就可以用我们刚刚创建的用户登录系统。

将应用注册到管理系统

登录后系统我们发现,在管理界面首页并没有我创建的投票应用,那么现在我们来看一下我们的应用如何注册到管理系统,编辑文件polls/admin.py

from django.contrib import admin

from .models import Question

admin.site.register(Question)

现在Question已经注册了,打开后台管理的首页就可以看到我们的应用:

第二节:模型(Models)和管理后台(Admin site)

现在你可以对Question进行管理了。

注意一下几点:

  • 表单是根据Question模型,自动生成的。
  • 不同的模型字段类型由相应的HTML输入组件表示。

注意:在后台管理系统设置好后,如果系统的图片都显示不出来,需要在mysite/settings.py 加入如下设置:

import mimetypes

mimetypes.add_type("image/svg+xml", ".svg", True)
mimetypes.add_type("image/svg+xml", ".svgz", True)

可能是因为系统中没有SVG媒体类型的设置。

上一篇:在Java中动态传参调用Python脚本


下一篇:linux – avahi-daemon从我的网络接口中提取IP地址