零基础使用Django2.0.1打造在线教育网站（七）：数据库字

写在前面

本篇笔记主要就是对上篇遗留的2个问题的解决：4个app项目的创建和数据库字段的定义，鉴于篇幅的原因，这里分上下两篇进行介绍。

本篇笔记对应于第七篇代码，对应于github的位置是https://github.com/licheetools/eduline

4个app项目的创建

users app的创建

先点击菜单下的Tools按钮 ，然后点击下拉的 Run manage.py Task按钮，在命令行中输入：

startapp users

然后在Navicat中打开我们的数据库eduline，会发现生成了很多表，我们打开其中的auth_user这个表：

下面我简要说明一下表中个字段的含义：

id代表主键, password是密码, last_login 这是Django用于自动记录用户最后登录时间的字段。
is_superuser 表明用户是否是超级用户(后台管理中会用到)，
username 表示用户名（该字段不要随便修改），
last_name和first_name分别是姓和名，
email 表示邮箱,
is_staff 表示是否是员工(后台管理中会用到)，
is_active 表示用户是否是激活状态,
date_joined 表示注册时间。

这其实是满足不了我们的需求的，因为我们的个人中心通常包括：昵称，性别，生日，地址，手机号，邮箱等信息，所以我们要扩展这些字段来满足我们的需求。

user表的自定义方法官方文档已经给出了，这里开启传送大门https://docs.djangoproject.com/zh-hans/2.0/ref/models/fields/
我们是希望既可以保留原来的字段，又可以新增我们的自定义字段，所以我们需要引入继承我们的AbstractUser这个类。

打开我们的users/models.py文件，添加并修改如下代码:

from django.db import models

from datetime import datetime

# Create your models here.
from django.contrib.auth.models import AbstractUser  # 导入需要的类


class UserProfile(AbstractUser):
    # 昵称
    nick_name=models.CharField(max_length=50,verbose_name='昵称',default='')
     # 生日，可以为空
    birday=models.DateTimeField(verbose_name='生日',null=True,blank=True)
     # 性别，默认为女
    gender=models.CharField(max_length=6, choices=(('male','男'),('female','女')),default='female',verbose_name='性别')
    # 地址
    address=models.CharField(max_length=100,default='', verbose_name='地址')
   # 手机号，可以为空
    mobile=models.CharField(max_length=11,null=True,blank=True, verbose_name='手机号')
     # 图片，默认为default.png,upload_to为上传路径，记住图片字段必须有字段最大值
  image=models.ImageField(upload_to='image/%Y/%m',default='image/default.png',max_length=100,verbose_name='图片')
     # meta信息，即后台管理中的名称
    class Meta:
        verbose_name= '用户信息'
        verbose_name_plural=verbose_name
     # 重载str方法，打印实例会打印username，username为继承自Abstractuser这个类
    def __str__(self):
        return self.username

注意：
1、按住ctrl然后单击我们的AbstractUser，就可以进入到这个类的定义文件：auth/models.py,这也就是我们之前导入的位置：

看到没，我们之前保留的字段它都有，所以我们只需要继承它就可以了。
2、前面说过CharField必须有max_length, 但实际上Imagefield也是Charfield，所以也要有max_length。
3、因为使用到了Imagefield字段，所以需要用到Pillow这个库，我们可以通过Pycharm或者pip安装它。

注册APP和重载AUTH_USER_MODEL

注册APP

打开eduline/settings.py文件，找到第30行代码，最底下加上我们的app名称。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users',
]

重载AUTH_USER_MODEL

打开eduline/settings.py文件，在刚才代码的底下加上重载我们的UserProfile代码：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'users',
]
# 重载UserProfile使其生效
AUTH_USER_MODEL='users.UserProfile'

数据库更新

点击Tools 菜单下 Run manage.py Task，运行我们的makemigrations users和migrate users命令。你会发现运行前者没问题，运行后者却出了问题：

django.db.migrations.exceptions.InconsistentMigrationHistory: Migration admin.0001_initial is applied before its dependency users.0001_initial on database 'default'.

其实这个问题就是你之前已经定义了userProfile并且还设置了重载它的语句，现在又来定义它，它是不会再给你提供那么多的初始表的：

所以我们需要删除除了auth_user以外的其他表，如果一次删除不了（那是因为表与表之间存在外键联系）就一个个的删除：
现在再来点击Tools 菜单下 Run manage.py Task，按顺序运行如下命令：

makemigrations
migrate
makemigrations users
migrate users

注意：只运行后面那2个命令是不可以的，会缺少部分表！！！

看到没，这次没有问题出现了：
打开数据库，看一下我们的表，一共有11个表：
打开这个自定义表（users_usersprofile）,你会发现我们需要的字段都有了：

注意一下

我们以后不要在初始化的时候就执行makemigrations & migrate操作，应当在我们设计完userProfile（自定义字段）之后再执行该操作，那样就不会报错了。

至此我们完成了第一个app的配置和其自定义字段的设计！

循环引用

看下面这个图：

我们通常会在user中定义userCourse这个字段，用来记录用户学习的课程，它会有两个外键：user和course。所以在用到的时候，我们需要import Courses.models。

同样，如果用户对于某个课程需要评论，那么我们需要定义CourseComment这个字段，而且它肯定会放在 Courses.models当中。所以在用到的时候，我们又需要import User.models。

这是只有2个app的情况，当还有更多的情况：3个，4个，5个...apps时，循环调用import会出错导致系统不能正确识别，而且最起码会造成时间上的等待。那么有没有好的方法来解决这个问题呢？答案是有的！可以采用分层设计的思想来解决这个难题。

分层设计

在前面的第六篇笔记中我们已经说过，准备新建4个app,其中的3个apps:
(users)用户版块,(course)课程版块,(organization)授课教师与授课机构板块, 就是一些常规的信息存储，而第4个(operation)用户操作板块就是采用分层设计的思想来设计的，而且我们保证operation这个app的优先级高于其他3个，所以可以随时import这些底层的apps。各个apps的层级关系如下图所示：

在users这个app中，我们自定义了UserProfile这个表用来覆盖系统默认的user表。这样其实我们这个users应用已经设计完了。不过呢，通过研究我们发现有些功能是非常独立的，我们为了平衡一些app的代码量，可以将它们放在这个users项目里面。

EmailVerifyRecord - 邮箱验证码
Banner - 轮播图

邮箱验证码的设计

验证码分三种类型，分别用于不同的功能：注册；找回密码；修改邮箱，所以在设计验证码类型的时候注意选择的条件，通常验证码包括这些字段：code,email,send_type,send_time。

我们打开users/models.py文件，接着之前的代码在后面添加如下内容:

from datetime import datetime


class EmailVerifyRecord(models.Model):
    code = models.CharField(max_length=20, verbose_name="验证码")
    email = models.EmailField(max_length=50, verbose_name="邮箱")
    send_type = models.CharField(verbose_name="验证码类型", 
choices=(('register', '注册'), ('forget', '找回密码'), ('update_email', '修改邮箱')), max_length=30)

# 这里的now得去掉(),如果不去掉则会根据编译时间，而不是我们要的实例化时间。
    send_time = models.DateTimeField(verbose_name="发送时间", default=datetime.now)   
 
    class Meta:
        verbose_name = "邮箱验证码"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.email   #这里很重要，否则在后台就显示不出Meta信息

轮播图的设计

轮播图是一个可以自动切换图片的效果，它包括标题，具体的图片，点击图片后的跳转地址，图片的轮播顺序，添加时间等要素：title,image,url,index,add_time。
我们打开users/models.py文件，接着之前的代码在后面添加如下内容:

class Banner(models.Model):
    title = models.CharField(max_length=100, verbose_name="标题")
    image = models.ImageField(max_length=100, upload_to='banneer/%Y/&m',verbose_name="轮播图")
    url = models.URLField(max_length=200, verbose_name='访问地址')

    # index的值默认越大越靠后，可以自定义修改index值。
    index = models.IntegerField(default=100, verbose_name='轮播顺序')
    add_time = models.DateTimeField(default=datetime.now, verbose_name='添加时间')

    class Meta:
        verbose_name = "轮播图"
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.title  # 这里很重要，否则在后台就显示不出Meta信息

你可能会问，为什么不把与用户相关的评论，点赞，学习的课程，课程进度等信息也放到这个app中呢？其实是因为那些信息的相关性很大，经常是循环引用，所以我们把那些信息都放到operation这个app中。

我们把鼠标移至models.py这个文件上，再点击右侧的structure，可以发现我们刚才新创建的3个类（其实就是数据库里的数据表）：

至此第一个app应用的数据库字段定义算是完成了，下面大家可以思考一下其他3个应用的数据库字段的定义应该是怎样的，给大家留点时间思考一下，我们下一篇笔记再来介绍！下面介绍一个Python的规范，可以让你的代码更具有可读性和维护性。

PEP8规范

（一） 代码的编排

1、 缩进。每行需要4个空格的缩进，不要使用Tap键，更不能混合使用Tap键和空格。
2 、每行最大长度79，换行可以使用反斜杠，但最好使用圆括号。换行点要在操作符的后边敲回车。
3 、类和top-level函数定义之间空两行；类中的方法定义之间空一行；函数内逻辑无关段落之间空一行；其他地方尽量不要再空行。

（二 ）文档的编排

1、 模块内容的顺序：模块说明和docstring—import—globals&constants—其他定义。其中import部分，又按标准、第三方和自己编写顺序依次排放，之间空一行。

from django.db import models
from datetime import datetime
# Create your models here.
from django.contrib.auth.models import AbstractUser

# 自己定义代码放置处

2 、不要在一行import多个库，比如import os, sys，虽说没有错误但是并不推荐。
3、 如果采用from xx import xx的方式来引用某个库，可以省略module.，但是可能会出现命名的冲突，所以这时就要采用import xx的方式。

（三）空格的使用

总体原则，避免不必要的空格。
1、 各种右括号前不要加空格。
2、 逗号、冒号、分号前不要加空格。
3 、函数的左括号前不要加空格。如function(1)。
4 、序列的左括号前不要加空格。如list[2]。
5、操作符左右各加一个空格，不要为了对齐增加空格。
6 、函数默认参数使用的赋值符左右省略空格。
7、不要将多句语句写在同一行，尽管使用；允许。
8、 if/for/while语句中，即使执行语句只有一句，也必须另起一行。

（四）命名的规范

总体原则，新编代码必须按下面命名风格进行，现有库的编码尽量保持风格。
1 、尽量单独使用小写字母‘l’，大写字母‘O’等容易混淆的字母。
2、 模块命名尽量短小，使用全部小写的方式，可以使用下划线。
3、 包命名尽量短小，使用全部小写的方式，不可以使用下划线。
4、 类的命名使用CapWords的方式，模块内部使用的类采用_CapWords的方式。
5、 异常命名使用CapWords+Error后缀的方式。
6 、全局变量尽量只在模块内有效，类似C语言中的static。实现方法有两种，一是all机制;二是前缀一个下划线。
7 、函数命名使用全部小写的方式，可以使用下划线。
8 、常量命名使用全部大写的方式，可以使用下划线。
9 、类的属性（方法和变量）命名使用全部小写的方式，可以使用下划线。
10、类的属性有3种作用域public、non-public和subclass API，可以理解成C++中的public、private、protected，non-public属性前，前缀一条下划线。
11 、类的属性若与关键字名字冲突，后缀一下划线，尽量不要使用缩略等其他方式。
12 、为避免与子类属性命名冲突，在类的一些属性前，前缀两条下划线。比如：类Foo中声明__a,访问时，只能通过Foo._Foo__a，避免歧义。如果子类也叫Foo，那就无能为力了。
13 、类的方法第一个参数必须是self，而静态方法第一个参数必须是cls。

（五）编码的建议

1、编码中考虑到其他python实现的效率等问题，比如运算符‘+’在CPython（Python）中效率很高，都是Jython中却非常低，所以应该采用.join()的方式。
2 、尽可能使用‘is’‘is not’取代‘==’，比如if x is not None 要优于if x。
3 、使用基于类的异常，每个模块或包都有自己的异常类，此异常类继承自Exception。
4 、异常中不要使用裸露的except，except后跟具体的exceptions。
5 、异常中try的代码尽可能少。比如：

try:
value = collection[key]
except KeyError:
return key_not_found(key)
else:
return handle_value(value)

要优于

try:
# Too broad!
return handle_value(collection[key])
except KeyError:
# Will also catch KeyError raised by handle_value()
return key_not_found(key)

6 、使用startswith() and endswith()代替切片进行序列前缀或后缀的检查。比如:
Yes: if foo.startswith(‘bar’):优于No: if foo[:3] == ‘bar’:
7 、使用isinstance()比较对象的类型。比如:
Yes: if isinstance(obj, int):优于No: if type(obj) is type(1):
8、 判断序列空或不空，有如下规则:

Yes: if not seq:
if seq:

优于

No: if len(seq)
if not len(seq)

9 、字符串不要以空格收尾。
10、二进制数据判断使用 if boolvalue的方式。

如果你想获得更多关于PEP8的信息，可以查阅这篇信息PEP8 Python 编码规范整理或者官方文档PEP8的官方文档

至此，我们第七篇：在线教育网站的数据库字段的定义(上)就到此结束了，感谢你的赏阅。下一篇，我们就完善其余3个apps应用的数据库字段的定义。

本篇笔记对应于第七篇代码，对应于github的位置是https://github.com/licheetools/eduline