在线网站搭建(七):数据库字段的定义(上)

零基础使用Django2.0.1搭建在线教育网站(七):数据库字段的定义(上)

写在前面

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

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

4个app项目的创建

users app的创建

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

然后在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文件,添加并修改如下代码:

注意:

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名称。

重载AUTH_USER_MODEL

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

数据库更新

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

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

所以我们需要删除除了auth_user以外的其他表,如果一次删除不了(那是因为表与表之间存在外键联系)就一个个的删除:

现在再来点击Tools菜单下Run manage.py Task,按顺序运行如下命令:

注意:只运行后面那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 - 轮播图

邮箱验证码的设计

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

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

轮播图的设计

你可能会问,为什么不把与用户相关的评论,点赞,学习的课程,课程进度等信息也放到这个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部分,又按标准、第三方和自己编写顺序依次排放,之间空一行。

2 、不要在一行import多个库,比如import os, sys,虽说没有错误但是并不推荐。

3、如果采用from xx import xx的方式来引用某个库,可以省略,但是可能会出现命名的冲突,所以这时就要采用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的代码尽可能少。比如:

要优于

6 、使用startswith() and endswith()代替切片进行序列前缀或后缀的检查。比如:

优于

7 、使用isinstance()比较对象的类型。比如:

优于

8、判断序列空或不空,有如下规则:

优于

9 、字符串不要以空格收尾。

10、二进制数据判断使用 if boolvalue的方式。

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20180801G1JAK400?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。

扫码关注云+社区

领取腾讯云代金券