Django之路由系统

路由系统

简而言之，django的路由系统作用就是使views里面处理数据的函数与请求的url建立映射关系。使请求到来之后，根据urls.py里的关系条目，去查找到与请求对应的处理方法，从而返回给客户端http页面数据

Django2.0中，url得匹配规则更新了，在django1.0中，url是用正则表达式书写得，相对来说比较繁琐一些，在django2.0中进行了升级优化，描写url配置的有两个函数path和re_path

django 项目中的url规则定义放在project 的urls.py目录下，
默认如下：

from django.conf.urls import path
from django.contrib import admin

urlpatterns = [
    path('admin/', admin.site.urls)
]

path()

函数 path() 具有四个参数，两个必须参数：route 和 view，两个可选参数：kwargs 和 name。即路由和视图是必填参数。

那么与旧版本的参数主要区别就在于url()是要写正则表达式（regex）的路由，而path()是写的非正则路由（route），接下来主要看一下path()函数的四个参数含义。

1、path()参数：route
    route 是一个匹配URL的准则（类似正则表达式）。当Django响应一个请求时，它会从urlpatterns的第一项开始，按顺序依次匹配列表中的项，直到找到匹配的项。
    这些准则不会匹配GET和POST参数或域名。例如，URLconf在处理请求https://www.example.com/myapp/时，它会尝试匹配myapp/。处理请求https://www.example.com/myapp/?page=3 时，也只会尝试匹配 myapp/。
2、path()参数：view
    当 Django 找到了一个匹配的准则，就会调用这个特定的视图函数，并传入一个HttpRequest对象作为第一个参数，被“捕获”的参数以关键字参数的形式传入。
3、path()参数：kwargs
    任意个关键字参数可以作为一个字典传递给目标视图函数。
4、path()参数：name
    为你的URL取名能使你在 Django 的任意地方唯一地引用它，尤其是在模板中。这个有用的特性允许你只改一个文件就能全局地修改某个URL模式。

上面介绍的path中，第一个参数route使用的是非正则表达式可以表示的普通路由路径。

注意：

要从URL捕获值，请使用尖括号。
捕获的值可以选择包括转换器类型。例如，用于 <int:name>捕获整数参数。如果未包含转换器/，则匹配除字符之外的任何字符串。
没有必要添加前导斜杠，因为每个URL都有。例如，它articles不是/articles。

默认情况下，以下路径转换器可用：

str- 匹配除路径分隔符之外的任何非空字符串'/'。如果转换器未包含在表达式中，则这是默认值。
int - 匹配零或任何正整数。返回一个int。
slug - 匹配由ASCII字母或数字组成的任何slug字符串，以及连字符和下划线字符。例如， building-your-1st-django-site。
uuid - 匹配格式化的UUID。要防止多个URL映射到同一页面，必须包含短划线并且字母必须为小写。例如，075194d3-6885-417e-a8a8-6c931e272f00。返回一个 UUID实例。
path- 匹配任何非空字符串，包括路径分隔符 '/'。这使您可以匹配完整的URL路径，而不仅仅是URL路径的一部分str。

比如要匹配一个视图中的函数路由，该函数有两个形参：

def peopleList(request,book_id)

第一个request是默认的，那么路径自动匹配该函数的第二个形参，匹配格式：int:book_id，并返回一个正整数或零值。

re_path()

而如果遇上路径和转换器语法都不足以定义的URL模式，那么就需要使用正则表达式，这时候就需要使用re_path()，而非path()。

1	from django.urls import re_path

在Python正则表达式中，命名正则表达式组的语法是(?P<name>pattern)，组name的名称，并且 pattern是要匹配的模式。

还是以上图圈中的部分为例，也是可以用正则表达式来写的。如下：

1	re_path(r'^(\d+)/$',views.peopleList,name='peopleList'),

这样也是可以匹配到views视图中的peopleList函数的形参的。

所以这两种使用方式在使用上根据实际情况自行使用。

按照顺序放置的动态路由

可以使用正则来匹配URL，将一组url使用一条映射搞定

urlpatterns = [
     re_path(r'^host/(\d+)$', views.host),
     re_path(r'^host_list/(\d+)/(\d+)$', views.host_list), 
]

\^host_list/(\d+)/(\d+)$

相对应的url是： ”http://127.0.0.1/host/8/9“，匹配到的数字会以参数的形式按照顺序传递给views里面相对应的函数
在views.host_list中需要指定两个形式参数,注意：此参数的顺序严格按照url中匹配的顺序

1 2	def user_list(request,hid,hid2): return HttpResponse(hid+hid2)

传参形势的路由

利用正则表达式的分组方法，以参数的形式传递到函数，可以不按顺序排列

1
2
3

urlpatterns = [ 
     re_path(r'^user_list/(?P<v1>\d+)/(?P<v2>\d+)$',views.user_list), 
 ]

然后将此参数传递到views里对应的函数，可以不按照顺序

def user_list(request,v2,v1):
 
     return HttpResponse(v1+v2)
参数v1 = (?P<v1>\d+)
参数v2 = (?P<v2>\d+)

路由分发

如果一个项目下有很多的app，那么在urls.py里面就要写巨多的urls映射关系。这样看起来很不灵活，而且杂乱无章。
我们可以根据不同的app来分类不同的url请求。
首先，在urls.py里写入urls映射条目。注意要导入include方法

from django.conf.urls import include, url
from django.contrib import admin

urlpatterns = [

    path('app01/', include('app01.urls')),
    path('app02/', include('app02.urls')),

]

这条关系的意思是将url为”app01/“的请求都交给app01下的urls去处理

其次，在app01下创建一个urls.py文件，用来处理请求的url，使之与views建立映射

from django.conf.urls import include, url
from app01 import views

urlpatterns = [

    path('index/', views.index),

]

想对于url请求为： “http://127.0.0.1/app01/index/“

命名空间

a. project.urls.py

from django.conf.urls import url,include
 
urlpatterns = [
    url(r'^a/', include('app01.urls', namespace='author-polls')),
    url(r'^b/', include('app01.urls', namespace='publisher-polls')),
]

b. 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')
]

c. app01.views.py

1
2
3

def detail(request, pk):
    print(request.resolver_match)
    return HttpResponse(pk)

以上定义带命名空间的url之后，使用name生成URL时候，应该如下：

1 2	v = reverse('app01:detail', kwargs={'pk':11}) {% url 'app01:detail' pk=12 pp=99 %}

django中的路由系统和其他语言的框架有所不同，在django中每一个请求的url都要有一条路由映射，这样才能将请求交给对一个的view中的函数去处理。其他大部分的Web框架则是对一类的url请求做一条路由映射，从而是路由系统变得简洁。