Django自带的后台管理系统主要用来对数据库进行操作和管理。它是Django框架的一个强大功能,可以让你快速创建一个管理界面,用于管理你的应用程序的数据模型。
使用Django后台管理系统,你可以轻松地进行以下操作:
-
数据库管理:你可以查看、添加、编辑和删除数据库中的记录,而无需编写自定义的管理界面或数据库查询语句。
-
模型管理:Django后台管理系统会自动检测你在应用程序中定义的模型,并为每个模型创建相应的管理界面。这样,你就可以直接在后台管理界面对模型进行操作。
-
用户权限管理:Django后台管理系统支持用户认证和权限控制,你可以通过定义用户组和权限,限制特定用户对数据的访问和操作。
-
自定义管理页面:尽管Django后台管理系统提供了很多默认功能,但你也可以根据需要自定义管理页面,添加自定义的功能和视图。
总体而言,Django后台管理系统是一个强大的工具,使得对数据库进行操作和管理变得简单而高效,这使得开发者可以更专注于业务逻辑和功能开发,而无需为了管理界面而花费大量时间和精力。
在本文中,我们在Django中创建与商品分类、商品信息有关的数据表模型,并利用Django自带的后台管理系统对商品分类、商品信息的数据表进行管理。
01-新建一个名为“good_info”的Project
命令如下:
CD E:\Python_project\P_001\myshop-test
E:
django-admin startproject good_info
02-新建两个应用
执行下面条命令依次创建两个应用:
CD E:\Python_project\P_001\myshop-test\good_info\
E:
python manage.py startapp goods
python manage.py startapp users
上面的两个应用,主要的就是goods,我们会在goods的models.py中写入商品分类和商品信息的数据库类模型。
但由于商品信息中有用户的信息,所以还需要有users模型。
03-在settings.py中对两个应用进行注册
在settings.py中进行注册的代码如下:
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'users',
'goods',
]
04-编写两个应用的数据库模型类
04-01-users的模型创建及代码详解
打开文件:E:\Python_project\P_001\myshop-test\myshop_background\apps\users\apps.py
写入以下代码:
from datetime import datetime
from django.db import models
from django.contrib.auth.models import AbstractUser, Group, Permission
class MyUser(AbstractUser):
SEX = (
(0, '男'),
(1, '女'),
)
LEVEL = (
(1, '寂寞卡会员'),
(2, '钻石卡会员'),
(3, '金卡会员'),
(4, '银卡会员'),
)
STATUS = (
(0, '正常'),
(1, '异常'),
)
groups = models.ManyToManyField(
Group,
verbose_name='groups',
blank=True,
help_text='The groups this user belongs to.',
related_name='user_groups' # 设置不同的 related_name
)
user_permissions = models.ManyToManyField(
Permission,
verbose_name='user permissions',
blank=True,
help_text='Specific permissions for this user.',
related_name='user_permissions' # 设置不同的 related_name
)
truename = models.CharField('真实姓名', blank=True, max_length=50)
mobile = models.CharField('手机号码', max_length=11, default="")
sex = models.IntegerField(default=0, choices=SEX)
birthday = models.DateField(blank=True, null=True)
user_img = models.ImageField("头像", upload_to="user_img", default="")
level = models.IntegerField(default=4, choices=LEVEL)
status = models.IntegerField(default=0, choices=STATUS)
create_time = models.DateTimeField(default=datetime.now, verbose_name='创建时间')
update_time = models.DateTimeField(default=datetime.now, verbose_name="更新时间")
def __str__(self):
return self.username
class Meta(AbstractUser.Meta):
permissions = (
['check_myuser', '审核用户信息'],
)
①关于字段groups和字段user_permissions的说明。
字段groups和字段user_permissions实际上是没有作用的,那为什么要定义呢?原因请见博文:https://blog.csdn.net/wenhao_ir/article/details/131773627
②问:能不能介绍下代码from django.contrib.auth.models import AbstractUser
中涉及到的类AbstractUser?
答:在Django框架中,django.contrib.auth.models
模块提供了用于身份验证和授权的相关功能。其中,AbstractUser
类是Django默认的用户模型(user model)的抽象基类。详情请参见链接:https://blog.csdn.net/wenhao_ir/article/details/131594115
③代码 truename=models.CharField(‘真实姓名’,blank=True,max_length=50) 的blank=True,
是什么意思?
在Django模型中,blank=True
是一个参数,用于指示模型字段是否可以为空。当blank=True
时,该字段在表单验证过程中可以为空,不会引发验证错误。如果blank=False
,则该字段在表单验证过程中是必需的,不能为空。
在代码中,truename
是一个CharField
,它表示一个字符型字段,用于存储真实姓名。由于指定了blank=True
,这意味着在创建或更新该模型实例时,可以将truename
字段留空。这对于某些情况下真实姓名是可选的场景很有用。但需要注意的是,即使blank=True
,数据库中存储的字段值仍然可以是空字符串,而不是NULL
值。
④代码 mobile=models.CharField(‘手机号码’,max_length=11,default=“”)中的 default=“” 是什么意思?
答:default=""
是models.CharField
的一个参数,用于指定字段的默认值。
default=""
表示当创建新的模型实例时,如果没有为mobile
字段提供具体的值,那么该字段将默认为空字符串。
在数据库中,如果没有为该字段提供值,它将被存储为空字符串,而不是NULL
值。这意味着在查询和检索数据时,如果mobile
字段没有被显式地赋值,它将返回空字符串作为默认值。
通过设置默认值,可以确保即使没有为该字段提供值,模型实例的mobile
字段始终有一个默认的空字符串值。这在某些情况下可能是有用的,例如当手机号码是可选的字段时,可以将其默认为空字符串。
注意:如果在代码mobile=models.CharField('手机号码',max_length=11)
中不指定default
参数或将其设置为default=None
,则在创建新的模型实例时,如果没有为mobile
字段提供具体的值,该字段将默认为NULL
值。
⑤语句 sex = models.IntegerField(default=0,choices=SEX) 的理解:
这个代码中的choices=SEX
定义了一个选项列表,其中每个选项都由一个值和对应的显示标签组成。在这个例子中,SEX
是一个包含元组的元组,每个元组有两个元素,第一个是存储的值,第二个是显示的标签。
在数据库中,sex
字段将使用整数存储,而不是字符串。当你在创建或更新对象时,可以使用这些选项中的任何一个值来表示性别。数据库中存储的是相应的整数值(0代表男,1代表女),但是在界面上或其他需要显示的地方,你可以使用元组中的显示标签(‘男’和’女’)来表示。
也就是说如果我写入一个值,这个值是字符串’男’,那么写入数据库的是整数0哈。
⑥语句 user_img=models.ImageField(“头像”,upload_to=“user_img”,default=“”) 的 upload_to=“user_img” 是什么意思?
答:在Django中,上传路径可以在模型字段的定义中通过upload_to
参数设置,也可以通过Django的配置文件进行全局设置。
-
模型字段中的设置:
在定义模型字段时,可以使用upload_to
参数来指定上传路径。例如:from django.db import models class MyModel(models.Model): image = models.ImageField(upload_to='my_upload_path/')
上述代码中,
upload_to
参数设置为'my_upload_path/'
,表示上传的文件将保存在MEDIA_ROOT/my_upload_path/
路径下,其中MEDIA_ROOT
是在Django的配置文件中设置的媒体文件根路径。 -
全局配置文件中的设置:
Django还提供了一个全局配置文件settings.py
,可以在其中设置默认的上传路径。在配置文件中,可以使用MEDIA_ROOT
和MEDIA_URL
两个设置来定义上传文件的根路径和对应的URL。例如:# settings.py MEDIA_ROOT = os.path.join(BASE_DIR, 'media') MEDIA_URL = '/media/'
上述配置中,
MEDIA_ROOT
指定了媒体文件的根路径为BASE_DIR/media
,MEDIA_URL
指定了该路径对应的URL为/media/
。在模型字段中不指定upload_to
参数时,文件将被保存在MEDIA_ROOT
设置的路径下。关于BASE_DIR
的详细介绍,请参考我的另一篇博文:https://blog.csdn.net/wenhao_ir/article/details/131598936
需要注意的是,在使用MEDIA_ROOT
和MEDIA_URL
进行设置时,确保在Django的URL配置中包含了相应的URL映射,以便可以正确地访问上传的文件。
⑦内部类Meta是什么东西?
关于这个问题的答案,请参见我的另一篇博文 https://blog.csdn.net/wenhao_ir/article/details/131600645
04-02-goods的模型创建及代码详解
04-02-1-拷贝common文件夹
把下面的common文件夹拷贝到根目录 E:\Python_project\P_001\myshop-test\good_info 中。
https://pan.baidu.com/s/115vpHu68sR3vDJqvBHuFUg?pwd=g9ow
在 common 目录下有文件base_model.py:
文件base_model.py的内容如下:
from django.db import models
class BaseModel(models.Model):
"""抽象基类"""
create_time = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
update_time = models.DateTimeField(auto_now=True, verbose_name="更新时间")
class Meta:
# 指定抽象基类
abstract = True
注意:在这个抽象基类中定义了字段“create_time”和“update_time ”。
04-02-2-代码写入模型文件 goods\models.py
打开文件:E:\Python_project\P_001\myshop-test\good_info\goods\models.py
定入下面的代码:
from django.db import models
from datetime import datetime
from users.models import MyUser
from common.base_model import BaseModel
class GoodsCategory(BaseModel):
id = models.AutoField(primary_key=True)
name = models.CharField(max_length=50, verbose_name='分类名称', default='')
parent = models.ForeignKey("self", null=True, blank=True, verbose_name="父类", on_delete=models.DO_NOTHING, related_name="sub_cat")
is_nav = models.BooleanField(default=False, verbose_name='是否显示在导航栏')
sort = models.IntegerField(verbose_name='排序')
def __str__(self):
return self.name
class Meta:
verbose_name = '商品分类'
verbose_name_plural = '商品分类'
db_table = 'd_goods_category' # 在数据库中的表名
class Goods(models.Model):
STATUS = (
(0, '正常'),
(1, '下架'),
)
name = models.CharField(max_length=50, verbose_name='商品名称', default='')
category = models.ForeignKey(GoodsCategory, blank=True, null=True, verbose_name='商品分类', on_delete=models.DO_NOTHING)
market_price = models.DecimalField(max_digits=8, default=0, decimal_places=2, verbose_name='市场价格')
price = models.DecimalField(max_digits=8, decimal_places=2, default=0, verbose_name='实际价格')
unit = models.CharField(max_length=10, verbose_name='计量单位', blank=True, null=True)
click_num = models.IntegerField(default=0, verbose_name="点击数")
amount = models.IntegerField(default=0, verbose_name="销售量")
stock_num = models.IntegerField(default=0, verbose_name="库存数")
fav_num = models.IntegerField(default=0, verbose_name="收藏数")
goods_desc = models.CharField(max_length=200, verbose_name='商品详情', default='',)
status = models.IntegerField(default=0, choices=STATUS)
is_recommend = models.BooleanField(default=False, verbose_name="是否推荐")
user = models.ForeignKey(MyUser, blank=True, null=True, verbose_name="用户", on_delete=models.DO_NOTHING)
createDate = models.DateTimeField(default=datetime.now, verbose_name='创建时间')
def __str__(self):
return self.name
class Meta:
verbose_name = '商品信息'
verbose_name_plural = '商品信息'
db_table = 'd_goods' # 在数据库中的表名
下面这句代码的理解请参考博文 https://blog.csdn.net/wenhao_ir/article/details/131708665
parent = models.ForeignKey("self", null=True, blank=True, verbose_name="父类", on_delete=models.DO_NOTHING, related_name="sub_cat")
05-创建数据库
数据库名:goodtest01
数据库用户名:goodtest01
数据库密码:aa123456
06-配置setting.py文件中的数据库信息
打开文件:E:\Python_project\P_001\myshop-test\good_info\good_info\settings.py
写入下面的数据库配置信息:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'goodtest01',
'USER': 'goodtest01',
'PASSWORD': 'aa123456',
'HOST': 'localhost',
'PORT': '3306',
# 取消外键约束,否则多对多模型迁移报django.db.utils.IntegrityError: (1215, 'Cannot add foreign key constraint')
'OPTIONS': {
"init_command": "SET foreign_key_checks = 0;",
'charset': 'utf8'
},
}
}
07-创建模型迁移和执行模型迁移命令
首先请把数据库打开。
首先请把数据库打开。
首先请把数据库打开。
然后执行下面的命令。
CD E:\Python_project\P_001\myshop-test\good_info\
E:
manage.py makemigrations
manage.py migrate
E:\Python_project\P_001\myshop-test\good_info>manage.py makemigrations
Migrations for 'goods':
goods\migrations\0001_initial.py
- Create model GoodsCategory
- Create model Goods
goods\migrations\0002_goods_user.py
- Add field user to goods
Migrations for 'users':
users\migrations\0001_initial.py
- Create model MyUser
08-创建后台管理员用户
运行下面的命令:
CD E:\Python_project\P_001\myshop-test\good_info\
E:
manage.py createsuperuser
从上面的过程来看,如果不指定管理员的用户名,则默认为:administrator,同时还可以输入管理员的邮箱。
我在上面设的密码为:bb123456
09-启动后台web服务并测试是否能登陆管理员帐户
运行下面这三条命令启动:
CD E:\Python_project\P_001\myshop-test\good_info\
E:
python manage.py runserver
访问下面这个URL进入Django自带的后台登陆页面:
http://127.0.0.1:8000/admin/
输入用户名(administrator)和密码(bb123456),登陆:
10-配置Admin后台管理系统
10-1-配置 goods/app.py 文件
把 goods/app.py 文件原来的代码:
from django.apps import AppConfig
class GoodsConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'goods'
改成下面这样:
from django.apps import AppConfig
class GoodsConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'goods'
verbose_name = "商品管理"
即加上代码verbose_name = "商品管理"
,这样“商品管理”会显示在Admin后台管理系统中的左侧菜单导航中。
10-2-设置 goods/__init__.py
文件
在goods/__init__.py
文件中写入下面的代码:
from .apps import GoodsConfig
default_app_config = 'goods.GoodsConfig'
关于语句:from .apps import GoodsConfig
的解释如下:
在Django中,.apps
是指从当前包(package)【也可以理解为当前目录】中导入一个名为apps
的模块(module)或子包(sub-package)。在上面的代码中,from .apps import GoodsConfig
的作用是从当前目录的apps模块中导入类 GoodsConfig 。
.apps
用于从当前包中导入GoodsConfig
。
具体来说,Django的应用(app)通常是一个包含apps.py
文件的Python包。apps.py
文件用于定义Django应用的配置类,其中包含应用的元数据信息,例如应用名称、显示名称等。通常情况下,Django会自动生成apps
模块,你可以通过导入它来访问应用的配置类。
假设你的项目结构如下:
my_project/
my_app/
__init__.py
apps.py
models.py
views.py
在apps.py
中,可能会定义类似如下的应用配置类:
# my_project/my_app/apps.py
from django.apps import AppConfig
class GoodsConfig(AppConfig):
name = 'my_app'
verbose_name = 'My Goods Application'
现在,如果你想在其他文件中引用GoodsConfig
这个配置类,可以使用相对导入的方式,如下所示:
# 任何其他.py文件
from .apps import GoodsConfig
# 使用GoodsConfig进行配置或其它操作
在这里,.apps
表示当前包(my_app
)中的apps
模块,然后从中导入了GoodsConfig
类。注意,apps
这个名称是由Django约定的,用于表示应用的配置模块。
总之,.apps
在这里是一个相对导入的语法,用于引用当前包中的apps
模块,并从中导入GoodsConfig
类。
关于语句:default_app_config = 'goods.GoodsConfig'
的解释如下:
在Django中,default_app_config
变量用于指定一个应用的默认配置类。当一个Django应用被加载时,它将查找该应用的apps.py
文件,并在其中寻找继承自AppConfig
的配置类(如果存在的话)。然后,Django将使用该配置类来配置应用的行为和元数据。
然而,有时候你可能希望在应用的apps.py
文件中定义配置类,但不希望Django自动使用它作为默认的应用配置。这种情况下,你可以手动指定默认的配置类,而不是让Django自动识别。
在你提供的代码中,default_app_config = 'goods.GoodsConfig'
的作用是明确指定应用goods
使用GoodsConfig
作为其默认配置类。这样做的好处是,即使Django自动检测到其他配置类,它也会优先选择使用GoodsConfig
作为该应用的配置类。
举例来说,假设你的应用goods
有如下结构:
goods/
__init__.py
apps.py
models.py
...
在apps.py
中定义了GoodsConfig
配置类:
# goods/apps.py
from django.apps import AppConfig
class GoodsConfig(AppConfig):
name = 'goods'
verbose_name = 'Goods Application'
然后在goods/__init__.py
中添加了default_app_config
变量:
# goods/__init__.py
from .apps import GoodsConfig
default_app_config = 'goods.GoodsConfig'
通过这样的设置,你可以确保GoodsConfig
会被作为goods
应用的默认配置类。即使Django自动发现了其他配置类,也会忽略它们并使用GoodsConfig
。
需要注意的是,default_app_config
变量只有在应用被加载之前设置才有效。在Django启动时,它会读取应用的__init__.py
文件,找到default_app_config
变量并应用它指定的配置类。因此,如果你在运行Django之前修改了该文件,确保default_app_config
的设置在Django加载应用之前生效。
10-3-配置admin.py文件
在文件:E:\Python_project\P_001\myshop-test\good_info\goods\admin.py 中写入下面的代码:
from django.contrib import admin
from goods.models import *
@admin.register(GoodsCategory)
class GoodsCategoryAdmin(admin.ModelAdmin):
admin.site.site_title = "我的商城-标签页标题"
admin.site.site_header = "我的商城-页面标题"
admin.site.index_title = "商城平台管理-后台管理主页标题"
# 设置列表中显示的字段
list_display = ['name', 'sort', 'create_time'] # 字段create_time定义在 from common.base_model import BaseModel 中
# 搜索
search_fields = ['name', 'parent_id']
# 过滤
list_filter = ['name', 'parent_id']
# 设置每页现实的数据量
list_per_page = 10
# 设置排序
ordering = ['sort']
@admin.register(Goods)
class GoodsAdmin(admin.ModelAdmin):
# 设置列表中显示的字段
list_display = ['name', 'market_price', 'price']
代码@admin.register(GoodsCategory)
是什么意思?
答:有两个作用。
①在Django中,@admin.register()
是一个装饰器(decorator),用于注册数据库模型类(Model)到后台管理界面。具体来说,@admin.register(GoodsCategory)
这行代码的作用是将 GoodsCategory
数据库模型类注册到Django后台管理界面,从而允许您在后台对该模型进行管理和操作。
一旦通过 @admin.register()
注册了一个数据库模型类,Django会自动创建一个对应的管理页面,该页面允许您查看、添加、修改和删除模型的实例。这样,您就可以在后台管理界面轻松地管理您的数据库中的 GoodsCategory
数据。
②在上面的代码中,GoodsCategoryAdmin
类被用作 GoodsCategory
模型的管理类,它继承自 admin.ModelAdmin
。通过在该类中定义不同的属性和方法,您可以自定义后台管理界面的外观和行为,例如定义要显示的字段、搜索和过滤选项、排序规则等等。
11-重新启动 Web服务及效果展示
CTRL+C结束掉之前启动的Web服务,然后重新启动:
CD E:\Python_project\P_001\myshop-test\good_info\
E:
python manage.py runserver
访问后台管理:
http://127.0.0.1:8000/admin/
用户名(administrator)和密码(bb123456)
把上面的这幅截图记为“Home图”
点击“Home图”中的“商品信息”,界面如下:
点击“Home图”中的“商品分类”,界面如下:
点击“Home图”中的“商品信息”右边的“+ Add”,界面如下:
点击“Home图”中的“商品分类”右边的“+ Add”,界面如下:
12-写入数据测试
12-1-创建一条“商品分类”数据
12-2-创建一条“商品信息”数据
13-整个Project的压缩包下载链接
整个Project的压缩包下载链接:
https://pan.baidu.com/s/1DwfwH79cE6SB67hZqa-Q3w?pwd=hyrd