Django中自定义admin Xadmin的实现代码


Posted in Python onAugust 09, 2019

在Django框架中,自带一个后台管理页面admin,这个管理页面很全,但是,有些并不是我们需要的,所以我们可以根据admin的实现流程来自定义自己的需求,即根据admin的实现方式来实现自定制--Xadmin

首先,我们先解析admin的流程,在Django中,我们在创建项目的时候,Django自带一个admin的url,实现了不同模型表的增删改查,那么admin是如何实现url的分发的?

我们可以从三部分来看admin的路由分发实现

1,启动

我们可以通过from django.contrib import admin来看admin是如何启动的

Django启动后,会在manage.py文件中加载配置文件settings.py  ,在settings.py中有一个INSTALLED_APPS这个配置项,Django会按照配置项的内容一次加载每一个app.

# Application definition

INSTALLED_APPS = [
 'django.contrib.admin',
 'django.contrib.auth',
 'django.contrib.contenttypes',
 'django.contrib.sessions',
 'django.contrib.messages',
 'django.contrib.staticfiles',
 'Xadmin.apps.XadminConfig',
 'blogs.apps.BlogsConfig',
 'bigs.apps.BigsConfig',
]

加载到django.contrib.admin时,会加载admin相关的,我们点击admin,进入admin的__init__.py文件,

from django.contrib.admin.sites import AdminSite, site
from django.utils.module_loading import autodiscover_modules

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

执行auto_discover这个接口,会自动的加载所有APP中的admin.py这个文件,这就是admin的启动文件

2,注册

自动加载所有APP下的admin.py文件时,会一次记录所有执行了admin.site.register(模型类)这个方法的模型类,从而完成模型类的注册。

所有的模型类都执行admin.site.register()这个方法后完成的注册,那么这个方法内部都做了些什么?

我们可以点击site进入admin的源码中,得到这个:site = AdminSite()  site是一个对象,是AdminSite这个类的一个对象,并且是一个单例对象,那么我们就可以肯定,register是这个单例对象的一个方法,那这个方法中到底做了什么?

class AdminSite(object):
 """
 An AdminSite object encapsulates an instance of the Django admin application, ready
 to be hooked in to your URLconf. Models are registered with the AdminSite using the
 register() method, and the get_urls() method can then be used to access Django view
 functions that present a full admin interface for the collection of registered
 models.
 """
 def __init__(self, name='admin'):
 self._registry = {} # model_class class -> admin_class instance
 self.name = name
 # 关于register的方法
 def register(self, model_or_iterable, admin_class=None, **options):
 if not admin_class:
  admin_class = ModelAdmin
 # Instantiate the admin class to save in the registry
 self._registry[model] = admin_class(model, self)
 #备注:截取的源码中的一部分

示例site对象时,会生成一个self._registry={}这个对象属性,如果我们没有指定admin_class,那么admin_class就是ModelAdmin,由此可以看出,admin_class是admin提供给我们定制页面的一个自定义类,这个类必须继承ModelAdmin这个类,以下是:

class ModelAdmin(BaseModelAdmin):
 "Encapsulates all admin options and functionality for a given model."

 list_display = ('__str__',)
 list_display_links = ()
 list_filter = ()
 list_select_related = False
 list_per_page = 100
 list_max_show_all = 200
 list_editable = ()
 search_fields = ()
 date_hierarchy = None
 save_as = False
 save_as_continue = True
 save_on_top = False
 paginator = Paginator
 preserve_filters = True
 inlines = []

 # Custom templates (designed to be over-ridden in subclasses)
 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
 popup_response_template = None

 # Actions
 actions = []
 action_form = helpers.ActionForm
 actions_on_top = True
 actions_on_bottom = False
 actions_selection_counter = True
 checks_class = ModelAdminChecks

 def __init__(self, model, admin_site):
 self.model = model
 self.opts = model._meta
 self.admin_site = admin_site
 super(ModelAdmin, self).__init__()

 def __str__(self):
 return "%s.%s" % (self.model._meta.app_label, self.__class__.__name__)

所以不管有没有自定制样式类,都会执行self._registry[model] = admin_class(model, self),也就是说,注册一个模型类,就会在对象的_registry这个字典中添加一个键值对,这个键是我们注册的这个模型类 model,值是继承ModelAdmin的样式类或者ModelAdmin这个类的一个对象。

3,设计url

因为site是一个单例对象,所以admin在执行完所有admin.py文件后,就会得到整个全局的一个包含所有注册模型的字典_registry,得到这个self._registry(也就是admin.site对象)字典,我们可以for循环这个admin.site._registry字典,得到这些键值对,那么得到这些键值对有什么用呢?这就是admin设计url时会用到的。

我们访问admin这个后台管理页面会发现,这个页面关于我们注册的所有模型都会实现增删改查功能,每个功能界面对应不同的模型类时,除了数据不同外,是一样的,也就是说,admin对于不同的模型类用到是一套url,一套模板,那么这个url是怎么设计的呢?

我们分别访问不同的模型类的这四个功能页面,会发现一个规律:

查询页面url: http://IP:PORT/admin/app名/模型类的名字(全部小写)/

添加页面url:   http://IP:PORT/admin/app名/模型类的名字(全部小写)/add

编辑页面url:http://IP:PORT/admin/app名/模型类的名字(全部小写)/id值/change

删除页面url:http://IP:PORT/admin/app名/模型类的名字(全部小写)/id值/delete

通过这个规律可以看出url分发的实现

但是在这个实现的过程中,我们有一个需要注意的时,用户访问的请求携带的路径是一个字符串的类型,我们可以通过request.path得到用户访问的路径,也就能得到用户访问的是哪个APP下的哪个模型类,但是这两个参数都是字符串的类型,如何通过字符串得到用户访问的哪张表,这是个麻烦,这时,可能我们会想到使用importlib模块来得到这个类,但是,这样这个过程很麻烦,Django为我们封装好了相应的方法:我们可以通过这个模型类的类名,通过._meta.model_name这个方法得到对应的字符串形式的类名,同样的我们也可以通过这个类名._meta.app_label得到字符串格式的相应的APP名

# 使用model代指模型类的类名
model._meta.model_name #得到字符串格式的类名(全小写的)
model._meta.app_label #可以得到当前类所在APP的字符串的名字
# 补充
model._meta.get_field("字符串格式的字段属性") # 得到一个字段属性的对象field_obj,这样我们就可以利用这个字段对象取得属性











 # 比如: field_obj.verbose_name

通过这两个封装的方法,就完美的解决了我们头疼的问题

from django.conf.urls import url

from django.contrib import admin

def get_urls_operate():
 emp = []
 emp.append(url(r'^$',查询页面的视图函数))
 emp.append(url(r'^add/$',添加页面的视图函数))
 emp.append(url(r'^(\d+)/change/$',编辑页面的视图函数))
 emp.append(url(r'^(\d+)/delete/$',删除页面的视图函数))
 return emp


def get_urls():
 temp = []
 for model,main_class_obj in admin.site._registry.items():
 app_name = model._meta.app_label
 model_name = model._meta.model_name
 temp.append(url(r'^{}/{}/'.format(app_name,model_name),(get_urls_operate(),None,None))) #实现第二层路由的分发
 return temp

urlpatterns = [
 url(r'^Xadmin/',(get_urls(),None,None)) #自定义一个前缀 实现第一层路由的分发
]

这样我们就实现一个通过一个路由实现不同场景的分发

通过这三部分,我们可以按照admin的实现方式,来自定制Xadmin

我们了解了admin内部的实现流程,我们可以将这个实现过程封装到一个类中。

我们自定制Xadmin时,也要按照admin的流程实现,首先是启动项,admin中,Django启动时,会自动的执行每个app下的admin.py文件,我们可以自定制为启动时,自动执行app下的每个自定制的.py文件,比如Xadmin.py 文件,那么如何达到Django启动的时候帮我们自动扫描加载我们自定制的Xadmin.py文件呢?这是个问题

我们观察可以发现,Django在启动时,会加载配置文件settings.py ,在settings.py文件中,有一个INSTALLED_APPS这个列表,这个列表中,放置着我们在Django项目中的所有app的配置信息,我们观察这个列表:我们自己开启的APP,在设置配置信息时,会在APP名字后加一个.apps.(app名首字母大写)Config这个东西,而对应的在我们的app下,Django会给我们自动的配置一个apps.py文件,那么这个apps.py文件有什么作用呢,我们打开这个apps.py文件,看看里面的配置信息:

以blogs这个APP为例:

from django.apps import AppConfig
class BlogsConfig(AppConfig):
 name = 'blogs'

我们可以发现,里面定义了一个类,这个类的类名就是settings配置信息中apps后面跟的那个东东,这个类中有一个静态属性name是当前的APP名,这个类继承了AppConfig这个类。这就是我们从这个.py文件中所能得的所有东西,乍一看,没有什么有用的信息,那么我们只能从它继承的类中找了

MODELS_MODULE_NAME = 'models'
class AppConfig(object):
 """
 Class representing a Django application and its configuration.
 """
 def __init__(self, app_name, app_module):
 # Full Python path to the application eg. 'django.contrib.admin'.
 self.name = app_name

 def ready(self):
 """
 Override this method in subclasses to run code when Django starts.

#这句话的语义为:在子类中重写此方法,以便在Django启动时运行代码
 """

查看整个AppConfig,我们可以把我们的要启动的代码放置在重写的ready方法中即可

from django.apps import AppConfig
from django.utils.module_loading import autodiscover_modules
class XadminConfig(AppConfig):
 name = 'Xadmin'
 def ready(self):
  autodiscover_modules('Xadmin') #Django启动时会自动扫描每个app下的Xadmin.py文件

这样,我们就完成了自定制Xadmin的启动阶段,启动后我们就要进行下一步注册

 在每个app下的Xadmin.py 文件中注册模型

以blogs这个APP下的UserInfo、Book为例:

from blogs import models
from Xadmin.service.Xadmin import site
site.register(models.UserInfo)
site.register(models.Book)

 

接下了就是设计url了,我们可以仿照admin的方式,在单例对象admin.site的这个类中封装好这些方法

from django.conf.urls import url
from django.shortcuts import HttpResponse,render
class ModelXadmin(object):
 def __init__(self,model,site):
  self.model = model
  self.site = site
 def show(self,request):
  data_list = self.model.objects.all()
  return render(request,'show.html',locals()) #locals() 请函数内部所有的键值对存储 == {"data_list":data_list}
 def add(self,request):
  return HttpResponse('添加页面')
 def edit(self,request, pk):
  return HttpResponse('编辑页面')
 def delete(self,request, pk):
  return HttpResponse('删除页面')
 @property
 def get_urls_operate(self):
  emp = []
  emp.append(url(r'^$', self.show))
  emp.append(url(r'^add/$', self.add))
  emp.append(url(r'^(\d+)/change/$', self.edit))
  emp.append(url(r'^(\d+)/delete/$', self.delete))
  return emp
 @property
 def urls(self):
  return self.get_urls_operate,None,None
class XadminSite(object):
 def __init__(self,name='xadmin'):
  self._registry = {}
 def register(self,model,class_main=None,**option):
  if not class_main:
   class_main = ModelXadmin
  self._registry[model] = class_main(model,self)
 @property
 def get_urls(self):
  # print(admin.site._registry)
  temp = []
  for model, model_admin_object in self._registry.items():
   model_name = model._meta.model_name
   model_app = model._meta.app_label
   temp.append(url(r'^{}/{}/'.format(model_app, model_name), model_admin_object.urls))
  return temp
 @property
 def urls(self):
  return self.get_urls,None,None
site = XadminSite()

 备注:一个关键点,为什么把第二层分发设置在了ModelXadmin这个类中,那肯定是放在这个类中能有什么好处,如果我们把这个二级分发放在XadminSite中,那么我们要取得每一个模型的数据是很麻烦的,但是,如果我们把这个放在ModelXadmin中,由于,在register(注册)时,我们给class_admin(XadminSite)传了每一个模型类,所以放在这个类中,我们可以通过self.model这个属性获得每个模型类的数据(self.model.objects.all()),这样就很容易得到这个模型表。

总结

以上所述是小编给大家介绍的Django中自定义admin Xadmin的实现代码 ,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对三水点靠木网站的支持!
如果你觉得本文对你有帮助,欢迎转载,烦请注明出处,谢谢!

Python 相关文章推荐
跟老齐学Python之用while来循环
Oct 02 Python
利用Python的Flask框架来构建一个简单的数字商品支付解决方案
Mar 31 Python
Python删除空文件和空文件夹的方法
Jul 14 Python
Python队列的定义与使用方法示例
Jun 24 Python
详解K-means算法在Python中的实现
Dec 05 Python
对python3标准库httpclient的使用详解
Dec 18 Python
python中的数据结构比较
May 13 Python
介绍一款python类型检查工具pyright(推荐)
Jul 03 Python
详解Python用三种方式统计词频的方法
Jul 29 Python
python logging通过json文件配置的步骤
Apr 27 Python
Python调用OpenCV实现图像平滑代码实例
Jun 19 Python
Python实战之实现简易的学生选课系统
May 25 Python
python输出决策树图形的例子
Aug 09 #Python
Python实现决策树并且使用Graphviz可视化的例子
Aug 09 #Python
Django ORM 常用字段与不常用字段汇总
Aug 09 #Python
详解如何减少python内存的消耗
Aug 09 #Python
Django命名URL和反向解析URL实现解析
Aug 09 #Python
利用python list完成最简单的DB连接池方法
Aug 09 #Python
python使用requests.session模拟登录
Aug 09 #Python
You might like
谈谈PHP语法(4)
2006/10/09 PHP
PHP语法速查表
2007/01/02 PHP
Windows IIS PHP 5.2 安装与配置方法
2009/06/08 PHP
PHP中调用ASP.NET的WebService的代码
2011/04/22 PHP
php对图像的各种处理函数代码小结
2013/07/08 PHP
PHP中file_get_contents高?用法实例
2014/09/24 PHP
php中使用base HTTP验证的方法
2015/04/20 PHP
php使用cookie实现记住用户名和密码实现代码
2015/04/27 PHP
使用PHP+Redis实现延迟任务,实现自动取消订单功能
2019/11/21 PHP
用JavaScript脚本实现Web页面信息交互
2006/12/21 Javascript
JavaScript中常见陷阱小结
2010/04/27 Javascript
JQuery扩展插件Validate 5添加自定义验证方法
2011/09/05 Javascript
关于jQuery新的事件绑定机制on()的使用技巧
2013/04/26 Javascript
浅谈JavaScript 中有关时间对象的方法
2016/08/15 Javascript
js+css3制作时钟特效
2016/10/16 Javascript
javascript九宫格图片随机打乱位置的实现方法
2017/03/15 Javascript
利用JavaScript在网页实现八数码启发式A*算法动画效果
2017/04/16 Javascript
vuejs2.0子组件改变父组件的数据实例
2017/05/10 Javascript
详解Angular4 路由设置相关
2017/08/26 Javascript
js简单的分页器插件代码实例
2019/09/11 Javascript
微信小程序swiper实现文字纵向轮播提示效果
2020/01/21 Javascript
vue实现用户长时间不操作自动退出登录功能的实现代码
2020/07/23 Javascript
小程序实现列表展开收起效果
2020/07/29 Javascript
python实现中文转换url编码的方法
2016/06/14 Python
python中利用zfill方法自动给数字前面补0
2018/04/10 Python
用Python调用win命令行提高工作效率的实例
2019/08/14 Python
Python连接字符串过程详解
2020/01/06 Python
python开发一款翻译工具
2020/10/10 Python
CSS3地图动态实例代码(圆圈向外扩散)
2018/06/15 HTML / CSS
HTML5的结构和语义(1):前言
2008/10/17 HTML / CSS
HTML5中的Article和Section元素认识及使用
2013/03/22 HTML / CSS
触摸春天教学反思
2014/02/03 职场文书
领导干部廉政承诺书
2014/03/27 职场文书
大学生就业协议书范本(适用于公司企业)
2014/10/07 职场文书
MYSQL 无法识别中文的永久解决方法
2021/06/03 MySQL
入门学习Go的基本语法
2021/07/07 Golang