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

关于博主

努力与运动兼备~~~有任何问题可以加我好友或者关注微信公众号,欢迎交流,我们一起进步!

                                      微信公众号:  啃饼思录
                                    QQ: 2810706745(啃饼小白)

写在前面

本篇笔记主要就是对上篇遗留的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 modelsfrom 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 datetimeclass 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 modelsfrom 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 、序列的左括号前不要加空格。如list2。

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

原文发布于微信公众号 - 啃饼思录(kbthinking)

原文发表时间:2018-08-01

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

编辑于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏java工会

java调用webservice接口的几种方法

3.6K4
来自专栏CRPER折腾记

2018春招前端面试: 闯关记(精排精校)

box-sizing有两个值:content-box(W3C标准盒模型),border-box(怪异模型),

2112
来自专栏LeoXu的博客

Flex笔记_验证用户输入

1142
来自专栏大内老A

ASP.NET MVC以ModelValidator为核心的Model验证体系: ModelValidatorProviders

前面篇文章我们分别介绍用真正用于实施Model验证的ModelValidator(《ASP.NET MVC以ModelValidator为核心的Model验证体...

1835
来自专栏青玉伏案

iOS逆向工程之Hopper中的ARM指令

虽然前段时间ARM被日本软银收购了,但是科技是无国界的,所以呢ARM相关知识该学的学。现在看ARM指令集还是倍感亲切的,毕竟大学里开了ARM这门课,并且做了不少...

3357
来自专栏逆向技术

PE格式第六讲,导出表

                PE格式第六讲,导出表 请注意,下方字数比较多,其实结构挺简单,但是你如果把博客内容弄明白了,对你受益匪浅,千万不要看到字...

1946
来自专栏安恒网络空间安全讲武堂

2018 全国大学生软件测试大赛——安恒杯Web测试大赛全国总决赛部分Writeup

将给字符串增加一个单引号并且能引用或者转码任何已经存在的单引号,这样以确保能够直接将一个字符串传入shell函数,并且还是确保安全的。对于用户输入的部分参数就应...

5012
来自专栏零基础使用Django2.0.1打造在线教育网站

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

努力与运动兼备~有任何问题可以加我好友或者关注微信公众号,欢迎交流,我们一起进步!

3656
来自专栏我有一个梦想

QT Creator 快速入门教程 读书笔记(三)

一   信号和槽   GUI 程序除了要绘制控件,还要响应系统和用户事件,例如重绘、绘制完成、点击鼠标、敲击键盘等。当事件发生时,UI 会产生相应的变化,让用户...

2838
来自专栏joycl

c#面试题汇总

下面的参考解答只是帮助大家理解,不用背,面试题、笔试题千变万化,不要梦想着把题覆盖了,下面的题是供大家查漏补缺用的,真正的把这些题搞懂了,才能“以不变应万变”。...

5271

扫码关注云+社区

领取腾讯云代金券