Admin简介:
Admin:是django的后台 管理的wed版本
我们现在models.py文件里面建几张表:
class Author(models.Model): nid = models.AutoField(primary_key=True) name=models.CharField( max_length=32) age=models.IntegerField() # 与AuthorDetail建立一对一的关系 authorDetail=models.OneToOneField(to="AuthorDetail",on_delete=models.CASCADE) class AuthorDetail(models.Model): nid = models.AutoField(primary_key=True) birthday=models.DateField() telephone=models.BigIntegerField() addr=models.CharField( max_length=64) class Publish(models.Model): nid = models.AutoField(primary_key=True) name=models.CharField( max_length=32) city=models.CharField( max_length=32) email=models.EmailField() class Book(models.Model): nid = models.AutoField(primary_key=True) title = models.CharField( max_length=32) publishDate=models.DateField() price=models.DecimalField(max_digits=5,decimal_places=2) # 与Publish建立一对多的关系,外键字段建立在多的一方 publish=models.ForeignKey(to="Publish",to_field="nid",on_delete=models.CASCADE) # 与Author表建立多对多的关系,ManyToManyField可以建在两个模型中的任意一个,自动创建第三张表 authors=models.ManyToManyField(to='Author',)
然后执行数据库迁移的两条命令。
python3 manage.py makemigrations
python3 manage.py migrate
现在直接打开项目去访问admin肯定是不行的。他会提示你要先登陆。所以要先创建一个超级用户:python3 manage.py createsuperuser
然后再登陆进去,这时候发现登陆进去并不是我们创建的那些表,因为我们还没有在admin中注册。所以在app01下的admin中注册
from app01 import models admin.site.register(models.Book,Bookconfig) admin.site.register(models.AuthorDetail) admin.site.register(models.Author) admin.site.register(models.Publish)
注册之后,然后再访问admin地址,就会发现,我们注册了那张表就会有那个。
我们会发现每个表都是一个可点 的标签。我们可以进行曾删改查:
http://127.0.0.1:8000/admin/app02/food/ 查
http://127.0.0.1:8000/admin/app02/food/add/ 增
http://127.0.0.1:8000/admin/app02/food/1/change/ 改
http://127.0.0.1:8000/admin/app02/food/2/delete/ 删
现在我们点击book的那张表,是这个样子:
只能看到书的名字,那我们想看到书的其他字段呢?怎么办?
找到admin.py注册的地方,我们只是在admin中注册了,现在我们加上配置类,就可以看到其他的字段了。
class Bookconfig(admin.ModelAdmin): # list_display must not be a ManyToManyField 这里面不能放多对多的字段。 list_display = ['title','price','publish','publishDate'] # 设置可以显示的字段 list_display_links = ['price','title','publishDate'] # 设置有链接的字段 list_filter = ['title','publish', 'authors__nid','authors'] #设置过滤的条件, search_fields = ['title','price'] # 设置根据搜寻的字段,模糊查找 # 进行批量操作,actions def patch_init(self,request,queryset): queryset.update(price=0) # 初始化价格为0 patch_init.short_description = '价格初始化' # 批量操作的名字 actions = [patch_init] # 进行批量操作
这里有一个注意的地方,就是list_filter里面可以放外键关联的字段,也可以放多对多字段。举例:就像book表多对多author表,list_filter = ['title','publish', 'authors__nid','authors']
咱们写的这个类继承 admin.ModelAdmin,而admin.ModelAdmin这是个默认配置类,也就是说这个默认配置类自己配置了这些参数,如果我们不想用默认配置类的这些参数,我们就自己写参数覆盖默认配置类的参数就行了。
然后将我们写的这个类实例对象添加进admin.site.register(models.Book,Bookconfig)就行了。
上面说的是一些常用的配置参数,下面是一些其他的参数:
ModelAdmin中提供了大量的可定制功能,如
1. list_display,列表时,定制显示的列。
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd', 'xxxxx') def xxxxx(self, obj): return "xxxxx"
2. list_display_links,列表时,定制列可以点击跳转。
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd', 'xxxxx') list_display_links = ('pwd',)
3. list_filter,列表时,定制右侧快速筛选。
4. list_select_related,列表时,连表查询是否自动select_related
5. list_editable,列表时,可以编辑的列
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd','ug',) list_editable = ('ug',)
6. search_fields,列表时,模糊搜索的功能
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
search_fields = ('user', 'pwd')
7. date_hierarchy,列表时,对Date和DateTime类型进行搜索
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
date_hierarchy = 'ctime'
8 inlines,详细页面,如果有其他表和当前表做FK,那么详细页面可以进行动态增加和删除
class UserInfoInline(admin.StackedInline): # TabularInline
extra = 0
model = models.UserInfo
class GroupAdminMode(admin.ModelAdmin): list_display = ('id', 'title',) inlines = [UserInfoInline, ]
9 action,列表时,定制action中的操作
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
# 定制Action行为具体方法
def func(self, request, queryset): print(self, request, queryset) print(request.POST.getlist('_selected_action')) func.short_description = "中文显示自定义Actions" actions = [func, ] # Action选项都是在页面上方显示 actions_on_top = True # Action选项都是在页面下方显示 actions_on_bottom = False # 是否显示选择个数 actions_selection_counter = True
10 定制HTML模板
add_form_template = None
change_form_template = None
change_list_template = None
delete_confirmation_template = None
delete_selected_confirmation_template = None
object_history_template = None
11 raw_id_fields,详细页面,针对FK和M2M字段变成以Input框形式
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
raw_id_fields = ('FK字段', 'M2M字段',)
12 fields,详细页面时,显示字段的字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
fields = ('user',)
13 exclude,详细页面时,排除的字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
exclude = ('user',)
14 readonly_fields,详细页面时,只读字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
readonly_fields = ('user',)
15 fieldsets,详细页面时,使用fieldsets标签对数据进行分割显示
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
fieldsets = (
('基本数据', { 'fields': ('user', 'pwd', 'ctime',) }), ('其他', { 'classes': ('collapse', 'wide', 'extrapretty'), # 'collapse','wide', 'extrapretty' 'fields': ('user', 'pwd'), }), )
16 详细页面时,M2M显示时,数据移动选择(方向:上下和左右)
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)
17 ordering,列表时,数据排序规则
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
ordering = ('-id',) 或 def get_ordering(self, request): return ['-id', ]
18. radio_fields,详细页面时,使用radio显示选项(FK默认使用select)
radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL
19 form = ModelForm,用于定制用户请求时候表单验证
from app01 import models
from django.forms import ModelForm from django.forms import fields class MyForm(ModelForm): others = fields.CharField() class Meta: model = models = models.UserInfo fields = "__all__" @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): form = MyForm
20 empty_value_display = "列数据为空时,显示默认值"
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): empty_value_display = "列数据为空时,默认显示" list_display = ('user','pwd','up') def up(self,obj): return obj.user up.empty_value_display = "指定列数据为空时,默认显示"
这里就涉及到我们之前学的类的知识了。我们一起来回顾一下:
Class A(object): X = 10 Class B(A): X = 8 # 类变量 存在类里 .b = B() Print(b.x)
这个结果是什么呢?答案肯定是8
# class A(object): # x=10 # y=12 # # class B(A): # def __init__(self): # 实例变量 存在实例里 # self.y=10 # x=8 # y=20 # # b=B() # print(b.x) # print(b.y) 这个答案是多少?
答案是8和10,那如果这样呢?
# class A(object): # def __init__(self): # self.y=10 # x=10 # y=12 # class B(A): # x=8 # y=20 # b=B() # print(b.y) # print(b.x) 答案仍然是8和10 为什么呢?
这里面一定要区分类存储和实例存储的关系,先在实例空间中寻找,再找类空间,一个实例对象在存储的时候 先在自己的实例空间里寻找,如果找不到就从父类的实例空间中寻找,如果找不到,就在自己的类空间中寻找,然后再父的类空间中寻找。说白了,就是实例化一个对象时,要先执行__init__实例初始化,如果自己的类中没有__init__就去父类中去实例初始化。然后在类空间中寻找。
上面只是说了admin的使用,接下来我们来看一下admin的源码,看一下他是怎么工作的,我们先来复习一下单例模式。
什么是单例模式:
单例模式(Singleton Pattern)是一种常用的软件设计模式,该模式的主要目的是确保某一个类只有一个实例存在。他可以实例化多次,但都属于着一个类的,当你希望在整个系统中,某个类只能出现一个实例时,单例对象就能派上用场。
在 Python 中,我们可以用多种方法来实现单例模式:
- 使用模块
- 使用 __new__
- 使用装饰器(decorator)
- 使用元类(metaclass)
1.使用 __new__
class Singleton(object): _instance = None def __new__(cls, *args, **kw): #实例化的时候,执行__init__之前 if not cls._instance: cls._instance = super(Singleton, cls).__new__(cls, *args, **kw) return cls._instance s1 = Singleton() s2 = Singleton()
s1实例化之后,先走__new__,_instance默认为none,进入if判断,重新对cls.instance进行赋值,赋值的结果是执行了object类的__new__方法,其实就是拿到了一个实例化对象。最后返回cls.instance。
此时此刻,cls.instance的值就是object类实例化的那个对象。
S2实例化之后,走__new__,但是这时候,cls.instance已经有值了,所以不会再走if判断。直接返回。
所以两次实例化都是指向s1的内存空间。S1和s2是完全一样的。这就是__new__的思路。
2.使用模块
我们先创建一个main.py文件,在创建一个func.py文件。
大家觉得这两个id一样吗?答案是一样的
第二次导入的时候不会再执行func文件了,直接实例化,因为第一次已经导入过了。
在创建一个cal文件夹
大家看这个执行结果呢?这个结果肯定是一样的
只要导入一次,在整个程序中不管在调用多少次,他都不会在执行导入的那个模块中的内容,都是直接使用的。记住这句话就行了。
还有一个例子:
这个打印结果是什么?答案是三者的id都不一样。虽然他们都是用的同一个类但是实例化出了三个对象。
Admin源码是分为三部分:启动,注册阶段,设计url,
先看注册,admin.site.register(models.Book,Bookconfig) 我们需要重点了解一下site是什么,register方法中写了什么,以及models.Book,Bookconfig 这两个参数代表什么意思?
接下来我们看一下源码:
第一步:启动
数据库迁移完成之后,我们只在admin中xie了这些代码:
admin.site.register(models.Book,)
admin.site.register(models.AuthorDetail)
admin.site.register(models.Author)
admin.site.register(models.Publish)
django启动过程中,一定会先去加载settings中的INSTALL_APPS,拿INSTALL_APPS的第一个来说,'django.contrib.admin',这句话和 from django.contrib import admin的意思是一样的,加载的时候他会去加载from django.contrib import admin
点进去admin,这时候会执行from django.contrib.admin.sites import AdminSite, site。然后点进去sites,会发现有这么一行site = AdminSite()。这就是用到了单例模式。意思就是说,只要引入site模块,就实例化AdminSite这么一个对象。然后会执行
def autodiscover():
autodiscover_modules('admin', register_to=site)
这句话的意思是告诉django启动后先会执行app下的admin.py文件。
第二步:注册
运行app下的admin.py文件,只要遇到admin.site就是实例化一个site单例对象。
admin.site.register(models.Publish)
class Publishconfig(admin.ModelAdmin): pass
admin.site.register(models.Publish,Publishconfig)这是两种注册方法,不过是多了一个我们自己添加的类
接下来就是看register方法了:(这个register方法是site = AdminSite()类中的方法)点进去
我们只看两句话:第一句:
第二个参数默认是none,意思是可以不传这个参数,如果admin_class不传,就admin_class就等于Modeladmin。如果传第二个参数,就用的是自己的那个类,所以我们写的那个类要继承Modeladmin。
第二句:
self._registry[model] = admin_class(model, self)
这个_registry是在上面初始化的时候,赋值给_register一个空的字典。
def __init__(self, name='admin'):
self._registry = {}
所谓的注册功能就是在全局的单例对象的_registry字典里面添加键值对,以model为键,以 admin_class为值。而 admin_class就是第一句我们自己写的类或者默认类的一个实例对象
所以,admin.site.register(models.Publish)这句话执行完self._registry里就有一个Publish键值对了
在当我们注册admin.site.register(models.Author)的时候,self._registry里就会多一个Author键值对了。
我们可以打印一下print(admin.site._register)看看里面有几个键值对。在admin中注册了几个就有几个键值对。
可以根据下面的源码缕一缕:
解析admin的源码:
1 启动
django启动后,会加载settings中的install_app
admin.py:
from django.contrib.admin.sites import AdminSite, site
autodiscover_modules('admin', register_to=site):加载每一个app下的admin.py文件
2 注册
admin.site.register(Author)
class BookConfig(admin.ModelAdmin):
pass
admin.site.register(Book,BookConfig)
源码:
admin.py---sites.py---->
class AdminSite(object):
def __init__(self):
self._registry = {}
def register(self,model,admin_class=None):
if not admin_class:
admin_class = ModelAdmin
self._registry[model] = admin_class(model, self)
site = AdminSite()