我们首先创建Django项目并为其添加虚拟环境和依赖项。接下来,在项目下创建名为polls
的应用和保存模板页的文件夹tempaltes
,项目文件夹的结构如下所示。
根据上面描述的项目需求,我们准备了四个静态页面,分别是展示学科的页面subjects.html
,显示学科老师的页面teachers.html
,登录页面login.html
,注册页面register.html
,稍后我们会将静态页修改为Django项目所需的模板页。
在MySQL中创建数据库,创建用户,授权用户访问该数据库。
在MySQL中创建保存学科和老师信息的二维表(保存用户信息的表稍后处理)。
use vote;
-- 创建学科表
create table `tb_subject`
(
`no` integer auto_increment comment '学科编号',
`name` varchar(50) not null comment '学科名称',
`intro` varchar(1000) not null default '' comment '学科介绍',
`is_hot` boolean not null default 0 comment '是不是热门学科',
primary key (`no`)
);
-- 创建老师表
create table `tb_teacher`
(
`no` integer auto_increment comment '老师编号',
`name` varchar(20) not null comment '老师姓名',
`sex` boolean not null default 1 comment '老师性别',
`birth` date not null comment '出生日期',
`intro` varchar(1000) not null default '' comment '老师介绍',
`photo` varchar(255) not null default '' comment '老师照片',
`gcount` integer not null default 0 comment '好评数',
`bcount` integer not null default 0 comment '差评数',
`sno` integer not null comment '所属学科',
primary key (`no`),
foreign key (`sno`) references `tb_subject` (`no`)
);
在虚拟环境中安装连接MySQL数据库所需的依赖项。
pip install mysqlclient
修改项目的settings.py文件,首先将我们创建的应用
polls
添加已安装的项目(INSTALLED_APPS
)中,然后配置MySQL作为持久化方案。INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'polls',
]
DATABASES = {
'default': {
# 数据库引擎配置
'ENGINE': 'django.db.backends.mysql',
# 数据库的名字
'NAME': 'vote',
# 数据库服务器的IP地址(本机可以写localhost或127.0.0.1)
'HOST': 'localhost',
# 启动MySQL服务的端口号
'PORT': 3306,
# 数据库用户名和口令
'USER': 'hellokitty',
'PASSWORD': 'Hellokitty.618',
# 数据库使用的字符集
'CHARSET': 'utf8',
# 数据库时间日期的时区设定
'TIME_ZONE': 'Asia/Chongqing',
}
}
在配置ENGINE属性时,常用的可选值包括:
'django.db.backends.sqlite3'
:SQLite嵌入式数据库。'django.db.backends.postgresql'
:BSD许可证下发行的开源关系型数据库产品。'django.db.backends.mysql'
:甲骨文公司经济高效的数据库产品。'django.db.backends.oracle'
:甲骨文公司关系型数据库旗舰产品。
其他的配置可以参考官方文档中的部分。
Django框架提供了ORM来解决数据持久化问题,ORM翻译成中文叫“对象关系映射”。因为Python是面向对象的编程语言,我们在Python程序中使用对象模型来保存数据,而关系型数据库使用关系模型,用二维表来保存数据,这两种模型并不匹配。使用ORM是为了实现对象模型到关系模型的双向转换,这样就不用在Python代码中书写SQL语句和游标操作,因为这些都会由ORM自动完成。利用Django的ORM,我们可以直接将刚才创建的学科表和老师表变成Django中的模型类。
python manage.py inspectdb > polls/models.py
我们可以对自动生成的模型类稍作调整,代码如下所示。
```Python from django.db import models
class Subject(models.Model): no = models.AutoField(primary_key=True, verbose_name=’编号’) name = models.CharField(max_length=50, verbose_name=’名称’) intro = models.CharField(max_length=1000, verbose_name=’介绍’) is_hot = models.BooleanField(verbose_name=’是否热门’)
class Meta:
managed = False
db_table = 'tb_subject'
class Teacher(models.Model): no = models.AutoField(primary_key=True, verbose_name=’编号’) name = models.CharField(max_length=20, verbose_name=’姓名’) sex = models.BooleanField(default=True, verbose_name=’性别’) birth = models.DateField(verbose_name=’出生日期’) intro = models.CharField(max_length=1000, verbose_name=’个人介绍’) photo = models.ImageField(max_length=255, verbose_name=’照片’) good_count = models.IntegerField(default=0, db_column=’gcount’, verbose_name=’好评数’) bad_count = models.IntegerField(default=0, db_column=’bcount’, verbose_name=’差评数’) subject = models.ForeignKey(Subject, models.DO_NOTHING, db_column=’sno’)
class Meta:
managed = False
db_table = 'tb_teacher'
新增
from polls.models import Subject
subject1 = Subject(name='Python全栈开发', intro='当下最热门的学科', is_hot=True)
subject1.save()
subject2 = Subject(name='全栈软件测试', intro='学习自动化测试的学科', is_hot=False)
subject2.save()
subject3 = Subject(name='JavaEE分布式开发', intro='基于Java语言的服务器应用开发', is_hot=True)
删除
subject = Subject.objects.get(no=2)
subject.delete()
更新
subject.name = 'Python全栈+人工智能'
subject.save()
查询
- 查询所有对象。
Subjects.objects.all()
- 过滤数据。
# 查询名称为“Python全栈+人工智能”的学科
Subject.objects.filter(name='Python全栈+人工智能')
# 查询名称包含“全栈”的学科(模糊查询)
Subject.objects.filter(name__contains='全栈')
Subject.objects.filter(name__startswith='全栈')
Subject.objects.filter(name__endswith='全栈')
# 查询所有热门学科
Subject.objects.filter(is_hot=True)
# 查询编号大于3小于10的学科
Subject.objects.filter(no__gt=3).filter(no__lt=10)
Subject.objects.filter(no__gt=3, no__lt=10)
# 查询编号在3到7之间的学科
Subject.objects.filter(no__ge=3, no__le=7)
Subject.objects.filter(no__range=(3, 7))
- 查询单个对象。
# 查询主键为1的学科
Subject.objects.get(pk=1)
Subject.objects.get(no=1)
Subject.objects.filter(no=1).first()
Subject.objects.filter(no=1).last()
- 排序。
# 查询所有学科按编号升序排列
Subject.objects.order_by('no')
# 查询所有部门按部门编号降序排列
Subject.objects.order_by('-no')
- 切片(分页查询)。
- 计数。
# 查询一共有多少个学科
Subject.objects.count()
- 高级查询。
# 查询编号为1的学科的老师
Teacher.objects.filter(subject__no=1)
Subject.objects.get(pk=1).teacher_set.all()
# 查询学科名称有“全栈”二字的学科的老师
Teacher.objects.filter(subject__name__contains='全栈')
在创建好模型类之后,可以通过Django框架自带的后台管理应用(admin
应用)实现对模型的管理。虽然实际应用中,这个后台可能并不能满足我们的需求,但是在学习Django框架时,我们可以利用admin
应用来管理我们的模型,同时也通过它来了解一个项目的后台管理系统需要哪些功能。使用Django自带的admin
应用步骤如下所示。
将
admin
应用所需的表迁移到数据库中。admin
应用本身也需要数据库的支持,而且在admin
应用中已经定义好了相关的数据模型类,我们只需要通过模型迁移操作就能自动在数据库中生成所需的二维表。python manage.py migrate
创建访问
admin
应用的超级用户账号,这里需要输入用户名、邮箱和口令。python manage.py createsuperuser
运行项目,在浏览器中访问
http://127.0.0.1:8000/admin
,输入刚才创建的超级用户账号和密码进行登录。登录后进入管理员操作平台。
注意,我们暂时还没能在
admin
应用中看到之前创建的模型类,为此需要在polls
应用的admin.py
文件中对需要管理的模型进行注册。注册模型类。
from django.contrib import admin
from polls.models import Subject, Teacher
admin.site.register(Subject)
admin.site.register(Teacher)
注册模型类后,就可以在后台管理系统中看到它们。
对模型进行CRUD操作。
可以在管理员平台对模型进行C(新增)、R(查看)、U(更新)、D(删除)操作,如下图所示。
添加学科。
查看所有学科。
-
注册模型管理类。
可能大家已经注意到了,刚才在后台查看部门信息的时候,显示的部门信息并不直观,为此我们再修改
admin.py
文件,通过注册模型管理类,可以在后台管理系统中更好的管理模型。```Python from django.contrib import admin
from polls.models import Subject, Teacher
class SubjectModelAdmin(admin.ModelAdmin): list_display = (‘no’, ‘name’, ‘intro’, ‘is_hot’) search_fields = (‘name’, ) ordering = (‘no’, )
class TeacherModelAdmin(admin.ModelAdmin): list_display = (‘no’, ‘name’, ‘sex’, ‘birth’, ‘good_count’, ‘bad_count’, ‘subject’) search_fields = (‘name’, ) ordering = (‘no’, )
admin.site.register(Subject, SubjectModelAdmin) admin.site.register(Teacher, TeacherModelAdmin)


为了更好的查看模型,我们为`Subject`类添加`__str__`魔法方法,并在该方法中返回学科名字。这样在如上图所示的查看老师的页面上显示老师所属学科时,就不再是`Subject object(1)`这样晦涩的信息,而是学科的名称。
### 实现学科页和老师页效果
1. 修改`polls/views.py`文件,编写视图函数实现对学科页和老师页的渲染。
```Python
from django.shortcuts import render, redirect
from polls.models import Subject, Teacher
def show_subjects(request):
subjects = Subject.objects.all().order_by('no')
return render(request, 'subjects.html', {'subjects': subjects})
def show_teachers(request):
try:
sno = int(request.GET.get('sno'))
teachers = []
if sno:
subject = Subject.objects.only('name').get(no=sno)
teachers = Teacher.objects.filter(subject=subject).order_by('no')
return render(request, 'teachers.html', {
'subject': subject,
'teachers': teachers
})
except (ValueError, Subject.DoesNotExist):
return redirect('/')
修改
templates/subjects.html
和templates/teachers.html
模板页。subjects.html
<!DOCTYPE html>
<head>
<meta charset="UTF-8">
<title>学科信息</title>
<style>
#container {
width: 80%;
margin: 10px auto;
}
.user {
float: right;
margin-right: 10px;
}
.user>a {
margin-right: 10px;
}
#main>dl>dt {
font-size: 1.5em;
font-weight: bold;
}
#main>dl>dd {
font-size: 1.2em;
}
a {
text-decoration: none;
color: darkcyan;
}
</style>
</head>
<body>
<div id="container">
<div class="user">
<a href="login.html">用户登录</a>
<a href="register.html">快速注册</a>
</div>
<h1>扣丁学堂所有学科</h1>
<hr>
<div id="main">
{% for subject in subjects %}
<dl>
<dt>
<a href="/teachers/?sno={{ subject.no }}">{{ subject.name }}</a>
{% if subject.is_hot %}
<img src="/static/images/hot-icon-small.png">
{% endif %}
</dt>
<dd>{{ subject.intro }}</dd>
</dl>
{% endfor %}
</div>
</div>
</body>
</html>
teachers.html
修改
vote/urls.py
文件,实现映射URL。from django.contrib import admin
from django.urls import path
from polls.views import show_subjects, show_teachers
urlpatterns = [
path('admin/', admin.site.urls),
path('', show_subjects),
path('teachers/', show_teachers),
]
到此为止,页面上需要的图片(静态资源)还没有能够正常展示,我们在下一章节中为大家介绍如何处理模板页上的需要的静态资源。
Django模型最佳实践
- 正确的为模型和关系字段命名。
- 设置适当的
related_name
属性。 - 用
OneToOneField
代替ForeignKeyField(unique=True)
。 - 通过“迁移操作”(migrate)来添加模型。
- 用NoSQL来应对需要降低范式级别的场景。
- 如果布尔类型可以为空要使用
NullBooleanField
。 - 在模型中放置业务逻辑。
- 用
<ModelName>.DoesNotExists
取代ObjectDoesNotExists
。 - 在数据库中不要出现无效数据。
- 不要对
QuerySet
调用len()
函数。 - 将
QuerySet
的方法的返回值用于if
条件。 - 用
DecimalField
来存储货币相关数据而不是FloatField
。 - 定义
__str__
方法。 - 不要将数据文件放在同一个目录中。
模型定义参考
字段
对字段名称的限制
- 字段名不能是Python的保留字,否则会导致语法错误
- 字段名不能有多个连续下划线,否则影响ORM查询操作
Django模型字段类
字段属性
通用字段属性
ForeignKey
属性
limit_choices_to
:值是一个Q对象或返回一个Q对象,用于限制后台显示哪些对象。related_name
:用于获取关联对象的关联管理器对象(反向查询),如果不允许反向,该属性应该被设置为'+'
,或者以'+'
结尾。to_field
:指定关联的字段,默认关联对象的主键字段。db_constraint
:是否为外键创建约束,默认值为True
。on_delete
:外键关联的对象被删除时对应的动作,可取的值包括django.db.models
中定义的:CASCADE
:级联删除。PROTECT
:抛出ProtectedError
异常,阻止删除引用的对象。SET_NULL
:把外键设置为null
,当null
属性被设置为True
时才能这么做。SET_DEFAULT
:把外键设置为默认值,提供了默认值才能这么做。
symmetrical
:是否建立对称的多对多关系。through
:指定维持多对多关系的中间表的Django模型。throughfields
:定义了中间模型时可以指定建立多对多关系的字段。db_table
:指定维持多对多关系的中间表的表名。
模型元数据选项
查询参考
按字段查找可以用的条件
exact
/iexact
:精确匹配/忽略大小写的精确匹配查询contains
/icontains
/startswith
/istartswith
/endswith
/iendswith
:基于like
的模糊查询in
:集合运算gt
/gte
/lt
/lte
:大于/大于等于/小于/小于等于关系运算range
:指定范围查询(SQL中的between…and…
)year
/month
/day
/week_day
/hour
/minute
/second
:查询时间日期isnull
:查询空值(True)或非空值(False)regex
/iregex
:基于正则表达式的模糊匹配查询