路由系统
通过URL(Uniform Resource Locator,统一资源定位符)可以访问互联网上的资源——用户通过
浏览器向指定URL发起请求,Web服务器接收请求并返回用户请求的资源,因此可以将URL视为用户与服务器之间交互的桥梁。
在Django当中,路由系统的本质就是URL与要调用URL的视图函数的一个映射表,它的主要作用就
是让views里面的执行函数与请求的url建立映射关系,当请求来了的时候根据这个url映射来调用对应的
执行函数,从而返回给客户端相应的信息
Django处理请求的流程
当用户向你的Django站点请求一个页面时,系统会采用一个算法来确定要执行哪一段Python代码:
-
首先,Django会使用根路由解析模块(root URLconf)来解析路由。
-
Django加载该Python模块并查找变量 urlpatterns 。 它应该是 django.urls.path() 或者django.urls.re_path() 实例的Python列表。
-
Django按顺序遍历每个URL pattern,并在第一个匹配的请求URL被匹配时停下。
-
一旦某个URL pattern成功匹配,Django会导入并调用给定的视图,该视图是一个简单的Python
函数(或基于类的视图)。
这个视图会被传以以下参数:
一个 HttpRequest 的实例。
如果所匹配的正则表达式返回的是若干个无名组,那么该正则表达式所匹配的内容将被作为
位置参数提供给该视图。
关键字参数是由路径表达式匹配的任何指定部件组成的,在可选的 kwargs 参数中指定的任
何参数覆盖到 django.urls.path() 或 django.urls.re_path() 。
5.如果请求的URL没有匹配到任何一个表达式,或者在匹配过程的任何时刻抛出了一个异常,那么
Django 将调用适当的错误处理视图进行处理
URL配置
一个项目允许有多个urls.py,但Django需要一个urls.py作为入口,这个特殊的urls.py就是根
URLconf(根路由配置),它由settings.py文件中的ROOT_URLCONF指定
这条代码实在setting.py文件中
ROOT_URLCONF = 'mysite.urls'
以上示例通过ROOT_URLCONF指定了mysite目录下的urls.py作为根URLconf
为保证项目结构清晰,开发人员通常在Django项目的每个应用下创建urls.py文件,在其中为每个应用
配置子URL。路由系统接收到HTTP请求后,先根据请求的URL地址匹配根URLconf,找到匹配的子应用,再进一步匹配子URLconf,直到匹配完成
路由测试
1.创建新的项目
2.现将urls.py文件
3.views.py文件编写一个子应用
from django.shortcuts import render
from django.http import HttpResponse
# Create your views here.
def index(request):
return HttpResponse('路由测试')
4.在子应用中的urls.py文件中创建子路由
from django.contrib import admin
from django.urls import path
from urlAPPS.views import index
urlpatterns = [
path('index/', index),
]
5.在总项目的路由中添加上子路由
from django.contrib import admin
from django.urls import path,include
urlpatterns = [
path('admin/', admin.site.urls),
path('urlAPPS/',include('urlAPPS.urls')),
]
6.在views.py文件中添加新的子应用
def special_case_2022(request):
return HttpResponse('路由测试1')
def year_archive(request, year):
return HttpResponse(f"year_archive{year}")
def month_archive(request, year, month):
return HttpResponse(f"month_archive 年:{year} 月:{month}")
def article_detail(request, year, month, slug):
return HttpResponse(f"article_detail 年:{year} 月:{month} {slug}")
7.在子路由中添加路由地址
path('articles/2022/', views.special_case_2022),
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),
路由转换器
Django2以上内置路由转换器可以显式地指定路由中参数的数据类型,Django中内置了5种路由转
换器,分别为str、int 、slug 、uuid 和path
str:匹配任何非空字符串,但不包含路由分隔符“/”。如果URL中没有指定参数类型,默认使用该
类型。
int:匹配0或任何正整数。并作为 int 返回。
slug:匹配由字母、数字、连字符和下划线组成的URL。例如, building-your-1st-django-site
uuid:匹配一个uuid格式的字符串。为了防止多个URL映射到同一页面中,该转换器必须包含连
字符,且所有字母均为小写。例如, 075194d3-6885-417e-a8a8-6c931e272f00 . 返回一个 UUID
实例
path:匹配包含路径分隔符 ‘/’ 在内的任意非空字符串。 相对于 str ,这允许你匹配一个完整的
URL路径,而不仅仅是URL路径的一部分。
from django.contrib import admin
from django.urls import path
from urlAPPS.views import index
from urlAPPS import views
urlpatterns = [
path('index/', index),
path('articles/2022/', views.special_case_2022),
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),
# str字符串类型测试
path('articles/<str:year>/', views.str_cs),
]
正则表达式
如果路径和转换器语法不足以定义你的URL pattern,你还可以使用正则表达式。 为了使用正则表
达式,请使用 re_path() ,而不要使用 path() 。
在Python正则表达式中,命名正则表达式组的语法是 (?Ppattern) , 这里 name 是表达式组的名字
而 pattern 是要匹配的模式。
re_path(route, view, kwargs=None, name=None)
注意:
无论正则表达式匹配什么类型,每个捕获的参数都会以字符串形式传给视图。
正则表达式格式为:(?Ppattern),其中name表示分组名,pattern表示匹配的正则表达式。URL
匹配成功后,捕获到的参数会作为关键字参数传递给对应的视图,因此视图中的形式参数必须和正
则表达式中的分组名相同
若正则表达式只通过小括号“()”来捕获URL的参数,但未为其命名,则它是一个未命名正则表达
式,此时捕获的参数并将其以位置参数形式传递给对应视图
from django.contrib import admin
from django.urls import path , re_path
from urlAPPS.views import index
from urlAPPS import views
urlpatterns = [
# 路由转换器
path('index/', index),
# path('articles/2022/', views.special_case_2022),
# 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),
# str字符串类型测试
# path('articles/<str:year>/', views.str_cs),
# 正则表达式
re_path('articles/2021/$', views.re_special_case_2022),
re_path('articles/(?P<year>[0-9]{4})/$', views.re_year_archive),
re_path('articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$',views.re_month_archive),
re_path('articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[-_\w]+) / $', views.re_article_detail),
]
向视图传递额外参数
path()函数、re_path()函数允许向视图传递额外参数,这些参数存放在一个字典类型的数据中,该
数据的键代表参数名,值代表参数值。re_path()函数与path()函数传递额外参数方式相同,以path()函数为例介绍如何向视图传递额外参数。
使用path()函数的第三个参数可以向视图传递额外参数
路由解析顺序
Django在接收到一个请求时,从主路由文件中的urlpatterns列表中以由上至下的顺序查找对应路
由规则,如果发现规则为include包含,则再进入被包含的urls中的urlpatterns列表由上至下进行
查询
反斜线问题
Django中定义路由时,通常以斜线/结尾,其好处是用户访问不以斜线/结尾的相同路径时,
Django会把用户重定向到以斜线/结尾的路径上,而不会返回404不存在
views.py
from django.shortcuts import render
from django.http import HttpResponse
# Create your views here.
def index(request):
return HttpResponse('路由测试')
def special_case_2022(request):
return HttpResponse('路由测试1')
def year_archive(request, year):
return HttpResponse(f"year_archive{year}")
def month_archive(request, year, month):
return HttpResponse(f"month_archive 年:{year} 月:{month}")
def article_detail(request, year, month, slug):
return HttpResponse(f"article_detail 年:{year} 月:{month} {slug}")
def str_cs(request,city):
print('city的类型:',type(city))
return HttpResponse(f'str_cs{city}')
'''正则表达式'''
def re_special_case_2022(request):
return HttpResponse('路由测试1')
def re_year_archive(request, year):
return HttpResponse(f"year_archive{year}")
def re_month_archive(request, year, month):
return HttpResponse(f"month_archive 年:{year} 月:{month}")
def re_article_detail(request, year, month, slug):
return HttpResponse(f"article_detail 年:{year} 月:{month} {slug}")
'''传递额外参数'''
def blog_year_archive(request, year, major):
return HttpResponse(f"blog_year_archive 年 {year} 额外参数:{major}")
def re_blog_year_archive(request, year, major):
return HttpResponse(f"blog_year_archive 年 {year} 额外参数:{major}")
urls.py
from django.contrib import admin
from django.urls import path , re_path
from urlAPPS.views import index
from urlAPPS import views
urlpatterns = [
# 路由转换器
path('index/', index),
# path('articles/2022/', views.special_case_2022),
# 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),
# str字符串类型测试
# path('articles/<str:year>/', views.str_cs),
# 正则表达式
# re_path('articles/2021/$', views.re_special_case_2022),
# re_path('articles/(?P<year>[0-9]{4})/$', views.re_year_archive),
# re_path('articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$',views.re_month_archive),
# re_path('articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[-_\w]+) / $', views.re_article_detail),
# 传递额外参数
path('blog/<int:year>/', views.blog_year_archive, {'major': 'python'}),
re_path('blog/(?P<year>[0-9]{4})/$', views.re_blog_year_archive, {'major':'python'}),
]