对django的User模型和四种扩展/重写方法小结
User模型
User模型是这个框架的核心部分。他的完整的路径是在django.contrib.auth.models.User。以下对这个User对象做一个简单了解:
字段:
内置的User模型拥有以下的字段:
username:用户名。150个字符以内。可以包含数字和英文字符,以及_、@、+、.和-字符。不能为空,且必须唯一!
first_name:歪果仁的first_name,在30个字符以内。可以为空。
last_name:歪果仁的last_name,在150个字符以内。可以为空。
email:邮箱。可以为空。
password:密码。经过哈希过后的密码。
groups:分组。一个用户可以属于多个分组,一个分组可以拥有多个用户。groups这个字段是跟Group的一个多对多的关系。
user_permissions:权限。一个用户可以拥有多个权限,一个权限可以被多个用户所有用。和Permission属于一种多对多的关系。
is_staff:是否可以进入到admin的站点。代表是否是员工。
is_active:是否是可用的。对于一些想要删除账号的数据,我们设置这个值为False就可以了,而不是真正的从数据库中删除。
is_superuser:是否是超级管理员。如果是超级管理员,那么拥有整个网站的所有权限。
last_login:上次登录的时间。
date_joined:账号创建的时间。
登录验证:
Django的验证系统已经帮我们实现了登录验证的功能。通过django.contrib.auth.authenticate即可实现。这个方法只能通过username和password来进行验证。示例代码如下:
fromdjango.contrib.authimportauthenticate user=authenticate(username='Tom',password='111111') #如果验证通过了,那么就会返回一个user对象。 ifuserisnotNone: #执行验证通过后的代码 else: #执行验证没有通过的代码。
扩展用户模型:
Django内置的User模型虽然已经足够强大了。但是有时候还是不能满足我们的需求。比如在验证用户登录的时候,他用的是用户名作为验证,而我们有时候需要通过手机号码或者邮箱来进行验证。还有比如我们想要增加一些新的字段。那么这时候我们就需要扩展用户模型了。扩展用户模型有多种方式。这里我们来一一讨论下。
1.设置Proxy模型:
作用:给模型增加操作方法
局限:不能增加或减少User模型的字段
好处:不破坏原来的User模型的表结构
如果你对Django提供的字段,以及验证的方法都比较满意,没有什么需要改的。但是只是需要在他原有的基础之上增加一些操作的方法。那么建议使用这种方式。示例代码如下:
#models.py classPerson(User): #如果模型是一个代理模型 #那么就不能在这个模型中添加新的Field #telephone=models.CharField(max_length=11)#错误写法 classMeta: proxy=True #proxy正确用法是给模型添加自定义方法 #如添加列出黑名单的方法 defget_blacklist(self): returnself.objects.filter(is_active=False)
在以上,我们定义了一个Person类,让他继承自User,并且在Meta中设置proxy=True,说明这个只是User的一个代理模型。他并不会影响原来User模型在数据库中表的结构。以后如果你想方便的获取所有黑名单的人,那么你就可以通过Person.get_blacklist()就可以获取到。并且User.objects.all()和Person.objects.all()其实是等价的。因为他们都是从User这个模型中获取所有的数据。
2.一对一外键:
作用:给模型增加新的字段,新方法
局限:只能增加,不能减少字段,不能修改户验证方法:authenticate
好处:不破坏原来的User模型的表结构
如果你对用户验证方法authenticate没有其他要求,就是使用username和password即可完成。但是想要在原来模型的基础之上添加新的字段,那么可以使用一对一外键的方式。示例代码如下:
#models.py fromdjango.contrib.auth.modelsimportUser fromdjango.dbimportmodels fromdjango.dispatchimportreceiver fromdjango.db.models.signalsimportpost_save classUserExtension(models.Model): user=models.OneToOneField(User,on_delete=models.CASCADE,related_name='extension') birthday=models.DateField(null=True,blank=True) school=models.CharField(max_length=100) @receiver(post_save,sender=User) defcreate_user_extension(sender,instance,created,**kwargs): ifcreated: UserExtension.objects.create(user=instance) else: instance.extension.save()
以上定义一个UserExtension的模型,并且让她和User模型进行一对一的绑定,以后我们新增的字段,就添加到UserExtension上。并且还写了一个接受保存模型的信号处理方法,只要是User调用了save方法,那么就会创建一个UserExtension和User进行绑定。
#views.py fromdjango.contrib.auth.modelsimportUser fromdjango.httpimportHttpResponse defone_to_one_view(request): user=User.objects.create_user(username='Tom',email='tom@qq.com',password='111111') #给扩展的字段设置值 user.extension.school='Harvard' user.save() returnHttpResponse('一对一扩展User模型')
3.继承自AbstractUser:
作用:给模型增加新的字段,修改户验证方法:authenticate
局限:只能增加,不能减少字段
坏处:破坏了原来的User模型的表结构
对于authenticate不满意,并且不想要修改原来User对象上的一些字段,但是想要增加一些字段,那么这时候可以直接继承自django.contrib.auth.models.AbstractUser,其实这个类也是django.contrib.auth.models.User的父类。比如我们想要在原来User模型的基础之上添加一个telephone和school字段。示例代码如下:
#models.py fromdjango.contrib.auth.modelsimportAbstractUser classUser(AbstractUser): telephone=models.CharField(max_length=11,unique=True) school=models.CharField(max_length=100) #指定telephone作为USERNAME_FIELD,而不是原来的username字段,所以username要重写 username=models.CharField(max_length=150) #指定telephone作为USERNAME_FIELD,以后使用authenticate #函数验证的时候,就可以根据telephone来验证 #而不是原来的username USERNAME_FIELD='telephone' #USERNAME_FIELD对应的'telephone'字段和密码字段默认是必须的字段 #下[]可以添加其它必须的字段,比如['username','email'] REQUIRED_FIELDS=[] #重新定义Manager对象,在创建user的时候使用telephone和 #password,而不是使用username和password objects=UserManager() #重写UserManager classUserManager(BaseUserManager): use_in_migrations=True def_create_user(self,telephone,password,**extra_fields): ifnottelephone: raiseValueError("请填入手机号码!") ifnotpassword: raiseValueError("请填入密码!") user=self.model(telephone=telephone,**extra_fields) user.set_password(password) user.save(using=self._db) returnuser defcreate_user(self,telephone,password,**extra_fields): extra_fields.setdefault('is_staff',False) extra_fields.setdefault('is_superuser',False) returnself._create_user(telephone,password,**extra_fields) defcreate_superuser(self,telephone,password,**extra_fields): extra_fields.setdefault('is_staff',True) extra_fields.setdefault('is_superuser',True) ifextra_fields.get('is_staff')isnotTrue: raiseValueError('Superusermusthaveis_staff=True.') ifextra_fields.get('is_superuser')isnotTrue: raiseValueError('Superusermusthaveis_superuser=True.') returnself._create_user(telephone,password,**extra_fields)
然后再在settings中配置好
#settings.py AUTH_USER_MODEL='youappname.User'
这种方式因为破坏了原来User模型的表结构,所以必须要在第一次migrate前就先定义好。
4.继承自AbstractBaseUser模型:
作用:给模型增加或减少字段,修改户验证方法:authenticate
坏处:破坏了原来的User模型的表结构
注意:继承自AbstractBaseUser同时还要继承PermissionsMixin
如果你想修改默认的验证方式,并且对于原来User模型上的一些字段不想要,那么可以自定义一个模型,然后继承自AbstractBaseUser,再添加你想要的字段。这种方式会比较麻烦,最好是确定自己对Django比较了解才推荐使用。步骤如下:
创建模型。示例代码如下:
#models.py fromdjango.contrib.auth.base_userimportAbstractBaseUser fromdjango.contrib.auth.modelsimportPermissionsMixin fromdjango.dbimportmodels classUser(AbstractBaseUser,PermissionsMixin): email=models.EmailField(unique=True) username=models.CharField(max_length=150) telephone=models.CharField(max_length=11,unique=True) is_staff=models.BooleanField(default=False) is_active=models.BooleanField(default=True) USERNAME_FIELD='telephone' REQUIRED_FIELDS=[] #这里的UserManager同方法3,需要重写 objects=UserManager() defget_full_name(self): returnself.username defget_short_name(self): returnself.username
其中password和last_login是在AbstractBaseUser中已经添加好了的,我们直接继承就可以了。然后我们再添加我们想要的字段。比如email、username、telephone等。这样就可以实现自己想要的字段了。但是因为我们重写了User,所以应该尽可能的模拟User模型:
USERNAME_FIELD:用来描述User模型名字字段的字符串,作为唯一的标识。如果没有修改,那么会使用USERNAME来作为唯一字段。
REQUIRED_FIELDS:一个字段名列表,用于当通过createsuperuser管理命令创建一个用户时的提示。
is_active:一个布尔值,用于标识用户当前是否可用。
get_full_name():获取完整的名字。
get_short_name():一个比较简短的用户名。
重新定义UserManager:我们还需要定义自己的UserManager,因为默认的UserManager在创建用户的时候使用的是username和password,那么我们要替换成telephone。示例代码如下:
#models.py fromdjango.contrib.auth.base_userimportBaseUserManager #重写UserManager classUserManager(BaseUserManager): use_in_migrations=True def_create_user(self,telephone,password,**extra_fields): ifnottelephone: raiseValueError("请填入手机号码!") ifnotpassword: raiseValueError("请填入密码!") user=self.model(telephone=telephone,**extra_fields) user.set_password(password) user.save(using=self._db) returnuser defcreate_user(self,telephone,password,**extra_fields): extra_fields.setdefault('is_staff',False) extra_fields.setdefault('is_superuser',False) returnself._create_user(telephone,password,**extra_fields) defcreate_superuser(self,telephone,password,**extra_fields): extra_fields.setdefault('is_staff',True) extra_fields.setdefault('is_superuser',True) ifextra_fields.get('is_staff')isnotTrue: raiseValueError('Superusermusthaveis_staff=True.') ifextra_fields.get('is_superuser')isnotTrue: raiseValueError('Superusermusthaveis_superuser=True.') returnself._create_user(telephone,password,**extra_fields)
在创建了新的User模型后,还需要在settings中配置好。配置AUTH_USER_MODEL='appname.User'。
#settings.pyAUTH_USER_MODEL='youappname.User'
如何使用这个自定义的模型:比如以后我们有一个Article模型,需要通过外键引用这个User模型,那么可以通过以下两种方式引用。
第一种就是直接将User导入到当前文件中。示例代码如下:
#models.py fromdjango.dbimportmodels frommyauth.modelsimportUser classArticle(models.Model): title=models.CharField(max_length=100) content=models.TextField() author=models.ForeignKey(User,on_delete=models.CASCADE)
这种方式是可以行得通的。但是为了更好的使用性,建议还是将User抽象出来,使用settings.AUTH_USER_MODEL来表示。示例代码如下:
#models.py fromdjango.dbimportmodels fromdjango.confimportsettings classArticle(models.Model): title=models.CharField(max_length=100) content=models.TextField() author=models.ForeignKey(settings.AUTH_USER_MODEL,on_delete=models.CASCADE)
这种方式因为破坏了原来User模型的表结构,所以必须要在第一次migrate前就先定义好。
以上这篇对django的User模型和四种扩展/重写方法小结就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持毛票票。