一、如图所示
from django.contrib import adminfrom . import modelsclass zhangsan(admin.ModelAdmin): list_display = ('name', 'email') list_editable = ('email',) search_fields = ["name"] date_hierarchy = 'ctime'admin.site.register(models.UserInfo,zhangsan) adango admin源码
site = AdminSite()
def register(self, model_or_iterable, admin_class=None, **options): if not admin_class: admin_class = ModelAdmin if isinstance(model_or_iterable, ModelBase): model_or_iterable = [model_or_iterable] for model in model_or_iterable: if model._meta.abstract: raise ImproperlyConfigured( 'The model %s is abstract, so it cannot be registered with admin.' % model.__name__ ) if model in self._registry: raise AlreadyRegistered('The model %s is already registered' % model.__name__) if not model._meta.swapped: if options: options['__module__'] = __name__ admin_class = type("%sAdmin" % model.__name__, (admin_class,), options) self._registry[model] = admin_class(model, self)
1、admin会通过admin.site.register(models.类名,模板类)的方式来注册models中的类。从源码中可以看出,如果我们没有写模板类的话源码就会默认继承ModelAdmin这个模板类,如果我们写了模板类的化也是在继承ModelAdmin这个类的基础上修改模板。
2、由django admin源码可知site其实是个对象,该对象是个单例模式,而admin.site.register(x,y)实际是admin通过site对象来调用site对象下的register方法,并且还传入了x,y两个参数,其中x指的是models中需要注册的类名,y指代的是注册的类需要使用的模板类。
3、通过源码 self._registry[model] = admin_class(model, self)就可以看出admin.site.register(x,y)最终得到的结果是个字典,其中字典的k指代的是注册的类,字典的v指代的是模板类实例化产生的对象,而为这个对象传递进去的参数是注册的类
总结:admin中注册的最终目的是生成一个字典,字典的k是注册的类,v指的是模板类实例化产生的对象,并且为这个对象传递进去的参数是注册的类
二、先注册再路由
1、为什么会先注册models中的类,再执行路由函数是因为在admin模块中有如下代码:
def autodiscover(): autodiscover_modules('admin', register_to=site)
总结:该代码的作用就是告诉django先执行admin.py文件内的代码,注册好类后再执行路由函数
2、通过模块写一个方法先执行xxx函数,再执行路由函数
from django.apps import AppConfigclass App01Config(AppConfig): name = 'app01' def ready(self): from django.utils.module_loading import autodiscover_modules autodiscover_modules('xxx')
总结:当app程序启动之前就会先找到xxx函数执行里面的代码,然后再执行路由系统
注释:当app程序启动之前就会先去所有的app中找到xxx函数执行里面的代码,然后执行路由系统
三、admin 路由
urlpatterns = [ url(r'^admin/', admin.site.urls),] admin 路由源码
@property def urls(self): return self.get_urls(), 'admin', self.name
def get_urls(self): from django.conf.urls import url, include from django.contrib.contenttypes import views as contenttype_views def wrap(view, cacheable=False): def wrapper(*args, **kwargs): return self.admin_view(view, cacheable)(*args, **kwargs) wrapper.admin_site = self return update_wrapper(wrapper, view) 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\d+)/(?P .+)/$', wrap(contenttype_views.shortcut), name='view_on_site'), ] 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 ' + '|'.join(valid_app_labels) + ')/$' urlpatterns += [ url(regex, wrap(self.app_index), name='app_list'), ] return urlpatterns
1、通过路由系统中的admin.site.urls可知admin路由系统调用的是site对象下的urls方法。而通过源码可知该方法返回了三个值 self.get_urls(), 'admin', self.name,而第一个值执行了个函数,该函数的最终目的的将一个列表返回,而列表内嵌套的是一个个的元组,元组内嵌套的是一个个的url路径。
2、model.类名._meta.app_label得到的是项目名称,model.类名._meta.model_name得到的是类名称
3、通过admin的路由系统最终给我们的是个列表内嵌套元组,每个元组内有x,y两个元素,x是生成的对于类的url,y是include()函数,并且向该函数内传递了
model_admin.urls
四、include()函数
如图所示,include()函数源码
def include(arg, namespace=None, app_name=None): if app_name and not namespace: raise ValueError('Must specify a namespace if specifying app_name.') if app_name: warnings.warn( 'The app_name argument to django.conf.urls.include() is deprecated. ' 'Set the app_name in the included URLconf instead.', RemovedInDjango20Warning, stacklevel=2 ) if isinstance(arg, tuple): # callable returning a namespace hint try: urlconf_module, app_name = arg except ValueError: if namespace: raise ImproperlyConfigured( 'Cannot override the namespace for a dynamic module that provides a namespace' ) warnings.warn( 'Passing a 3-tuple to django.conf.urls.include() is deprecated. ' 'Pass a 2-tuple containing the list of patterns and app_name, ' 'and provide the namespace argument to include() instead.', RemovedInDjango20Warning, stacklevel=2 ) urlconf_module, app_name, namespace = arg else: # No namespace hint - use manually provided namespace urlconf_module = arg if isinstance(urlconf_module, six.string_types): urlconf_module = import_module(urlconf_module) patterns = getattr(urlconf_module, 'urlpatterns', urlconf_module) app_name = getattr(urlconf_module, 'app_name', app_name) if namespace and not app_name: warnings.warn( 'Specifying a namespace in django.conf.urls.include() without ' 'providing an app_name is deprecated. Set the app_name attribute ' 'in the included module, or pass a 2-tuple containing the list of ' 'patterns and app_name instead.', RemovedInDjango20Warning, stacklevel=2 ) namespace = namespace or app_name # Make sure we can iterate through the patterns (without this, some # testcases will break). if isinstance(patterns, (list, tuple)): for url_pattern in patterns: # Test if the LocaleRegexURLResolver is used within the include; # this should throw an error since this is not allowed! if isinstance(url_pattern, LocaleRegexURLResolver): raise ImproperlyConfigured( 'Using i18n_patterns in an included URLconf is not allowed.') return (urlconf_module, app_name, namespace)
1、由include()函数源码可知,include函数返回的是个(urlconf_module, app_name, namespace)元组,urlconf_module的本质是个模块,通过这行代码可以看出:urlconf_module = import_module(urlconf_module),
2、urlconf_module模块的本质其实就是列表内嵌套一行行的url,由此可得知include()函数的作用其实就是路由重分发,而路由重分发得到的数据格式其实就是如下所示:
url(r'^app01/', ([ url(r'^userinfo/', ([ url(r'^index/', index,name='idx_xxx_f'), url(r'^test/', test,name='tst'), ],'x2','x2')), ],'x1','x1')),