Django路由
关于Django的路由分发,见官方文档。
一般使用#
路由分发应该在urls.py中进行。默认的根urls是通过settings文件配置的:ROOT_URLCONF = '<项目名>.urls'
。
路由的分发靠的是urlpatterns列表来的定义的,其内的元素是path
或re_path
。
如:
from django.contrib import admin from django.urls import path urlpatterns = [ path('admin/', admin.site.urls), ]
path
的一般参数:path('admin/', admin.site.urls, name="myadmin")
admin/
是一段字符串,可以直接写成url,也可以带上过滤器,当django自上而下匹配到这个url时,会生成一个HttpRequest对象传给视图的的一个参数。
admin.site.urls
是一个视图函数,用于处理请求。
name="myadmin"
:name参数可以为dango的反向解析,动态生成url提供帮助,和app_name
使用效果更好。
关于url以"/"结尾的匹配:如path('admin/', admin.site.urls)
可以匹配admin/
和admin
,但若是path('admin', admin.site.urls)
的话,就只能匹配到admin
。
路由转发#
通常,我们会在每个app里,各自创建一个urls.py路由模块,然后从根路由出发,将app所属的url请求,全部转发到相应的urls.py模块中。
要实现这个功能,需要用到django.urls.include
模块。
如
from django.contrib import admin from django.urls import path, include urlpatterns = [ path('admin/', admin.site.urls), path("app1/", include("app1.urls")), path("app2/", include("app2.urls")), ]
之后我们就可以在app的urls中做进一步的处理了。
需要注意的是:app.urls中接收到的url是已经去掉匹配部分的。如依照上面的路由,app1/user/index
到了app1.urls中时,就剩下了user/index
,所以写路由分发时需要注意。而且app中的urls.py需要我们手动创建。
转换器#
转换器本质上就是一个使用正则表达式匹配url,但是它可以自动将url中匹配的内容转换成我们需要的数据格式传给request,也可以动态生成url。
默认情况下,Django内置下面的路径转换器:
- str:匹配任何非空字符串,但不含斜杠/,如果你没有专门指定转换器,默认使用该转换器
- int:匹配0和正整数,返回一个int类型
- slug:可理解为注释、后缀、附属等概念,是url拖在最后的一部分解释性字符。该转换器匹配任何ASCII字符以及连接符和下划线,比如building-your-1st-django-site;
- uuid:匹配一个uuid格式的对象。为了防止冲突,规定必须使用破折号,所有字母必须小写,例如075194d3-6885-417e-a8a8-6c931e272f00。返回一个UUID对象;
- path:匹配任何非空字符串,重点是可以包含路径分隔符’/‘。这个转换器可以帮助你匹配整个url而不是一段一段的url字符串。要区分path转换器和path()方法
使用方式
from django.urls import path from . import views 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), ]
'articles/<int:year>/'
中的int是转换器,而year是request中的参数名。
自定义转换器#
默认的转换可以实现一般的匹配,但是假如要匹配复杂度和自定义程度比较高的url时,可以自定义一个转换器。
第一步:自定义类
在app中创建一个converters.py
,用于放置转换器类
关键实现:
- 类属性:regex
这里需要写正则表达式 - 类方法:to_python
转换数据给视图用,失败要抛出ValueError异常 - 类方法:to_url
返回url供反转操作,失败要ValueError异常
# app/converters.py class Year: regex = "\d{4}" def to_python(self, value): try: return int(value) except ValueError: raise ValueError def to_url(self, value): return value
第二步:在url中注册
# polls/urls.py from django.urls import path, register_converter from . import views, converters app_name = "polls" # app_name的作用后面讲述 # 注册转换器为year_conv register_converter(converters.Year, "year_conv") urlpatterns = [ path("", views.index, name="index"), # 和默认转换器一样使用自定义转换器 path("<year_conv:year>/", views.test, name="test"), ]
关于re_path#
Django2.0的urlconf虽然改‘配置方式’了,但它依然向老版本兼容。而这个兼容的办法,就是用re_path()
方法。re_path()
方法在骨子里,根本就是以前的url()
方法,只不过导入的位置变了。下面是一个例子,对比一下Django1.11时代的语法,有什么太大的差别?
from django.urls import path, re_path from . import views urlpatterns = [ path('articles/2003/', views.special_case_2003), re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive), re_path(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive), re_path(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<slug>[\w-]+)/$', views.article_detail), ]
与path()
方法的不同点:
捕获URL中的参数使用的是正则捕获,语法是 (?P<name>pattern)
,其中 name 是组名,pattern 是要匹配的模式。
传递给视图的所有参数都是字符串类型。而不像path()方法中可以指定转换成某种类型。在视图中接收参数时一定要小心。
反向解析及应用命名空间#
反向解析的功能可以动态生成url,防止我们将url写死,减少维护复杂度。
反向解析可以在python代码中应用,也可以在django的template中应用。
如在urls中这样定义:
from django.urls import path from .views import index, article urlpatterns = [ path("index/", index, name="index"), path("article/<int:article_id>", article, name="article") ]
-
python代码中反向解析:
# 1. 导入django.urls.reverse函数 # 2. 根据urls中path对象的name参数,确定你要生成的是那个url # 3. 假如url中需要参数的话,以args或kwargs传入 from django.http import HttpResponse from django.urls import reverse # Create your views here. def index(request): index_url = reverse("index") return HttpResponse(index_url) def article(request, article_id): # article_url = reverse("article", args=(article_id, )) article_url = reverse("article", kwargs={"article_id": article_id}) return HttpResponse(article_url) -
在template中反向解析:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> {% url "index" %} {% url "article" "1234" %} </body> </html> 使用的是django模板引擎的url标签,使用template时,应该要在settings中的
INSTALLED_APPS
添加上自己的app。
以上只利用path的name参数生成url的做法,在多个app时(如app1:name="index", app2:name="index")可能就不怎么适用了。
因此django为我们提供了一个app_name变量,可以为我们标识不同的app。
在app/urls.py中我们可以自定义一个独一无二的app_name,如:
from django.urls import path from .views import index, article app_name = "app01" urlpatterns = [ path("index/", index, name="index"), path("article/<int:article_id>", article, name="article") ]
在使用的时候只需要在name字符前面加上app_name:
即可,如:
article_url = reverse("app01:article", kwargs={"article_id": article_id})
template的使用也是如此,改变第一个参数即可。
django还可以为不同的对象提供标识,实现方式时:给include添加name_space参数。具体可点击:关于include和name_space的使用。
作者:忞翛
出处:https://www.cnblogs.com/lczmx/p/14938791.html
版权:本作品采用「署名-非商业性使用-相同方式共享 4.0 国际」许可协议进行许可。
欢迎各位大佬评论交流。可以的话,不妨点一下推荐。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· .NET Core GC压缩(compact_phase)底层原理浅谈
· 现代计算机视觉入门之:什么是图片特征编码
· .NET 9 new features-C#13新的锁类型和语义
· Linux系统下SQL Server数据库镜像配置全流程详解
· 现代计算机视觉入门之:什么是视频
· Sdcb Chats 技术博客:数据库 ID 选型的曲折之路 - 从 Guid 到自增 ID,再到
· .NET Core GC压缩(compact_phase)底层原理浅谈
· Winform-耗时操作导致界面渲染滞后
· Phi小模型开发教程:C#使用本地模型Phi视觉模型分析图像,实现图片分类、搜索等功能
· 语音处理 开源项目 EchoSharp