Django - 路由系统
一. URLconf配置
1. 基本格式
from django.conf.urls import url
urlpatterns = [ url(正则表达式, views视图, 参数, 别名), ]
示例
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), ]
2. 参数说明:
正则表达式: 一个正则表达式字符串
views视图: 一个可调用对象, 通常为一个视图函数
参数: 可选的要传递给视图函数的默认参数(字典形式)
别名: 一个可选色name参数
注意:
Django 2.0版本中的路由系统是下面的写法:
from django.urls import path，re_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), ]
2.0版本中re_path和1.11版本的url是一样的写法.
二. 正则表达式
1. 基本配置
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), ]
2. 注意事项
a, urlpatterns中的元素按照书写顺序从上往下注意匹配正则表达式, 一旦匹配成功则不再继续
b, 若要从URL中捕获一个值, 只需要在他周围放置一对圆括号(分组括号)
c, 不需要添加一个前导的反斜杠, 以为每个URL都有, 例如, 应该是^articles而不是^/articles
d, 每个正则表达式前面的'r'是可选的但是建议加上
3. 补充说明
APPEND_SLASH=True #是否开启URL访问地址后面不为 / 跳转至带有 / 的路径的配置项
Django settings.py配置文件中默认没有APPEND_SLASH 这个参数, 但Django默认这个参数为APPEND_SLASH = .True, 作用就是自动在网站结尾加'/''.
如果在sttings.py 中设置了APPEND_SLASH = False, 此时如果访问界面后面不加 / ,就无法访问
三. 分组
1. 分组命名正则表达式的语法: (?P<name>pattern), 其中name 是组的名称, pattent 是要匹配的模式
url(r'^del_publisher/(d+)', views.del_publisher)
匹配到参数, 按照未知参数的方式传递给视图函数 视图函数需要定义形参接收变量
2. 命名分组
url(r'^blog/(?P<year>d{4}/[1-9]{2})$', views.blog)
匹配到参数, 按照关键字参数的方式传递给视图函数 视图函数需要定义关键字参数
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), ]
视图函数
views.month_archive(request, year="2017", month="12"
3. 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等等 —— 都将路由到相同的函数。
4. 捕获的参数永远都是字符串
每个在URlconf中捕获的参数都作为一个普通的Python字符串传递给视图, 无论正则表达式使用的是什么匹配方式.
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
传递到视图函数 views.year_archive() 中的year参数永远是一个字符串类型
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), ] # views.py中，可以为num指定默认值 def page(request, num="1"): pass
在上面的例子中, 两个URL模式指向相同的view - views.page 但是第一个模式并没有从URl中捕6.获任何东西,如果第一模式匹配上了,page()函数将使用其默认参数num='1', 如果第二个模式匹配, page() 将使用正则表达式捕获的num值.
6. 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文件
四 命名URl和URl反向解析
1.普通url
命名
url(r'^publisher_list/', view.publisher_list, name= 'publisher')
在视图中使用:
from django.urls import reverse
reverse('publisher') -->> '/app01/publisher_list'
模板中使用:
{% url 'publisher'%} -->> '/app01/publisher/'
2. 使用分组
命名
url(r'^blog/(?P<year>d{4})/(?P<month>[1-9]{2})/$', views.blog, name='blog')
视图中使用:
reverse('blog'/, args=('2018', '12')) #
url(r'^blog/(?P<year>d{4})/(?P<month>[1-9]{2})/$', views.blog, name='blog')
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') ]