为什么有些包含在Django中需要字符串,还有其他变量名称?

时间:2015-04-19 22:19:22

标签: python django url urlconf

参考Django Book, chapter 3

from django.conf.urls import patterns, include, url

# Uncomment the next two lines to enable the admin:
# from django.contrib import admin
# admin.autodiscover()

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'mysite.views.home', name='home'),
    # url(r'^mysite/', include('mysite.foo.urls')),
    # url(r'^admin/doc/', include('django.contrib.admindocs.urls')),
    # url(r'^admin/', include(admin.site.urls)),
)

是什么决定了为什么一个东西被包含为字符串,另一个被包含为常规变量?为什么admin.site.urls而不是'admin.site.urls'?所有其他include都包含在字符串中......我在这里看不到逻辑模式。

5 个答案:

答案 0 :(得分:7)

首先,第一个模式('mysite.views.home' - >一个视图函数)在1.8中被弃用:它导致了各种麻烦。

至于其他方面,它通常都有效。 'mysite.foo.urls'已解析为在模块mysite.foo.urls中包含模式,但from mysite.foo import urls as foo_urls; include(foo_urls)也有效。基于字符串的导入主要是一个尚未被删除的历史工件,但它很方便,并且没有任何真正的缺点,因为模块被立即导入(因此,任何ImportError都是容易追溯到url配置)。

admin.site.urls不同,因为admin.site.urls 不是模块,但site是对象而urls是属性。因此,admin.site.urls的基于字符串的导入不起作用,您必须使用第二种方法。

作为最后一点,Django Book开头的警告声称它已经过时了。更新的资源,例如官方文件(我所知道的最好的官方文件之一),将是更可取的。

答案 1 :(得分:4)

如果您传递给include()一个url()实例列表,那么您不使用字符串(请参阅Include() docsIncluding other URLconfs docs)。在您的管理网址示例中,admin.site.urls引用了网址实例列表。请参阅source code中的get_urls方法(提供admin.site.urls引用的网址实例列表)。

def get_urls(self):
    ...
    # Admin-site-wide views.
    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'),
    ]

答案 2 :(得分:3)

你是对的,这有点令人困惑。他们在Django 1.8中改变了这一点,所以现在他们只支持包括正常变量。

Django 1.8 release note了解详情。

答案 3 :(得分:3)

您必须将带有字符串的路径放入函数include()中。但是admin.site.urls就像一个字符串,因为在代码开头,你有一个导入

答案 4 :(得分:3)

从Django 1.8文档中,include()可以将模块作为参数 OR 模块名称

https://docs.djangoproject.com/en/1.8/ref/urls/#include

该行

from django.contrib import admin

导入管理模块。因此,它可以直接用作include的参数。另一个include()方法具有命名其他URLconf的字符串参数。