一、urls硬编码
在反向解析和命名空间之前我们先来说说URLS硬编码,用django 开发应用的时候,可以完全是在urls.py 中硬编码配置地址,在views.py中HttpResponseRedirect()也是硬编码转向地址,当然在template 中也是一样了,这样带来一个问题,如果在urls.py 中修改了某个页面的地址(也就是说更改路由系统中对应的路由分发),那么所有的地方(views.py和template中)都要修改。问题出在硬编码,紧耦合使得在大量的模板中修改 URLs 成为富有挑战性的项目。来看下面的模板文件index.html中,我们到的链接硬编码成这样子:
<li><a href="/goods/index/">url硬编码</a></li>
如果使用软编码之后,无论怎么更改路由系统中的路由分发,只有对应的namespace与name属性值不变,就不必修改在views.py和template中的url,也就是说
<li><a href="{% url "good:index" %}">url软编码</a></li>
在templates中更改为软编码之后,其实在templates,index.html文件生成的时候,仍然是
<li><a href="/goods/index/">url软编码</a></li>
二、URL的反向解析
在使用Django 项目时,一个常见的需求是获得URL 的最终形式,以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)。
人们强烈希望不要硬编码这些URL(费力、不可扩展且容易产生错误)或者设计一种与URLconf 毫不相关的专门的URL 生成机制,因为这样容易导致一定程度上产生过期的URL。
获取一个URL 最开始想到的信息是处理它视图的标识(例如名字),查找正确的URL 的其它必要的信息有视图参数的类型(位置参数、关键字参数)和值。
Django 提供一个办法是让URL 映射是URL 设计唯一的地方。你填充你的URLconf,然后可以双向使用它:
1、根据用户/浏览器发起的URL 请求,它调用正确的Django 视图,并从URL 中提取它的参数需要的值。
2、根据Django 视图的标识和将要传递给它的参数的值,获取与之关联的URL。
第一种方式是我们常说的根据地址定位URL。
第二种方式叫做反向解析URL、反向URL 匹配、反向URL 查询或者简单的URL 反查。
在需要URL 的地方,对于不同层级,Django 提供不同的工具用于URL 反查:
1、在模板中:使用url 模板标签。
2、在Python 代码中:使用 django.core.urlresolvers.reverse() 函数。
3、在更高层的与处理Django 模型实例相关的代码中:使用 get_absolute_url() 方法。
1、命名空间:
URL 命名空间允许你反查到唯一的命名URL 模式,即使不同的应用使用相同的URL 名称。第三方应用始终使用带命名空间的URL 是一个很好的实践。类似地,它还允许你在一个应用有多个实例部署的情况下反查URL。换句话讲,因为一个应用的多个实例共享相同的命名URL,命名空间将提供一种区分这些命名URL 的方法。
一个URL 命名空间有两个部分,它们都是字符串:
<1>、应用命名空间:
它表示正在部署的应用的名称。一个应用的每个实例具有相同的应用命名空间。例如,可以预见Django 的管理站点的应用命名空间是' admin '。
<2>、实例命名空间:
它表示应用的一个特定的实例。实例的命名空间在你的全部项目中应该是唯一的。但是,一个实例的命名空间可以和应用的命名空间相同。它用于表示一个应用的默认实例。例如,Django 管理站点实例具有一个默认的实例命名空间'admin'。 URL的命名空间使用':' 操作符指定。例如,管理站点应用的主页使用' admin:index '。它表示' admin ' 的一个命名空间和' index ' 的一个命名URL.
# include函数的API include(arg, namespace=None, app_name=None) # namespace设置实例命名空间,app_name设置应用命名空间 # 不能只设置app_name,否则会报错,以下是报错的源码 if app_name and not namespace: raise ValueError('Must specify a namespace if specifying app_name.')
一般来说,同一应用下的不同实例应该具有相同的应用命名空间,但是,这并不意味着不同应用可以使用相同的实例命名空间,因为实例命名空间在你所有项目中都是唯一的。
问题: 另外在添加命名空间 namespace时可能会出现以下这个问题:
'Specifying a namespace in include() without providing an app_name ' django.core.exceptions.ImproperlyConfigured: Specifying a namespace in include() without providing an app_name is not supported. Set the app_name attribute in the included module, or pass a 2-tuple containing the list of patterns and app_name instead.
解决方案为:
在对应的app应用的urls.py中添加app_name = '[应用名称]'如下
from django.conf.urls import url from . import views app_name = 'users' # users为当前应用的名称 urlpatterns = [ url('^$', views.index), url('^(d+)/$', views.detail), ]
三、url反向解析实例
在我们的django项目中通常App,目录结构就可以如下daily_fresh_demo
daily_fresh_demo
|----daily_fresh_demo |----__init__.py |----settings.py |----urls.py |----wsgi.py |----df_cart #对商品购物车管理 |---- migrations # 迁移文件目录 |---- admin.py |---- apps.py |---- models.py |---- test.py |---- urls.py |---- views.py |---- __init__.py |----df_goods #商品以及后台管理 ... |----df_user #用户管理 ... |----df_order #订单管理 ...
|----templates
|index.html
1、路由分发:
daily_fresh_demo/daily_fresh_demo/urls.py
from django.contrib import admin from django.urls import path from django.conf.urls import url, include urlpatterns = [ path('admin/', admin.site.urls), url(r'^goods/', include('df_goods.urls', namespace='df_goods')), # 添加实例命名空间 url(r'^user/', include('df_user.urls', namespace='df_user')), url(r'^cart/', include('df_cart.urls', namespace='df_cart')), url(r'^order/', include('df_order.urls', namespace='df_order')), ]
根据路由分发到各个相应的app中。并添加实例命名空间
2、子路由
daily_fresh_demo/df_goods/urls.py
from django.conf.urls import url from . import views app_name = 'df_goods' # 应用命名空间 urlpatterns = [ url('^index/$', views.index, name="index"), ]
df_goods中的路由,添加应用命名空间。并在url函数中添加name属性。
3、视图函数
daily_fresh_demo/df_goods/views.py from django.shortcuts import render, reverse def index(request): print(reverse("df_goods:index")) # 利用reverse函数反向解析url
# 打印结果为/goods/index/
return render(request, 'index.html')
4、静态文件 index.html
daily_fresh_demo/templates/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>index</title>
</head>
<body>
<a href="/goods/index">硬链接</a>
<a href="{% url "df_goods:index" %}">软链接</a>
</body>
</html>
5、结果
静态文件中index.html的url解析结果如下
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>index</title> </head> <body> <a href="/goods/index">硬链接</a> <a href="/goods/index/">软链接</a> # 软编码通过解析后得到的结果与硬编码一致 </body> </html>
总结:这样一来通过命名空间,无论在templates文件中有多庞大的url地址映射,只要使用url软编码,在更改路由系统的时候,都能自动生成。而如果使用硬链接硬编码 ,就只能在views.py和静态文件中逐个修改url地址,不仅耗费时间,更容易产生错误。