韩国网站购物,网站制作 网站建设,查看 wordpress 插件,营销型高端网站建设替代 Django 默认 User 模型并使用 django-mysql 添加数据库备注
前言
在 Django 项目开发中#xff0c;默认的 User 模型虽然能够满足许多基础需求#xff0c;但在实际项目中我们常常需要对用户模型进行定制化。通过覆盖默认的 User 模型#xff0c;我们可以根据具体的业…替代 Django 默认 User 模型并使用 django-mysql 添加数据库备注
前言
在 Django 项目开发中默认的 User 模型虽然能够满足许多基础需求但在实际项目中我们常常需要对用户模型进行定制化。通过覆盖默认的 User 模型我们可以根据具体的业务需求添加额外的字段、修改字段属性等。同时使用 django-mysql我们还可以在数据库迁移时为字段添加备注提高数据库的可读性。
本文将详细讲解如何从头开始创建一个 Django 项目替代默认的 User 模型并使用 django-mysql 为数据库字段添加注释。
一、项目初始化
1. 创建 Django 项目
首先使用 django-admin 命令来创建一个新的 Django 项目
django-admin startproject oaback
cd oaback此命令将在当前目录下创建一个名为 oaback 的 Django 项目。oaback 目录将包含项目的基本结构。
2. 创建应用 oaauth
接下来我们需要创建一个新的应用来管理用户认证和权限逻辑
django-admin startapp oaauth这个命令将在 oaback 目录下创建一个 oaauth 应用该应用将包含用户模型及相关逻辑。
二、配置 settings.py
在 settings.py 中我们需要配置已安装的应用程序并覆盖默认的 User 模型。
1. 配置已安装的应用程序
打开 oaback/settings.py 文件找到 INSTALLED_APPS并添加以下配置
INSTALLED_APPS [# django.contrib.admin,django.contrib.auth,django.contrib.contenttypes,# django.contrib.sessions,# django.contrib.messages,django.contrib.staticfiles,# 安装rest_frameworkrest_framework,# 为了解决跨域问题安装corsheaderscorsheaders,django_mysql, # 添加 django-mysql 到已安装的应用程序中# 项目appapps.oaauth, # 你的用户管理应用apps.absent # 其他应用
]2. 设置自定义用户模型
为了使用自定义的用户模型必须在 settings.py 中配置 AUTH_USER_MODEL。确保添加如下配置
# OAUser覆盖原有的User模型
# 正确的格式app.User
AUTH_USER_MODEL oaauth.OAUser三、定义自定义 User 模型
在 oaauth/models.py 文件中定义自定义的用户模型
from django.contrib.auth.hashers import make_password
from django.db import models
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, BaseUserManager
from shortuuidfield import ShortUUIDField
from django_mysql.models import Modelclass UserStatusChoices(models.IntegerChoices):ACTIVED 1, 已激活UNACTIE 2, 未激活LOCKED 3, 已锁定class OAUserManager(BaseUserManager):use_in_migrations Truedef _create_user(self, real_name, email, password, **extra_fields):if not real_name:raise ValueError(The given real_name must be set)email self.normalize_email(email)user self.model(real_namereal_name, emailemail, **extra_fields)user.password make_password(password)user.save(usingself._db)return userdef create_user(self, real_name, emailNone, passwordNone, **extra_fields):extra_fields.setdefault(is_staff, True)extra_fields.setdefault(is_superuser, False)return self._create_user(real_name, email, password, **extra_fields)def create_superuser(self, real_name, emailNone, passwordNone, **extra_fields):extra_fields.setdefault(is_staff, True)extra_fields.setdefault(is_superuser, True)extra_fields.setdefault(status, UserStatusChoices.ACTIVED)if extra_fields.get(is_staff) is not True:raise ValueError(Superuser must have is_staffTrue.)if extra_fields.get(is_superuser) is not True:raise ValueError(Superuser must have is_superuserTrue.)return self._create_user(real_name, email, password, **extra_fields)class OAUser(Model, AbstractBaseUser, PermissionsMixin):uid ShortUUIDField(primary_keyTrue,verbose_name用户ID,help_text用户唯一标识符使用ShortUUID生成,db_comment用户唯一标识符使用ShortUUID生成)password models.CharField(max_length128,verbose_name密码,help_text用户的密码已加密存储,db_comment用户的密码已加密存储)last_login models.DateTimeField(verbose_name上次登录时间,help_text用户上次登录的日期和时间,db_comment用户上次登录的日期和时间,nullTrue,blankTrue)is_superuser models.BooleanField(verbose_name超级用户状态,help_text标识用户是否具有所有权限,db_comment标识用户是否具有所有权限,defaultFalse)real_name models.CharField(max_length150,verbose_name真实姓名,help_text用户的真实姓名最多150个字符,db_comment用户的真实姓名最多150个字符)email models.EmailField(uniqueTrue,blankFalse,verbose_name电子邮件,help_text用户的电子邮件地址必须唯一,db_comment用户的电子邮件地址必须唯一)telephone models.CharField(max_length20,uniqueTrue,blankFalse,verbose_name联系电话,help_text用户的联系电话必须唯一最多20个字符,db_comment用户的联系电话必须唯一最多20个字符)is_staff models.BooleanField(defaultFalse,verbose_name员工状态,help_text是否为员工身份员工可访问管理界面,db_comment是否为员工身份员工可访问管理界面)status models.IntegerField(choicesUserStatusChoices.choices,defaultUserStatusChoices.UNACTIE,verbose_name用户状态,help_text用户的当前状态,db_comment用户的当前状态)is_active models.BooleanField(defaultTrue,verbose_name活跃状态,help_text是否为活跃用户影响登录权限,db_comment是否为活跃用户影响登录权限)date_joined models.DateTimeField(auto_now_addTrue,verbose_name加入日期,help_text用户加入系统的日期和时间,db_comment用户加入系统的日期和时间)department models.ForeignKey(OADepartment,nullTrue,on_deletemodels.SET_NULL,related_namestaffs,related_query_namestaffs,verbose_name所属部门,help_text用户所属的部门可以为空。部门被删除时该字段设置为空,db_comment用户所属的部门可以为空。部门被删除时该字段设置为空)extra_data models.JSONField(verbose_name额外数据,help_text用户的额外信息存储为JSON格式,defaultdict,db_comment用户的额外信息存储为JSON格式)objects OAUserManager()EMAIL_FIELD emailUSERNAME_FIELD emailREQUIRED_FIELDS [real_name, password]def clean(self):super().clean()self.email self.__class__.objects.normalize_email(self.email)def get_full_name(self):return self.real_namedef get_short_name(self):return self.real_namedef __str__(self):return f{self.real_name} ({self.email})def get_status_display(self):return dict(UserStatusChoices.choices).get(self.status, Unknown)四、应用迁移并验证结果
1. 生成并应用迁移
在完成模型定义和 settings.py 配置后运行以下命令生成并应用数据库迁移
python manage.py makemigrations
python manage.py migrate2. 验证数据库中的字段备注
应用迁移后你可以使用数据库管理工具或直接运行 SQL 查询来验证字段备注是否已成功应用
SHOW FULL COLUMNSFROM oaauth_oauser;结语
通过本文的学习你已经掌握了如何从零开始创建一个 Django 项目并通过替代默认的 User 模型和使用 django-mysql 添加数据库字段备注来实现项目的定制化。这不仅增强了你的项目的灵活性也提高了数据库的可读性。希望本文能为你的开发工作提供帮助如果你在开发过程中遇到了类似的需求记得分享你的经验
