zoukankan      html  css  js  c++  java
  • 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,拿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()
                      

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

     

  • 相关阅读:
    Pandas之groupby分组
    Pandas之isna,fillna
    Spark算子
    Spark算子
    常见排序算法
    Ubuntu18关机时出现 A stop job is running for ...导致关机很慢
    攻防世界-crypto-Decode_The_File(base64隐写)
    攻防世界-crypto-Decrypt-the-Message(Poem Codes-诗歌密码)
    ubuntu 安装比特币钱包
    netapp 常用命令
  • 原文地址:https://www.cnblogs.com/yb635238477/p/9545095.html
Copyright © 2011-2022 走看看