欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Django的路由系统:URL

程序员文章站 2022-05-03 22:16:50
一、 URLconf配置 1. 基本格式 参数说明 正则表达式:一个正则表达式字符串 views视图:一个可调用对象,通常为一个视图函数 参数:可选的要传递给视图函数的默认参数(字典形式) 别名:一个可选的name参数 2. django 2.0版本的路由系统 2.0版本中re_path和1.11版 ......

一、 urlconf配置

  1. 基本格式

    from django.conf.urls import url
    urlpatterns = [
         url(正则表达式, views视图,参数,别名),
    ]
    • 参数说明
      • 正则表达式:一个正则表达式字符串
      • views视图:一个可调用对象,通常为一个视图函数
      • 参数:可选的要传递给视图函数的默认参数(字典形式)
      • 别名:一个可选的name参数
  2. django 2.0版本的路由系统

    • 2.0版本中re_path和1.11版本的url是一样的用法
    from django.urls import path,re_path
    urlpatterns = [
        path('articles/2003/', views.special_case_2003),
    ]

二、 正则表达式

  1. 基本配置

    from django.conf.urls import url
    from . import views
    urlpatterns = [
        url(r'^articles/2003/$', views.special_case_2003),
    ]
  2. 注意事项

    • urlpatterns中的元素按照书写顺序从上往下逐一匹配正则表达式,一旦匹配成功则不再继续
    • 若要从url中捕获一个值,只需要在它周围放置一对圆括号(利用分组匹配)
    • 不需要添加一个前导的反斜杠,因为每个url 都有。例如,应该是^articles 而不是 ^/articles
    • 每个正则表达式前面的'r' 是可选的但是建议加上
  3. 补充说明

    • 是否开启url访问地址后面不为/跳转至带有/的路径的配置项:append_slash=true
    • django settings.py配置文件中默认没有 append_slash 这个参数,但 django 默认这个参数为 append_slash = true,其作用就是自动在网址结尾加'/'

三、 分组命名匹配

  1. 分组:使用简单的正则表达式分组匹配(通过圆括号)来捕获url中的值并以位置参数形式传递给视图函数

    from django.conf.urls import url
    from . import views
    urlpatterns = [
        url(r'^articles/([0-9]{4})/$', views.year_archive),
        url(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive),
    ]
  2. 命名分组:使用分组命名匹配的正则表达式组来捕获url中的值并以关键字参数形式传递给视图函数

    from django.conf.urls import url
    from . import views
    urlpatterns = [
        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的第三个参数时一个字典,表示想要传递给视图函数的额外关键字参数
      • 当传递额外参数的字典中的参数和url中捕获值的命名关键字参数同名时,函数调用时,将使用的是字典中的参数,而不是url中捕获的参数
      • 即优先级:额外参数 > url捕获参数
  3. uplconf匹配的位置:

    • 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等),都将路由到相同的函数
  4. 捕获的参数都是字符串:每个在urlconf中捕获的参数都作为一个普通的python字符串传递给视图函数,无论正则表达式使用的是什么匹配方式

  5. 有个别情况,需要视图函数指定默认值

    # 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),
    ]
    # 两个url模式指向相同的view,但是第一个模式并没有从url中捕获任何东西
    
    # views.py中,可以为num指定默认值
    def page(request, num="1"):
        pass
    # 如果第一个模式匹配上了,page函数将使用其默认参数num=“1”,如果第二个模式匹配,page将使用正则表达式捕获到的num值
  6. include:路由分发

    • 根据功能或种类的不同,可以把不同的功能的路由写在该功能的app文件下,利用include联系起来,相当于把不同功能的url放在不同的空间里
    from django.conf.urls import include, url
    urlpatterns = [
       url(r'^admin/', admin.site.urls),
       url(r'^app01/', include('app01.urls')),  # 可以包含其他的urlconfs文件
    ]
    • 补充:app01.urls
    from django.conf.urls import url
    from . import views
    urlpatterns = [
        url(r'^blog/$', views.blog),
        url(r'^blog/(?p<year>[0-9]{4})/(?p<month>\d{2})/$', views.blogs),
    ]
    • include有一个命名空间的参数:namespace
      • 便于区分不同路由空间中存在的同名函数,利于指定到确切的函数
    from django.conf.urls import include, url
    urlpatterns = [
        url(r'^app01/', include('app01.urls', namespace='app01')),
        url(r'^app02/', include('app02.urls', namespace='app02')),
    ]

四、url的命名和反向解析

4.1 url命名

  1. url的第四个参数是起一个别名,即一个可选的name参数

  2. 命名方式:name = '别名'

    from django.conf.urls import url
    urlpatterns = [
     url(r'^home', views.home, name='home'),        # 给我的url匹配模式起名为 home
     url(r'^index/(\d*)', views.index, name='index'),       # 给我的url匹配模式起名为index
    ]

4.2 反向解析

  1. 反向解析:通过别名获取完整url路径

  2. 情况一:静态路由

    • 命名
    from django.conf.urls import url
    urlpatterns = [
     url(r'^blog/$', views.blog, name='blog'),
    ]
    • 模板中使用
    {% url 'blog' %}         {# 完整url路径:/blog/ #}
    • py文件中使用
    from django.urls import reverse
    reverse('blog')           # 完整url路径:/blog/
  3. 情况二:分组

    • 命名
    from django.conf.urls import url
    urlpatterns = [
     url(r'^blog/([0-9]{4})/(\d{2})/$', views.blogs, name='blogs'),
    ]
    • 模板中使用
    {% url 'blogs' 2222 12 %}        {# 完整url路径:/blog/2222/12/ #}
    • py文件中使用
    from django.urls import reverse
    reverse('blogs',args=('2019','06'))        # 完整url路径:/blog/2019/06/ 
  4. 情况三:命名分组

    • 命名
    from django.conf.urls import url
    urlpatterns = [
     url(r'^blog/(?p<year>[0-9]{4})/(?p<month>\d{2})$', views.blogs, name='blogs'),
    ]
    • 模板中使用
    {% url 'blogs' year=2222 month=12 %}      {# 完整url路径:/blog/2222/12/ #}
    • py文件中使用
    from django.urls import reverse
    reverse('blogs',kwargs={'year':'2019','month':'06'})      # 完整url路径:/blog/2019/06/ 

五、 命名空间模式下的反向解析

  1. 项目目录下的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')),
    ]
  2. app01中的urls.py

    from django.conf.urls import url
    from app01 import views
    urlpatterns = [
        url(r'^(?p<pk>\d+)/$', views.detail, name='detail')
    ]
  3. app02中的urls.py

    from django.conf.urls import url
    from app02 import views
    urlpatterns = [
        url(r'^(?p<pk>\d+)/$', views.detail, name='detail')
    ]
  4. 反向解析语法:'命名空间名称:url名称'

    • 在模板中的使用方式
    {% url 'app01:detail' pk=12 %}
    {% url 'app02:detail' pk=12 %}
    • 在py文件中的使用方式
    from django.urls import reverse
    reverse('app01:detail', kwargs={'pk':11})
    reverse('app01:detail', kwargs={'pk':11})
  5. 注意:如果有多层路由分发,有了多个命名空间名称,都要把命名空间名称一层一层加在别名前面

    {# 简单示例:app01是第一层路由空间的namespace,xxx是第二层路由空间的namespace #}
    {% url 'app01:xxx:index' %}