Django路由

路由"/>

Django路由

路由系统

• • 1.Django1中的路由
  • • 1.1 普通形式
    • 1.2 分组
    • • 1.2.1 无名分组
      • 1.2.2 有名分组
  • 2. Django2+版本
  • • 2.1 传统的路由
    • 2.2 正则表达式路由
  • 3. 路由分发
  • • 3.1 include(一般使用此方式做路由分发)
    • 3.2 手动分发
  • 4. name别名及使用name的反向URL生成
  • • 4.1 一般情况下的别名使用及反向生成
    • 4.2 分组中方向解析URL
  • 5. 名称空间

1.Django1中的路由

1.1 普通形式

在Django1的版本中，普通路由url进行匹配，其格式如下：

urlpatterns = [url(regex, view, kwargs=None, name=None),
]

1. url的regex参数，即第一个参数为正则表达式
2. view参数通常为视图函数，用来处理业务逻辑
3. kwargs:接收传递给视图函数的参数
4. name：为regex参数地址的别名，在地址过长时可用别名反向解析

示例：

urlpatterns = [url(r'^admin/', admin.site.urls),url(r'^index$',views.index)
]

PS:需要注意

1. 正则表达式不需要添加一个前导的反斜杠，因为每个URL都有。例如，应该是^index而不是 ^/index
2. 每个正则表达式前面的’r’ 是可选的但是建议加上
3. 如果我们想匹配的路径就只是index/,那么正则表达式应该有开始符与结束符, 如 ^index/$。这样逻辑才算严谨
4. 若正则为r'index/'在浏览器输入：http://127.0.0.1:8001/index/，Django会拿着路径部分index/去路由表中自上而下匹配正则表达式，一旦匹配成功，则立即执行其后的视图函数，不会继续往下匹配，此处匹配成功的正则表达式是 r'^index/$'。
5. 无论是否书写最后的/，都可以匹配成功，是因为配置中APPEND_SLASH默认为True且并不会出现在配置文件中，若想精确匹配最后的/则应该去settings文件中将APPEND_SLASH设置为False。

1.2 分组

分组实际上可以理解为get请求的第二种方式：

1. get请求的第一种方式：
   http://127.0.0.1:8000/test/?a=1&b=2
2. get请求的第二种方式：
   http://127.0.0.1:8000/test/123/11

1.2.1 无名分组

无名分组实际上是re的分组写法，即把正则中小括号里的匹配到的内容以位置参数的形式传递给视图函数，如下：

urls.py文件
from django.contrib import admin
from django.conf.urls import url
from app01 import viewsurlpatterns = [# 下述正则表达式会匹配url地址的路径部分为:article/数字/，匹配成功的分组部分会以位置参数的形式传给视图函数，有几个分组就传几个位置参数url(r'^article/(\d+)/$',views.article), 
]
views.py文件
from django.shortcuts import render
from django.shortcuts import HttpResponse# 需要额外增加一个形参用于接收传递过来的分组数据
def article(request,article_id):return HttpResponse('id为 %s 的文章内容...' %article_id)
测试：
python manage.py runserver 8001 # 在浏览器输入：http://127.0.0.1:8001/article/3/ 会看到: id为 3 的文章内容...

1.2.2 有名分组

当我们对分组命名后，就会按照key=value的关键字参数形式为视图函数传参，示例如下：
urls.py

from django.contrib import admin
from django.conf.urls import url
from app01 import viewsurlpatterns = [url('admin/', admin.site.urls),# 该正则会匹配url地址的路径部分为:article/数字/，匹配成功的分组部分会以关键字参数（article_id=匹配成功的数字）的形式传给视图函数，有几个有名分组就会传几个关键字参数，需要强调一点是：视图函数得到的值均为字符串类型url(r'^article/(?P<article_id>\d+)/$',views.article), 
]

views.py

from django.shortcuts import render
from django.shortcuts import HttpResponse# 需要额外增加一个形参，形参名必须为article_id
def article(request,article_id):return HttpResponse('id为 %s 的文章内容...' %article_id)

测试：

python manage.py runserver 8001 # 在浏览器输入：http://127.0.0.1:8001/article/3/ 会看到: id为 3 的文章内容...

普通分组和命名分组都是为了获取路径中的参数，并传递给视图函数，区别在于普通分组是以位置参数的形式传递，命名分组是以关键字参数的形式传递。但请注意，有名分组和无名分组不要同时使用。

2. Django2+版本

2.1 传统的路由

在Django2以上的版本中，默认的路由通过path精准匹配来识别，避免了正则可能出现的一些匹配的问题。

格式如下：

urlpatterns = [path('admin/', admin.site.urls),path('',views.show_user_info),path('show/', views.show_user_info),path('del/', views.del_user_info),path('update/', views.update_user_info),path('insert/', views.insert_user_info)
]

其用法同url并无太大区别，path的第一个参数是精确匹配。

2.2 正则表达式路由

burpatterns = [re_path(r'users/(?<xxid>\w+-\d+)/',views.users),
]

Django2+版本的re_path的用法同Django1的url完全相同，不做过多描述。

3. 路由分发

当功能较多时，都写在一个urls文件中显然并不合适，可以使用路由分发将功能拆分带不同的app中。

3.1 include(一般使用此方式做路由分发)

include('app命字.url模块名')

1. 模块app命字/url模块名.py 文件件里必须有urlpatterns 列表
2. 使用前需要使用 from django.conf.urls import include 导入此函数

示例：
djangoproject1/urls.py

from django.urls import path,include
urlpatterns = {path('api/', include('apps.api.urls')),path('web/', include('apps.api.urls'))
}

apps/api/urls.py

from django.urls import path
from apps.api import viewsurlpatterns = {# api/auth/path('auth/',views.auth),# api/login/path('login/',views.login)
}

3.2 手动分发

path('user/', ([path('add/', views.login),path('delete/', views.login),   # /user/delete/path('edit/', views.login),path('list/', views.login),], None, None)),

纯粹帮助提取功能的URL，防止重复编写。

4. name别名及使用name的反向URL生成

4.1 一般情况下的别名使用及反向生成

别名的使用

from django.urls import path
from app01 import views
urlpatterns = [path('login/', views.login, name="v1"),path('auth/', views.auth, name="v2"),
]

视图函数中反向生成URL

from django.urls import reverse
url = reverse("v2")   # /auth/
url = reverse("v1")   # /login/

HTML模版中反向生成

<a href="{% url 'v1' %}">添加</a>
<a href="{% url 'v2' %}">添加</a>

4.2 分组中方向解析URL

无名分组反向解析
url(r'^v1/v2/v3/home/(\d+)/(\d+)/$', views.home, name='home')
# 后端解析
res=reverse('home', args=(123, 11)) # /v1/v2/v3/home/1
print(res)# 前端解析
<a href="{% url 'home' 1 123 %}">点我看美女</a>

有名分组反向解析
url(r'^v1/v2/v3/home/(?P<year>\d+)/(?P<mon>\d+)/$', views.home, name='home')
# 后端解析
res=reverse('home', args=(123, 11)) # /v1/v2/v3/home/1
res=reverse('home', kwargs={'year':123, 'mon':1}) # /v1/v2/v3/home/1
print(res)# 前端解析
<a href="{% url 'home' year=1 mon=123 %}">点我看美女</a>

5. 名称空间

避免name重复可将重名name分别放入不同的namespace

• 主路由

  	from django.urls import path, re_path, include# 很多功能，很多URL
  urlpatterns = [path('api/', include("apps.api.urls",namespace='x1')),path('web/', include("apps.web.urls",namespace='x2')),	
  ]
  

• api/urls.py

  from django.urls import path, re_path
  from . import views
  # 很多功能，很多URL
  urlpatterns = [path('login/', views.login,name="login"),path('auth/', views.auth, name='auth'),
  ]
  

• web/urls.py

  from django.urls import path, re_path
  from . import views
  # 很多功能，很多URL
  urlpatterns = [path('home/', views.home,name='home'),path('order/', views.order,name='order'),path('auth/', views.order, name='auth'),
  ]
  

反向生成

from django.urls import reverse
url = reverse("x1:login")    # /api/login/
url = reverse("x1:order")    # /web/login/url = reverse("x1:auth")    # /api/login/
url = reverse("x2:auth")    # /web/login/