django中的admin组件

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

 加载的时候他回去加载from django.contrib import admin

 点进去admin,这时候会执行from django.contrib.admin.sites import AdminSite, site。然后点进去sites,会发现有这么一行site = AdminSite()。这就是用到了单例模式。意思就是说,只要引入site模块,就实例化这么一个对象。然后回执行

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是在上面初始化的时候

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键值对了。

可以根据下面的源码缕一缕:

解析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()
                  

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

猜你喜欢

转载自www.cnblogs.com/yb635238477/p/9545095.html