努力与运动兼备~有任何问题可以加我好友或者关注微信公众号,欢迎交流,我们一起进步!
微信公众号: 啃饼思录
QQ: 2810706745(啃饼小白)
本篇笔记主要就是对上篇遗留的2个问题的解决:4个app项目的创建和数据库字段的定义,鉴于篇幅的原因,这里分上下两篇进行介绍。
本篇笔记对应于第七篇代码,对应于github的位置是https://github.com/licheetools/eduline
先点击菜单下的Tools按钮 ,然后点击下拉的 Run manage.py Task按钮,在命令行中输入:
startapp users
下面我简要说明一下表中个字段的含义:
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
**注意:**
看到没,我们之前保留的字段它都有,所以我们只需要继承它就可以了。
**2、**前面说过CharField必须有max_length, 但实际上Imagefield也是Charfield,所以也要有max_length。
**3、**因为使用到了Imagefield字段,所以需要用到Pillow这个库,我们可以通过**Pycharm**或者**pip**安装它。
打开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',
]
打开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'.
现在再来点击**Tools** 菜单下 **Run manage.py Task**,按顺序运行如下命令:
makemigrations
migrate
makemigrations users
migrate users
**注意:**只运行后面那2个命令是不可以的,会缺少部分表!!!
我们以后不要在初始化的时候就执行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这个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中。
至此第一个app应用的数据库字段定义算是完成了,下面大家可以思考一下其他3个应用的数据库字段的定义应该是怎样的,给大家留点时间思考一下,我们下一篇笔记再来介绍!下面介绍一个Python的规范,可以让你的代码更具有可读性和维护性。
**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 AbstractUse
# 自己定义代码放置处
**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
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。