Django路由系统
URL配置(URLconf)就像Django所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表。
我们就是以这种方式告诉Django，遇到哪个URL的时候，要对应执行哪个函数。
URLconf配置 :
from django.conf.urls import url urlpatterns = [ url (正则表达式, view视图, 参数, 别名), ]
示例 :
from django.conf.urls import url from app import views urlpatterns = [ url(r'^articles/2003/$', views.special_case_2003), url(r'^articles/([0-9]{4})/$', views.year_archive), url(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive), url(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail), ] _______________________________________________________________ django 2.0版本的路由系统是下面的写法 : from django.urls import path，re_path urlpatterns = [ path('articles/2003/', views.special_case_2003), path('articles/<int:year>/', views.year_archive), path('articles/<int:year>/<int:month>/', views.month_archive), path('articles/<int:year>/<int:month>/<slug:slug>/', views.article_detail), ]
参数说明 :
正则表达式 : 一个正则表达式字符串
view视图 : 一个可以调用对象, 通常为一个视图函数
参数 : 可选的要传递给视图函数的默认参数(字典形式)
别名 : 一个可选的name参数
正则表达式详解 :
注意事项 :
urlpatterns中的元素按照书写顺序从上到下逐一匹配正则表达式, 一旦匹配成功则不再继续
若要从URL中捕获一个值, 只需要将它用一对圆括号包围起来就好(分组匹配)
不需要添加一个前导的反斜杠, 因为每个URL默认都会有.
每个正则表达式前面的"r"是可选的但是建议写上.
补充 :
# 是否开启URL访问地址后面不为/跳转至带有/的路径的配置项 # 将True改为False之后不再自动跳转 APPEND_SLASH=True #Django settings.py配置文件中默认没有 APPEND_SLASH 这个参数，但 Django 默认这个参数为 APPEND_SLASH = True。 其作用就是自动在网址结尾加'/'
分组命名匹配 :
上面示例中使用简单的正则表达式分组匹配(通过圆括号)来捕获URL中的值并以位置参数形式传递给视图. 在更高级的用法中, 可以使用分组命名匹配的正则表达式组来捕获URL的值并以关键字参数形式传递给视图. 在python的正则表达式中,分组命名正则表达式组的语法是(?P<name>pattern)
,其中name是组的名字, pattern是要匹配的模式.
from django.conf.urls import url from app import views urlpatterns = [ url(r'^articles/2003/$', views.special_case_2003), url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive), url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive), url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail), ]
这样实现传参的方式和上面的示例基本相同, 只有一个细微的差别: 捕获的值是关键字参数而不是位置参数传递给视图函数.
在实际应用中, 使用分组命名匹配的方式可以让你的URLconf更加清晰且不容易产生参数顺序问题的错误.
URLconf匹配的位置 :
URLconf在请求的URL上查找, 将它当做一个普通的Python字符串. 不包括GET和POST的参数以及域名. URLconf 不检查请求的方法。换句话讲，所有的请求方法 —— 同一个URL的POST、GET、HEAD等等 —— 都将路由到相同的函数。
例如:
http://www.baidu.com/myapp/ 请求中, URLconf将查找/myapp/
http://www.baidu.com/myapp/?id=1 请求中, URLconf将查找/myapp/
捕获的参数永远为字符串 :
每个在URLconf中捕获的参数都作为一个普通的Python字符串传递给视图, 无论正则表达式是用什么匹配方式. 传递到视图函数的参数都是一个字符串类型.
视图函数中的指定默认值 :
# urls.py中 from django.conf.urls import url from . import views urlpatterns = [ url(r'^blog/$', views.page), url(r'^blog/page(?P<num>[0-9]+)/$', views.page), ] # views.py中，可以为num指定默认值 def page(request, num="1"): pass
在上面的例子中，两个URL模式指向相同的view - views.page - 但是第一个模式并没有从URL中捕获任何东西。如果第一个模式匹配上了，page()函数将使用其默认参数num=“1”,如果第二个模式匹配，page()将使用正则表达式捕获到的num值。
include其他的URLconfs : (路由分发)
from django.conf.urls import include, url urlpatterns = [ url(r'^admin/', admin.site.urls), url(r'^blog/', include('blog.urls')), # 可以包含其他的URLconfs文件 ]
传递额外的参数给视图函数 :
URLconf可以传递一个Python字典作为额外的参数传递给视图函数.
django.conf.urls.url()可接收一个可选的第三个参数, 它是一个字典, 表示想要传递给视图函数的额外关键字参数.
from django.conf.urls import url from . import views urlpatterns = [ url(r'^blog/(?P<year>[0-9]{4})/$', views.year_archive, {'foo': 'bar'}), ]
在这个例子中，对于/blog/2005/请求，Django 将调用views.year_archive(request, year='2005', foo='bar')。
当传递额外参数的字典中的参数和URL中捕获值的命名关键字参数同名时，函数调用时将使用的是字典中的参数，而不是URL中捕获的参数。
命名URL和URL反向解析 :
在使用django项目时, 一个常见的需求是获得URL的最终形式, 以用于嵌入到生成的内容中,
简单来说就是给URL匹配规则起一个名字, 一个URL匹配模式起一个名字.
这样就可以不用写死代码, 只需要通过名字来调用当前的URL.
举个栗子 :
###########url中的映射代码############## url(r'^home', views.home, name='home'), # 给我的url匹配模式起名为 home url(r'^index/(\d*)', views.index, name='index'), # 给我的url匹配模式起名为index
#################模板中的使用代码############## {% url 'home' %}
###############在view函数中使用的代码############### from django.urls import reverse reverse("index", args=("2018", )) #部分代码 ###############args是重定向时, 需要给url中的正则表达式传的参数
命名空间模式 :
即使不同的app使用相同的URL名称, URL的命名空间模式也可以让你唯一反转命名的URL.
举个栗子 :
############project中的urls.py############### from django.conf.urls import url, include urlpatterns = [ url(r'^app01/', include('app01.urls', namespace='app01')), url(r'^app02/', include('app02.urls', namespace='app02')), ]
#################app01中的urls.py################# from django.conf.urls import url from app01 import views app_name = 'app01' urlpatterns = [ url(r'^(?P<pk>\d+)/$', views.detail, name='detail') ]
###################app02中的urls.py################## from django.conf.urls import url from app02 import views app_name = 'app02' urlpatterns = [ url(r'^(?P<pk>\d+)/$', views.detail, name='detail') ]
