Django的路由系统

最新推荐文章于 2024-07-20 11:40:37 发布
最新推荐文章于 2024-07-20 11:40:37 发布
阅读量110 收藏
点赞数
原文链接：http://www.cnblogs.com/Dominic-Ji/p/9200995.html
版权

Django的路由系统

Django 1.11版本 URLConf官方文档

URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表。

你就是以这种方式告诉Django，对于这个URL调用这段代码，对于那个URL调用那段代码。

URLconf配置

基本格式：

from django.conf.urls import url

urlpatterns = [
     url(正则表达式, views视图函数，参数，别名),
]

注意：

Django 2.0版本中的路由系统已经替换成下面的写法（官方文档）：

复制代码 
from django.urls import 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),
]
复制代码

参数说明：

  • 正则表达式：一个正则表达式字符串
  • views视图函数：一个可调用对象，通常为一个视图函数或一个指定视图函数路径的字符串
  • 参数：可选的要传递给视图函数的默认参数（字典形式）
  • 别名：一个可选的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),
]
复制代码

注意事项

  1. urlpatterns中的元素按照书写顺序从上往下逐一匹配正则表达式，一旦匹配成功则不再继续。
  2. 若要从URL中捕获一个值，只需要在它周围放置一对圆括号（分组匹配）。
  3. 不需要添加一个前导的反斜杠，因为每个URL 都有。例如，应该是^articles 而不是 ^/articles。
  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中的值并以关键字参数形式传递给视图。

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

下面是以上URLconf 使用命名组的重写：

复制代码 
from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^articles/2003/$', views.special_case_2003),
    url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
    url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive),
    url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail),
]
复制代码

这个实现与前面的示例完全相同，只有一个细微的差别：捕获的值作为关键字参数而不是位置参数传递给视图函数。

例如，针对url /articles/2017/12/相当于按以下方式调用视图函数：

views.month_archive(request, year="2017", month="12")

在实际应用中，使用分组命名匹配的方式可以让你的URLconf 更加明晰且不容易产生参数顺序问题的错误，但是有些开发人员则认为分组命名组语法太丑陋、繁琐。

至于究竟应该使用哪一种，你可以根据自己的喜好来决定。

URLconf匹配的位置

URLconf 在请求的URL 上查找，将它当做一个普通的Python 字符串。不包括GET和POST参数以及域名。

例如，http://www.example.com/myapp/ 请求中，URLconf 将查找myapp/。

在http://www.example.com/myapp/?page=3 请求中，URLconf 仍将查找myapp/。

URLconf 不检查请求的方法。换句话讲，所有的请求方法 —— 同一个URL的POST、GET、HEAD等等 —— 都将路由到相同的函数。

捕获的参数永远都是字符串

每个在URLconf中捕获的参数都作为一个普通的Python字符串传递给视图，无论正则表达式使用的是什么匹配方式。例如，下面这行URLconf 中：

url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),

传递到视图函数views.year_archive() 中的year 参数永远是一个字符串类型。

视图函数中指定默认值

复制代码 
# 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值。

include其他的URLconfs

复制代码 
#At any point, your urlpatterns can “include” other URLconf modules. This
#essentially “roots” a set of URLs below other ones.

#For example, here’s an excerpt of the URLconf for the Django website itself.
#It includes a number of other URLconfs:


from django.conf.urls import include, url

urlpatterns = [
   url(r'^admin/', admin.site.urls),
   url(r'^blog/', include('blog.urls')),  # 可以包含其他的URLconfs文件
]
复制代码

传递额外的参数给视图函数（了解）

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')。
这个技术在Syndication 框架中使用，来传递元数据和选项给视图。

命名URL和URL反向解析

简单来说就是可以给我们的URL匹配规则起个名字，一个URL匹配模式起一个名字。

这样我们以后就不需要写死URL代码了，只需要通过名字来调用当前的URL。

举个简单的例子：

url(r'^home', views.home, name='home'),  # 给我的url匹配模式起名为 home
url(r'^index/(\d*)', views.index, name='index'),  # 给我的url匹配模式起名为index

这样：

在模板里面可以这样引用(就会直接找到url里面起这个名字的对应处理匹配原则和视图函数)：

{% url 'home' %}

在views函数中可以这样引用：

from django.urls import reverse

reverse("index", args=("2018", ))

 实战图解

 

例子：
考虑下面的URLconf：

复制代码 
from django.conf.urls import url

from . import views

urlpatterns = [
    # ...
    url(r'^articles/([0-9]{4})/$', views.year_archive, name='news-year-archive'),
    # ...
]
复制代码

根据这里的设计，某一年nnnn对应的归档的URL是/articles/nnnn/。

你可以在模板的代码中使用下面的方法获得它们：

复制代码 
<a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a>

<ul>
{% for yearvar in year_list %}
<li><a href="{% url 'news-year-archive' yearvar %}">{{ yearvar }} Archive</a></li>
{% endfor %}
</ul>
复制代码

在Python 代码中，这样使用：

复制代码 
from django.urls import reverse
from django.shortcuts import redirect

def redirect_to_year(request):
    # ...
    year = 2006
    # ...
    return redirect(reverse('news-year-archive', args=(year,)))
复制代码

如果出于某种原因决定按年归档文章发布的URL应该调整一下，那么你将只需要修改URLconf 中的内容。

在某些场景中，一个视图是通用的，所以在URL 和视图之间存在多对一的关系。对于这些情况，当反查URL 时，只有视图的名字还不够。

注意：

为了完成上面例子中的URL 反查，你将需要使用命名的URL 模式。URL 的名称使用的字符串可以包含任何你喜欢的字符。不只限制在合法的Python 名称。

当命名你的URL 模式时，请确保使用的名称不会与其它应用中名称冲突。如果你的URL 模式叫做comment，而另外一个应用中也有一个同样的名称，当你在模板中使用这个名称的时候不能保证将插入哪个URL。

在URL 名称中加上一个前缀，比如应用的名称，将减少冲突的可能。我们建议使用myapp-comment 而不是comment。

命名空间模式

即使不同的APP使用相同的URL名称，URL的命名空间模式也可以让你唯一反转命名的URL。

举个例子：

project中的urls.py

复制代码 
from django.conf.urls import url, include
 
urlpatterns = [
    url(r'^app01/', include('app01.urls', namespace='app01')),
    url(r'^app02/', include('app02.urls', namespace='app02')),
]
复制代码

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')
]
复制代码

app02中的urls.py

复制代码 
from django.conf.urls import url
from app02 import views
 
app_name = 'app02'
urlpatterns = [
    url(r'^(?P<pk>\d+)/$', views.detail, name='detail')
]
复制代码

现在，我的两个app中 url名称重复了，我反转URL的时候就可以通过命名空间的名称得到我当前的URL。

语法：

'命名空间名称:URL名称'

模板中使用：

{% url 'app01:detail' pk=12 pp=99 %}

views中的函数中使用

v = reverse('app01:detail', kwargs={'pk':11})

 这样即使app中URL的命名相同，我也可以反转得到正确的URL了。

django2.0版的path

django2.0的re_path和1.0的url一样

思考情况如下：

urlpatterns = [  
    re_path('articles/(?P<year>[0-9]{4})/', year_archive), re_path('article/(?P<article_id>[a-zA-Z0-9]+)/detail/', detail_view), re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/edit/', edit_view), re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/delete/', delete_view), ]

考虑下这样的两个问题：

第一个问题，函数 year_archive 中year参数是字符串类型的，因此需要先转化为整数类型的变量值，当然year=int(year) 不会有诸如如TypeError或者ValueError的异常。那么有没有一种方法，在url中，使得这一转化步骤可以由Django自动完成？

第二个问题，三个路由中article_id都是同样的正则表达式，但是你需要写三遍，当之后article_id规则改变后，需要同时修改三处代码，那么有没有一种方法，只需修改一处即可？

在Django2.0中，可以使用 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>/', views.article_detail), 
　　# path才支持，re_path不支持
　　path('order/<int:year>',views.order), ]

基本规则：

  • 使用尖括号(<>)从url中捕获值。
  • 捕获值中可以包含一个转化器类型（converter type），比如使用 <int:name> 捕获一个整数变量。若果没有转化器，将匹配任何字符串，当然也包括了 / 字符。
  • 无需添加前导斜杠。

以下是根据 2.0官方文档 而整理的示例分析表：(跟上面url的匹配关系)

path转化器

文档原文是Path converters，暂且翻译为转化器。

Django默认支持以下5个转化器：

  • str,匹配除了路径分隔符（/）之外的非空字符串，这是默认的形式
  • int,匹配正整数，包含0。
  • slug,匹配字母、数字以及横杠、下划线组成的字符串。
  • uuid,匹配格式化的uuid，如 075194d3-6885-417e-a8a8-6c931e272f00。
  • path,匹配任何非空字符串，包含了路径分隔符（/）（不能用？）

注册自定义转化器

对于一些复杂或者复用的需要，可以定义自己的转化器。转化器是一个类或接口，它的要求有三点：

  • regex 类属性，字符串类型
  • to_python(self, value) 方法，value是由类属性 regex 所匹配到的字符串，返回具体的Python变量值，以供Django传递到对应的视图函数中。
  • to_url(self, value) 方法，和 to_python 相反，value是一个具体的Python变量值，返回其字符串，通常用于url反向引用。

例子： 

class FourDigitYearConverter:  
    regex = '[0-9]{4}'  
    def to_python(self, value): return int(value) def to_url(self, value): return '%04d' % value

使用register_converter 将其注册到URL配置中：

from django.urls import register_converter, path  
from . import converters, views register_converter(converters.FourDigitYearConverter, 'yyyy') urlpatterns = [ path('articles/2003/', views.special_case_2003), path('articles/<yyyy:year>/', views.year_archive), ... ]

 

转载于:https://www.cnblogs.com/Dominic-Ji/p/9200995.html

自我修炼的小石头
关注
Django中设置路由参数
weixin_34322964的博客
10-14 1599
# -*- coding: utf-8 -*- import sys reload(sys) sys.setdefaultencoding('utf8') from django.conf.urls import url # .代表当前目录 # ..代表上级目录 from . import views urlpatterns = [ # 通过localhost:8000/app/路
Django路由参数
L_ZhouZhou的博客
03-11 620
文章目录stringintslugpath正则多参 string # 默认就是string，类型名字可不指定 path('mystr/<theme>', views.mystr, name='mystr'), int path('myint/<int:age>', views.myint, name='myint'), slug path('my...
[Python]Django 学习笔记 一——路由及其参数
weixin_44566432的博客
07-16 752
根路由： from django.contrib import admin from django.urls import path, include from App01 import views urlpatterns = [ path('admin/', admin.site.urls), #在根路由中包含子路由 #不能由/开头,最好以/结尾 path('user/', include('App01.urls')), ] 子路由： 在根路由中添加子路由用..
【django】路由传递参数的几种方式(更新)
python全栈
12-21 1831
第一种传参： 子路由： from django.urls import pathfrom film import views urlpatterns = [ path('<int:fid>/filmdetail/',views.filmDetail), ] 视图： def filmDetail(request,fid): return HttpResponse(fid) 浏览器地址栏访问： http://127.0.0.1:8000/film/1001/filmdetail/
django路由冷知识-可选变量
xiaobukasi的专栏
05-15 181
urlpatterns = [path(".html", TestView.as_view(), {"name": [3, 4, 5, "dsadadsad"]}, name="test"),] # 定制可选变量,可选变量必须为dict,且必须在视图函数之后 用法： class TestView(View): TEMPLATE = "test.html" def get(self, request, *args, **kwargs): name = kwargs.g.
Django路由系统精讲
ccc369639963的博客
05-17 216
Django路由系统精讲 在前一节中，我们对 URL 有了基本的认识，在本节将对 Django 的路由系统展开详细的讲解， 让我们更加清楚的了解 URL 在 Django 中到底是如何应用的。 1. Django 路由系统应用 一个用户向 Web 站点发送请求，是通过 URL 实现的，当 Web 服务器端接收到用户请求后，它又是怎么处理的呢？通过 MTV 的设计模式，我们可以得知，首先用户请求会到达相应的视图函数，那么视图函数又是怎样找到相应的访问资源的呢，在这里就用到了“路由系统”。 Django 中利用
Django 路由系统URLconf的使用
01-21
URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL与要为该URL调用的view函数之间的映射表；你就是以这种方式告诉Django，对于这个URL调用这段代码，对于那个URL调用那段代码。 urlpatterns = [ url...
Django 路由系统详解
csbysj2020
06-24 515
Django 是一个高级 Python Web 框架，它鼓励快速开发和干净、实用的设计。在 Django 中，路由系统是其核心组件之一，负责将用户的请求映射到相应的视图函数或类。本文将深入探讨 Django 的路由系统，包括其工作原理、配置方式以及高级功能。
Django 路由
12-20
总结起来，Django路由系统是通过URL配置文件（通常为`urls.py`）将用户请求的URL映射到对应的视图函数，实现业务逻辑的执行。随着版本更新，Django提供了更加友好和灵活的路由配置方式，如`path()`和`re_path()`，...
django 主子路由，路由传参，请求传参
梦想家博客
06-14 3044
一、主子路由1.主路由，当主路由很多的时候，效率变慢，维护起来相当麻烦2.项目文件夹中 urls.py  把主路由当作调度分发路由的工具，去分发子路由from django.conf.urls import url,includefrom django.contrib import adminfrom lol_hero.views import indexurlpatterns = [url(r'...
django URL路由与传参
廷益_飞鸟的博客
12-18 354
1、普通路由 浏览器 127.0.0.1:8000/page1 URL path('page1', views.page1_view), # page1页面 视图 def page1_view(request): html = "<h1>这是第一个页面<h1>" return HttpResponse(html) 2、分组路由 浏览器 127.0.0.1:8000/100/add/200 URL re_path(r"^(\d+)/(\w{3})/(.
Django之路由系统的配置
weixin_43460239的博客
07-16 488
Django之路由系统 准备工作 1.导入views.py文件 #在urls.py文件中导入app中的views.py文件 from app01.views import * #我的app名为app01 示例一： 2.在views.py导入相应的库 #在views.py文件中导入render,HttpResponse,redirect from django.shortcuts import render,HttpResponse,redirect 示例二： 单一路由 urlpatterns =
Django框架 - 路由配置全解
qq_42694871的博客
07-07 666
Django框架：路由配置全解，包括路由分发、正则匹配、自定义path转换器、附加参数等。
Django路由参数传递
最新发布
SilentVoidCan的专栏
07-20 927
传递参数(re_path()方法正则匹配)
Django2.1路由传递参数
lucky__peng的博客
02-20 1307
1、先创建项目(django-admin startproject djangourlparams)和app应用(python manage.py startapp app名称) 2、在urlparams中创建urls.py文件。 3、在入口urls.py文件(即和项目settin...
Django配置 url路由 视图 标签, cookies
weixin_42100915的博客
06-09 725
安装pip3 install django创建Django项目django-admin startproject 项目名创建应用python manage.py startapp 应用名应用目录tests.py 测试views.py 视图models.py 操作数据库ormadmin.py 后台管理系统 项目目录：全局settings.py 配置信息urls.py 路径分发启动Django项...
Django中路由传值
hrj199036的博客
02-26 646
Django中路由传值本教程主要内容为Django中路由传值一、设置二、在templates中传参到path 本教程主要内容为Django中路由传值 一、设置 路由设置 path('var/<value_var>') #注：变量名要放入<>里，并且要与views中的传入的参数要一致 可以限制传入的类型 str - 匹配除了 ‘/’ 之外的非空字符串。如果表达式内...
Django笔记11：路由配置详解
向东的笔记本
03-23 729
配置网站的URL可以说是我们用Django进行网站开发的第一步，Django的路由设置也由原来的1.0版本的正则表达式配置变成了现在2.0版本的路径配置方式，我个人是很喜欢路径配置的方式的，因为这种方式看起来很简洁。接下来我就对路径、正则表达式这两种方式的配置规则做一下整理。 1.路径配置 首先需要在项目或者APP的urls.py中导入path和views，需要注意的是仅仅在APP下定义URL...
Django URLconf路由系统详解
Django的URLconf系统是其灵活性和可扩展性的关键组成部分，它允许开发者以声明式的方式定义URL结构，同时保持代码的清晰和简洁。理解并熟练运用URLconf对于任何Django开发者来说都是至关重要的。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值