Django admin组件源码流程

 admin 组件

　　Django 自带的用户后台组件

　　用于用户便携的操作

admin 组件核心

• 启动
• 注册
• 设计url

启动核心代码

　　每个app 通过 apps.py 扫描 admin.py 文件 并执行

"""
setting.py 

setting.py 中会对注册的 app 自动加载各自里面的 AppxxConfig 模块
""" 
INSTALLED_APPS = [
    ...
    'app01.apps.App01Config',
    'app02.apps.App02Config',
]

"""
apps.py

app下的里面的 adminConfig 在自动执行的时候可以进行启动操作
"""
from django.apps import AppConfig
class App01Config(AppConfig):
    name = 'app01'

"""
admin 源码 

调用每个app 下的admin.py 文件进行执行
"""
import admin
        # 执行每一个app下的admin.py文件
        autodiscover_modules('admin', register_to=site)

"""
admin.py

被执行的 admin.py 文件
"""
from django.contrib import admin
from rbac.models import *
# Register your models here.

 注册核心代码

 　　在admin.py 文件中对表进行注册

　　注册后的表要判断是否有自定义的配置文件

　　若没有则使用默认的 Modeladmin

"""
admin 注册流程核心源码
"""
class AdminSite(object):
    def __init__(self,name="admin"):
        # 定义一个空字典用于保存注册
        self._registry={}
        
    # 注册函数
    # 需要有两个参数， 被注册的表 以及 是否有自定义的配置操作
    def register(self, model, admin_class=None, **options):
        # 首先对是否存在自定义配置操作进行判断
        if not admin_class:
            # 如果无自定义则用默认的
            admin_class = Modeladmin
        # 有自己的就用自己的
        # 注意这里的键为类名而不是字符串 
        self._registry[model] = admin_class(model, self) 
            # {Book:ModelAdmin(Book),Publi sh:ModelAdmin(Publish)}

# 进行实例化实现单例模式
# 其他所有的程序中的 admin 通过引入，用的都是这个对象 
site=AdminSite()

"""
 admin.py 中对表进行注册操作
"""
from django.contrib import admin
from rbac.models import *
# Register your models here.

# 基于模块的单例模式从而实现所有的注册表都使用的同一个 admin.site 对象
admin.site.register(User)
admin.site.register(Role)
admin.site.register(Permission)

URL 分发核心代码

　　调用 urls() 方法

　　然后继续调用 get_urls() 方法

　　　　 遍历所有注册表，进行URL 的拼接合成最后生成一个列表返回给 urls.py

 　　最终在urls.py 进行调用

"""
urls.py

urls.py 中全部写成了一条
 所有的结果都在调用 urls方法后拿到
"""
urlpatterns = [
    url(r'^admin/', admin.site.urls),
]

"""
admin 设计url 核心

"""
class AdminSite(object):
    def get_urls(self):

        urlpatterns = [
            url(r'^$', wrap(self.index), name='index'),
            url(r'^login/$', self.login, name='login'),
            url(r'^logout/$', wrap(self.logout), name='logout'),
            url(r'^password_change/$', wrap(self.password_change, cacheable=True), name='password_change'),
            url(r'^password_change/done/$', wrap(self.password_change_done, cacheable=True),
                name='password_change_done'),
            url(r'^jsi18n/$', wrap(self.i18n_javascript, cacheable=True), name='jsi18n'),
            url(r'^r/(?P<content_type_id>\d+)/(?P<object_id>.+)/$', wrap(contenttype_views.shortcut),
                name='view_on_site'),
        ]
        valid_app_labels = []
        
        # 遍历注册过的表，对每个表生成 相应的 url 进行链接起来 
        for model, model_admin in self._registry.items():
            urlpatterns += [
                url(r'^%s/%s/' % (model._meta.app_label, model._meta.model_name), include(model_admin.urls)),
            ]
            if model._meta.app_label not in valid_app_labels:
                valid_app_labels.append(model._meta.app_label)


        if valid_app_labels:
            regex = r'^(?P<app_label>' + '|'.join(valid_app_labels) + ')/$'
            urlpatterns += [
                url(regex, wrap(self.app_index), name='app_list'),
            ]
        # 返回给urls 得出的 urls列表
        # 所有的urls 保存在 urlpatterns列表里面
        return urlpatterns
    
    # 调用 get_urls 获得全部的结果
    def urls(self):
        # 给urls.py 返回回去
        return self.get_urls(), 'admin', self.name 

ps：

　　url 的设计和分发合成是什么时候完成?

　　答案：

　　　　在项目启动的时候就完成

　　　　在表进行注册后，就已经生成了，而不是url来了再生成

　　　　本质上 django 启动就已经是启动了文件，不然你的admin 单例从何而来

模拟完成一个 Xadmin 组件实现 admin 组件的功能

"""
自己实现一个 Xadmin 模块来替换掉 admin

　　和 admin 一样需要 
    　　启动
    　　注册
    　　url 分发
"""



"""
启动
"""
# setting.py 
INSTALLED_APPS = [
    ...
    'Xadmin.apps.XadminConfig',
    'app01.apps.App01Config',
    'app02.apps.App02Config',
]

# apps.py
from django.apps import AppConfig
from django.utils.module_loading import autodiscover_modules

# Xadmin.py
class XadminConfig(AppConfig):
    name = 'Xadmin'
    """
    启动 
    """
    def ready(self):
        autodiscover_modules('Xadmin')


class ModelXadmin(object):
    def __init__(self,model,site):

        self.model=model
        self.site=site
    
    """    
    url 分发
    二级分发和视图函数放在 配置类里面
    不放在 注册类里面的原因：
        因为注册类 单例生成 导致所有的注册表的self里面无法区分出来彼此的 配置类
        如果放在 配置类中 self 就是注册表自己对应的 配置类 根本拿不到想要的数据（比如 表 本身）
        比如 在 配置类 中 self.model 就是那个表，（在init 中注册的都可以随便拿来用了）
    """     
    def list_view(self, request):
        print("self.model",self.model)

        data_list=self.model.objects.all()
        print("data_list",data_list)
        return render(request, 'list_view.html',{"data_list":data_list})

    def add_view(self, request):
        return render(request, 'add_view.html')

    def change_view(self, request, id):
        return render(request, 'change_view.html')

    def delete_view(self, request, id):
        return render(request, 'delete_view.html')
    
    
    def get_urls2(self):
        temp = []
        temp.append(url(r"^$", self.list_view))
        temp.append(url(r"^add/$", self.add_view))
        temp.append(url(r"^(\d+)/change/$", self.change_view))
        temp.append(url(r"^(\d+)/delete/$", self.delete_view))
        return temp

    @property
    def urls2(self):
        return self.get_urls2(), None, None


class XadminSite(object):
    def __init__(self,name="admin"):
        self._registry={}
"""
注册 
"""        
    def register(self, model, admin_class=None, **options):
        if not admin_class:
            admin_class = Modeladmin
        self._registry[model] = admin_class(model, self) 

"""
url 分发
"""    
    def get_urls(self):
        temp = []
        for model, admin_class_obj in self._registry.items():
            app_name = model._meta.app_label
            model_name = model._meta.model_name
            temp.append(url(r'^{0}/{1}/'.format(app_name, model_name), admin_class_obj.urls2), )
        return temp
        
    @property
    def urls(self):
        return self.get_urls(),None,None
        
        
site=XadminSite()        


# url.py
from Xadmin.service.Xadmin import site
urlpatterns = [
    url(r'^admin/',  admin.site.urls),
    url(r'^Xadmin/', site.urls),
]


"""
其他的程序使用方式

　　和以往admin的方式基本一致
"""

    """
    启动
    """
# setting.py
INSTALLED_APPS = [
    ...
    'app01.apps.App01Config',
    "app02.apps.App02Config"
]

# apps.py
from django.apps import AppConfig
class App01Config(AppConfig):
    name = 'app01'


# Xadmin.py
from Xadmin.service.Xadmin import site, ModelXadmin

    """
    注册 
    """    
site.register(Book, BookConfig)