admin组件

Django 提供了基于 web 的管理工具。

Django 自动管理工具是 django.contrib 的一部分。你可以在项目的 settings.py 中的 INSTALLED_APPS 看到它：

# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    "app01"
]

一 路由

urlpatterns = [
    path('admin/', admin.site.urls),
]

二 创建超级用户

　　启动开发服务器，然后在浏览器中访问 http://127.0.0.1:8000/admin/，得到登陆界面，你可以通过命令 python manage.py createsuperuser 来创建超级用户。

为了让 admin 界面管理某个数据模型，我们需要先注册该数据模型到 admin

python manage.py createsuperuser

三 注册模型类

1 模型models.py

from django.db import models

# Create your models here.
class Book(models.Model):
    '''
        创建书籍表
    '''
    title = models.CharField(max_length=32)
    pub_date = models.DateField()
    price = models.DecimalField(max_digits=5, decimal_places=2)

    # 创建一对多的关系:一个出版社可以对应多本书
    publish = models.ForeignKey(to='Publish', null=True, on_delete=models.CASCADE)

    # 书籍与作者创建多对多的关系
    authors = models.ManyToManyField(to='Author')
    def __str__(self):
        return self.title

class Publish(models.Model):
    '''
       创建出版社表
    '''
    name = models.CharField(max_length=32)
    city = models.CharField(max_length=32)
    email = models.EmailField()
    def __str__(self):
        return self.name

class Author(models.Model):
    '''
    创建作者表
    '''
    name=models.CharField(max_length=32)
    age=models.IntegerField()

    # 作者与authordetail建立一对一关系
    authordetail=models.OneToOneField(to='AuthorDetail',null=True,on_delete=models.CASCADE)
    def __str__(self):
        return self.name

class AuthorDetail(models.Model):
    '''
    创建作者详细信息表
    '''
    birthday=models.DateField()
    telephone=models.BigIntegerField()
    addr=models.CharField(max_length=64)
    def __str__(self):
        return self.addr

app01.models.py

from django.db import models

# Create your models here.
class Emp(models.Model):
    name=models.CharField(max_length=32)
    age=models.IntegerField()
    salary=models.DecimalField(max_digits=8,decimal_places=2)
    dep=models.CharField(max_length=32)
    province=models.CharField(max_length=32)

class Article(models.Model):
    title=models.CharField(max_length=32)
    comment_num=models.IntegerField()
    poll_num=models.IntegerField()
    def __str__(self):return self.title

app02.models.py

2 注册模型类

from django.contrib import admin

# Register your models here.
#导入模型类
from .models import Book
from .models import Publish
from .models import Author
from .models import AuthorDetail
# 注册模型类
# admin.site.register(self, model_or_iterable, admin_class=None, **options):
admin.site.register(Book,BookConfig)
admin.site.register(Publish,PublishCofig)
admin.site.register(AuthorDetail)
admin.site.register(Author,AuthorConfig)

四 基本方法

from django.contrib import admin

# Register your models here.
#导入模型类
from .models import Book
from .models import Publish
from .models import Author
from .models import AuthorDetail

#自定义模型类显示
class PublishCofig(admin.ModelAdmin):
    list_display=['name','city','email']
#显示多对多,显示一本书籍有多个作者
class BookConfig(admin.ModelAdmin):
    def show_authors(self,obj):
        # print(obj.authors.all())
        return ",".join([obj.name for obj in obj.authors.all()])
　　
    list_display = ['title','price','pub_date','publish','show_authors']
    list_display_links = ['title','price']  #添加可以进入编辑的字段
    search_fields = ['title','price'] #'或' 搜索,只要包含某字符就可以返回结果
    list_filter = ['authors','publish'] #定义右侧过滤器
    ordering = ['-price']

    #批量处理action
    #批量把书籍的价格调整为100
    def price_init(self,request,queryset):
        queryset.update(price=100)

    price_init.short_description = "价格改为一百"
    actions=[price_init,]

from django.utils.html import mark_safe #过滤标签符号的转义
class AuthorConfig(admin.ModelAdmin):
    def show_tag(self,obj):
        # print(obj)
        return mark_safe("<a href='#'>删除</a>")
    list_display = ['name','age','show_tag']

# 注册模型类
# admin.site.register(self, model_or_iterable, admin_class=None, **options):
admin.site.register(Book,BookConfig)
admin.site.register(Publish,PublishCofig)
admin.site.register(AuthorDetail)
admin.site.register(Author,AuthorConfig)

方法汇总

1. list_display，列表时，定制显示的列。
　　list_display = ['title','price','pub_date','publish','show_authors'] #列表中加字段或者自定义方法

2. list_display_links，列表时，定制列可以点击跳转。
　　list_display_links = ['title','price']　

3. list_filter，列表时，定制右侧快速筛选。
 　　list_filter = ['authors','publish'] #定义右侧过滤器

4. list_select_related，列表时，连表查询是否自动select_related

5. list_editable，列表时，可以编辑的列  显示为输入标签

6. search_fields，列表时，模糊搜索的功能
　　search_fields = ['title','price']　　
7. date_hierarchy，列表时，对Date和DateTime类型进行搜索

8  inlines，详细页面，如果有其他表和当前表做FK，那么详细页面可以进行动态增加和删除

9 action，列表时，定制action中的操作
    #批量处理action
    #批量把书籍的价格调整为100
    def price_init(self,request,queryset):
        queryset.update(price=100)

    price_init.short_description = "价格改为一百"
    actions=[price_init,]
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框形式

12  fields，详细页面时，显示字段的字段

13 exclude，详细页面时，排除的字段

14  readonly_fields，详细页面时，只读字段

15 fieldsets，详细页面时，使用fieldsets标签对数据进行分割显示

16 详细页面时，M2M显示时，数据移动选择（方向：上下和左右）

17 ordering，列表时，数据排序规则
    ordering = ['-price']
18. radio_fields，详细页面时，使用radio显示选项（FK默认使用select） 19 form = ModelForm，用于定制用户请求时候表单验证

五 admin 源码分析

1 单利模式----只有一个实例

　　单例模式（Singleton Pattern）是一种常用的软件设计模式，该模式的主要目的是确保某一个类只有一个实例存在。当你希望在整个系统中，某个类只能出现一个实例时，单例对象就能派上用场。

　　基于模块的单利模式------在模块中实例化类，之后无论哪个文件读取这个类，都是同一个类，指向同一个内存空间。

# mysingleton.py
class My_Singleton(object):
    def foo(self):
        pass

my_singleton = My_Singleton()#类的实例

　　在另一个py文件中引用这个实例

from mysingleton import my_singleton

my_singleton.foo()

　　我们应用的这个实例所对应的内存地址，为在mysingleton.py文件中创建的实例对象内存地址一致，模块只会执行一次，我们引用的实例对象只有一个。

　　基于__new__方法的单例模式

class Singleton(object):
    _instance = None
    def __new__(cls, *args, **kw):
        if not cls._instance:
            cls._instance = super(Singleton, cls).__new__(cls, *args, **kw)
        return cls._instance  

class MyClass(Singleton):
    a = 1

　　在上面的代码中，我们将类的实例和一个类变量 _instance 关联起来，如果 cls._instance 为 None 则创建实例，否则直接返回 cls._instance。

2 admin 的执行流程

　　点击admin 进入源码

<1> 循环加载执行所有已经注册的app中的admin.py文件

def autodiscover():
    autodiscover_modules('admin', register_to=site)

<2> 执行代码

＃admin.py

class BookConfig(admin.ModelAdmin):
    list_display = ("title",'publishDate', 'price')

admin.site.register(Book, BookConfig) 
...

<3> admin.site   ------>基于模块的单利模式

这里应用的是一个单例模式，对于AdminSite类的一个单例模式，执行的每一个app中的每一个admin.site都是一个对象

<4> 执行register方法

register(self, model_or_iterable, admin_class=None, **options):

　　admin_class传值的话就执行admin_class,否则执行ModelAdmin.最后把模型[model]和admin(model,self)放入self._register字典中

在每一个app的admin .py中加上

print(admin.site._registry)   ＃ 执行结果？

admin.site._registry指向的是同一个地址，故后一个app的key:value是直接添加在上一个app的后面

{
<class 'django.contrib.auth.models.Group'>: <django.contrib.auth.admin.GroupAdmin object at 0x00000218CDF046D8>,
 <class 'django.contrib.auth.models.User'>: <django.contrib.auth.admin.UserAdmin object at 0x00000218CDF337B8>,

 <class 'app01.models.Book'>: <app01.admin.BookConfig object at 0x00000218CDF48AC8>,
 <class 'app01.models.Publish'>: <app01.admin.PublishConfig object at 0x00000218CDF48B00>,
 <class 'app01.models.Author'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48B38>,
 <class 'app01.models.AuthorDetail'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48B70>}

 {<class 'django.contrib.auth.models.Group'>: <django.contrib.auth.admin.GroupAdmin object at 0x00000218CDF046D8>,
 <class 'django.contrib.auth.models.User'>: <django.contrib.auth.admin.UserAdmin object at 0x00000218CDF337B8>, 

 <class 'app01.models.Book'>: <app01.admin.BookConfig object at 0x00000218CDF48AC8>,
 <class 'app01.models.Publish'>: <app01.admin.PublishConfig object at 0x00000218CDF48B00>,
 <class 'app01.models.Author'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48B38>,
 <class 'app01.models.AuthorDetail'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48B70>,
 <class 'app02.models.Article'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48A90>,
 <class 'app02.models.Emp'>: <django.contrib.admin.options.ModelAdmin object at 0x00000218CDF48908>}

admin.site._registry

<5>admin的URL配置

urlpatterns = [
    url(r'^admin/', admin.site.urls),
]

六 url 分发

　　1 一级分发

    path('index/',([
              path('test01/', test01),
              path('test02/', test02),
                   ],None,None)),

　　2 二级分发

    path('index/',([
                  path('name/', ([
                                   path('alex/', test01),
                                   path('egon/', test02),
                                   ],None,None)),
                  path('shop/', ([
                                     path('apple/',  test03),
                                     path('xiaomi/', test04),
                                     path('huawei/', test05),
                                   ],None,None)),
                       ],None,None)),

　　3 二级分发实例

#urls.py

from django.contrib import admin
from django.urls import path,re_path
from django.conf.urls import url

from django.shortcuts import  HttpResponse

def add_view(request):
    return HttpResponse("add_view...")
def list_view(request):
    return HttpResponse("list_view...")
def change_view(request,id):
    return HttpResponse("change_view...")
def delete_view(request,id):
    return HttpResponse("delete_view...")

def get_urls2():
    temp=[

        path('', list_view),
        path('add/', add_view),
        re_path('(\d+)/change/', change_view),
        re_path('(\d+)/delete/', delete_view),

    ]

    return temp

def get_urls():
    print("------>",admin.site._registry)

#{Book:BookCongfigObj,Publish:PublishConfigObj,.....}
    temp = [

    ]
    for model,config_obj in admin.site._registry.items():
        model_name=model._meta.model_name
        app_label=model._meta.app_label
        temp.append(
            path('%s/%s/' % (app_label, model_name), (get_urls2(),None,None)),
        )

    return temp

urlpatterns = [
    path('admin/', admin.site.urls),
    # 二级分发应用
    path('yuan/',(get_urls(),None,None)),
]