Django的路由系统
URL配置(URLconf)就像Django所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表。
我们就是以这种方式告诉Django,遇到哪个URL的时候,要对应执行哪个函数。
一、URLconf配置
基本格式:
from django.conf.urls import url
urlpatterns = [
url(正则表达式,views视图,参数,别名),
]
参数说明:
正则表达式:一个正则表达式字符串
view视图:一个可调用对象,通常为一个视图函数
参数:可选的要传递给视图函数的默认参数【字典新式】
别名:一个可选的name参数,当动态改路劲时需用到
示例:
from django.conf.urls import url
from . 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),
]
请求的例子:
/articles/2005/3/ 不匹配任何url模式,因为列表中的第三个模式要求月份应该是两个数字。
/articles/2005/ 将匹配列表中的第一个模式不是第二个,因为模式按顺序匹配,第一个会首先测试是否匹配。
/articles/2005/03/ 请求将匹配列表中的第三个模式,django将调用函数views.month_archive(request,'2005','03')
注意:
Django2.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), ]
注:2.0版本中re_path和1.11版本的url用法一样。
正则表达式详解:
1、urlPartterns中元素按照书写顺序从上往下逐一匹配正则表达式,一旦匹配成功则不再继续,谁在上面,就先匹配,会覆盖下面的。
2、若要从url中捕获一个值【即可以从url中获取参数】,只需要在它周围放置一对圆括号(分组匹配)。
3、不需要添加一个前导的反斜杠,因为每个url都有,例如,应该是^active/而不是^/active/。
4、每个正则表达式前面的r‘’是可选的但建议加上,以防特殊字符未转义。
补充说明
# 是否开启URL访问地址后面不为/跳转至带有/的路径的配置项 APPEND_SLASH=True
Django settings.py配置文件中默认没有 APPEND_SLASH 这个参数,但 Django 默认这个参数为 APPEND_SLASH = True。 其作用就是自动在网址结尾加'/'。
其效果就是:
我们定义了urls.py:
from django.conf.urls import url from app01 import views urlpatterns = [ url(r'^blog/$', views.blog), ]
访问 http://www.example.com/blog 时,默认将网址自动转换为 http://www.example/com/blog/ 。
如果在settings.py中设置了 APPEND_SLASH=False,此时我们再请求 http://www.example.com/blog 时就会提示找不到页面。
二、无名分组和命名分组
无名分组:就是正则匹配分组,圆括号包起来的部分,未指定别名,匹配完全后,将url中的匹配的括号包起来的值,以位置参数传递给视图函数。
url(r'^articles/([0-9]{4})/$', views.year_archive), # 上面([0-9]{4})就是无名分组,匹配4位数字,当前端url中如输入 http://127.0.0.1:8000/2016/ 时,2016就是匹配的值,django将会将2016以位置参数传给后面的视图函数 def year_archive(request,2016):pass 以用于业务逻辑
命名分组:就是给分组指定一个别名,python的正则分组命名语法为(?P<name>pattern),其中name是组的命名,pattern是匹配的模式,将url中匹配的部分以,关键字参数传递给视图函数。
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive), # 如浏览器中输入:http:// 127.0.0.1:8000/articles/2016/,
django 会将匹配的2016以关键字分方法传递给视图函数供其调用, def year_archive(request, year = ’2016‘):pass
小结:
1、urlconf匹配时,将url当成一个普通的字符串,不考虑请求方法,ip或域名,仅匹配http://www.baidu.com/index/?wd=python 着色部分。
2、捕获的参数永远都是字符串 ,如上面传递给视图函数 views.year_archive()中的year的参数永远是一个字符串,而不是一个数字类型。
3、视图函数中可以指定默认值
# 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值。
4、urlconf可以传递额外的参数给视图函数
URLconfs 具有一个钩子,让你传递一个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分发,各app管理自己的url
例如:app01、app02
1、分别在app01和app02下创建自己的urls.py【各应用下与views.py同级目录中创建】
2、分别配置app的urls.py
app01 from django.conf.urls import url # 导入管理url的模块 from app01 import views # 导入应用的的views urlpatterns = [ url(r'^home/[0-9]{4}/[0-9]{2}/$' ,views.app01_home)] app02 类似
3、在全局urls.py文件中导入app01及app02的urls
1、from django.conf.urls import include 2、在urlpatterns中写入 url(r'^app01/' ,include('app01.urls')), url(r'^app02/', include('app02.urls'))
注:此时相当于app01是一级目录,而app自己的url相当于二级目录,当访问时先到全局urls后到应用的urls
相当于进行字符串拼接
如:http://www.baidu.com/app01/home 会先找到app01,再去对应app下的urls中找home的url
四、命名Url和Url反向解析
官方:Django 提供一个办法是让URL 映射是URL 设计唯一的地方。你填充你的URLconf,然后可以双向使用它:
- 根据用户/浏览器发起的URL 请求,它调用正确的Django 视图,并从URL 中提取它的参数需要的值。
- 根据Django 视图的标识和将要传递给它的参数的值,获取与之关联的URL。
第一种方式就是,正向的,我们在浏览器种输入地址,服务器到urls去匹配,然后执行对应的视图函数。
第二种方式就是,反向解析url,反向url匹配,反向url查询或简单的url反查,如我们业务处理中redirect跳转等。
本质:为urls.py中的url匹配规则设置别名
作用:解决当需要更新页面或视图函数中的url时,无需再一个个去遍历修改,只需要再urlsconf中即urls.py中修改,视图和模板就会自动更新url
常规
url(r'show_class/', views.show_class, name='class_list'),
无名分组
url(r'^home/([0-9]{4})/([0-9]{2})/$',views.login ,name='home')
有名分组
url(r'^home/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$',views.login ,name='home')
在views中使用
from django.shortcuts import reverse # 导入反向解析模块
常规
def test(request): return redirect(reverse('class_list'))
无名分组
return redirect(reverse('home' , args=('1988','09'))) 上面会字符串拼接成:home/1988/09/
命名分组
return redirect(reverse("home", kwargs={"year":2018}))
在模板html中使用
语法:{% url 路径设置的别名 %}
常规
{% url 'class_list' %}
无名分组
{% url 'home' '2018' '09' %}
有名分组
{% url 'home' '2018' '09' %} {% url 'home' month='09' year='2018' %}
命名空间模式
当多个app的url设置的别名相同时,容易出现异常报错,在全局urls里后面的覆盖前面的,故有下面两个方案解决
1、在url命名前加上应用的名字 如 name = 'app_name.路径别名'
2、在全局urls.py中导入app01时,为url也进行命名 namespace='别名,一般为应用的名字'
from django.conf.urls import url, include
url( r'app01/ ',include('app01.urls', namespace= 'app01'))
3、在app的views.py视图函数使用
from django.shorcuts import reverse
def test(request) return redirect(reverse('app01:home', ))
4、在模板中使用
{% url 'app01:home' %}
注:如果app在全局的url指定了namesapce,那么单个app的应用url就必须也指定name,不然无法使用!!!