目录
路由配置系统URLconf
一般写法
"""
urlpatterns = [
path(正则表达式, views视图函数，参数，别名),
]
参数说明：
1、一个正则表达式字符串
2、一个可调用对象，通常为一个视图函数或一个指定视图函数路径的字符串
3、可选的要传递给视图函数的默认参数（字典形式）
4、一个可选的name参数(别名)
"""
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),
]
"""
1、尖括号<>，捕获一段url中的值, <int:year>,将捕获的值转换成int类型，默认情况为sr
2、规则的前面不需要添加/
"""
"""
例子：
/articles/2005/03/ 对应第三条
/articles/2003/ 对应第一条
/articles/2003 未匹配，后面缺少/
"""- <>匹配
- str：默认值，匹配任何非空字符串，不含/
- int：匹配0和正整数，返回一个int类型
- slug：可理解为注释、后缀、附属等概念，匹配任何ASCII字符以及连接符和下划线
- uuid：匹配一个uuid格式的对象，返回一个UUID对象
- path：匹配任何非空字符串，包含路径分隔符’/‘
- 自定义<>匹配
-
""" 1、类属性regex：一个字符串形式的正则表达式属性； 2、to_python(self, value) 方法: 将匹配到的字符串转换为你想要的那个数据类型,并传递给视图函数 3、to_url(self, 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 - ?在URLconf中注册自定义转换器类
-
from django.urls import path, register_converter from . import converters, viewsregister_converter(converters.FourDigitYearConverter, 'yyyy') urlpatterns = [ path('articles/2003/', views.special_case_2003), path('articles/<yyyy:year>/', views.year_archive), ... ]
-
使用正则表达式
????????命名正则表达式组的语法是： (?P<name>pattern)，其中name是组的名称，pattern是需要匹配的规则
from django.urls import path, re_path
from . import views
urlpatterns = [
path('articles/2003/', views.special_case_2003),
#表示articles/2003/这个路径映射views模块的special_case_2003函数
re_path(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
#表示匹配4个0-9的任意数字
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),
]
#注意:上面匹配都加了小括号，这些括号里面的值会当作参数传递到后面的视图函数中re_path与path()不同的主要在于两点：
- year中匹配不到10000等非四位数字，这是正则表达式决定的
- 传递给视图的所有参数都是字符串类型。而不像path()方法中可以指定转换成某种类型。
错误页面处理
????????错误视图包括400、403、404和500，分别表示请求错误、拒绝服务、页面不存在和服务器错误：
-
handler400 —— django.conf.urls.handler400。
-
handler403 —— django.conf.urls.handler403。
-
handler404 —— django.conf.urls.handler404。
-
handler500 —— django.conf.urls.handler500。
-
-
相当的丑
自定义错误页面
# 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),
]
# 增加的条目
handler400 = views.bad_request
handler403 = views.permission_denied
handler404 = views.page_not_found
handler500 = views.page_error
# views.py
def page_not_found(request):
return render(request, '404.html')
def page_error(request):
return render(request, '500.html')
def permission_denied(request):
return render(request, '403.html')
def bad_request(request):
return render(request, '400.html')urls分层模块化（路由分发）
? ? ? ? include()方法
????????通常，我们会在每个app里，各自创建一个urls.py路由模块，然后从根路由出发，将app所属的url请求，全部转发到相应的urls.py模块中
from django.urls import include, path
urlpatterns = [
# ... snip ...
path('community/', include('aggregator.urls'),{'test':0}),
path('contact/', include('contact.urls')),
# ... snip ...
]????????include()方法，参数是转发目的地路径的字符串，路径以圆点分割。
? ? ? ? 例子中正则表达式没有包含$（字符串结束匹配符）,但是包含一个末尾的斜杠。
????????每当Django 遇到include()（来自django.conf.urls.include()）时，它会去掉URL中匹配的部分并将剩下的字符串发送给include的URLconf做进一步处理
? ? ? ? 另外一种方式：include也可以包含一个url()实例列表
from django.urls import include, path
from apps.main import views as main_views
from credit import views as credit_views
extra_patterns = [
path('reports/', credit_views.report),
path('reports/<int:id>/', credit_views.report),
path('charge/', credit_views.charge),
]
urlpatterns = [
path('', main_views.homepage),
path('help/', include('apps.help.urls')),
path('credit/', include(extra_patterns)),
]? ? ? ? 好处是可以将具有相同开头给url分开写：
from django.urls import path
from . import views
urlpatterns = [
path('<page_slug>-<page_id>/history/', views.history),
path('<page_slug>-<page_id>/edit/', views.edit),
path('<page_slug>-<page_id>/discuss/', views.discuss),
path('<page_slug>-<page_id>/permissions/', views.permissions),
]
"""
变成
"""
from django.urls import include, path
from . import views
urlpatterns = [
path('<page_slug>-<page_id>/', include([
path('history/', views.history),
path('edit/', views.edit),
path('discuss/', views.discuss),
path('permissions/', views.permissions),
])),
]????????被转发的URLconf会收到来自父URLconf捕获的所有参数
参数嵌套
????????正则表达式允许嵌套参数，Django将解析它们并传递给视图
from django.urls import re_path
urlpatterns = [
re_path(r'^blog/(page-(\d+)/)?$', blog_articles), # bad
re_path(r'^comments/(?:page-(?P<page_number>\d+)/)?$', comments), # good]????????两个模式都使用嵌套的参数，其解析方式是：blog/page-2/
- 第一个将匹配page-2，并带有两个位置参数：page-2，2
- 第二个将匹配page_number，并带有一个关键字参数{"page_number":2}，外围?:不捕获
反向解析
? ? ? ? 使用name
????????随着功能的增加，路由层的 url 发生变化，就需要去更改对应的视图层和模板层的 url，非常麻烦，不便维护。
????????这时我们可以利用反向解析，当路由层 url 发生改变，在视图层和模板层动态反向解析出更改后的 url，免去修改的操作。
????????反向解析一般用在模板中的超链接及视图中的重定向
from django.urls import path
from . import views
urlpatterns = [
#...
path('articles/<int:year>/', views.year_archive, name='news-year-archive'),
#...
]
from django.http import HttpResponseRedirect
from django.urls import reverse
def redirect_to_year(request):
# ...
year = 2006
# ...
return HttpResponseRedirect(reverse('news-year-archive', args=(year,)))
<a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a>
{# Or with the year in a template context variable: #}
<ul>
{% for yearvar in year_list %}
<li><a href="{% url 'news-year-archive' yearvar %}">{{ yearvar }} Archive</a></li>
{% endfor %}
</ul>命名空间
????????路由别名 name 没有作用域，Django 在反向解析 URL 时，会在项目全局顺序搜索，当查找到第一个路由别名 name 指定 URL 时，立即返回。当在不同的 app 目录下的urls 中定义相同的路由别名 name 时，可能会导致 URL 反向解析错误。
1、第一种，设置app_name属性
from django.urls import path
from . import views
app_name = 'polls'
urlpatterns = [
path('', views.IndexView.as_view(), name='index'),
path('<int:pk>/', views.DetailView.as_view(), name='detail'),
...
]
urls.py
from django.urls import include, path
urlpatterns = [
path('polls/', include('polls.urls')),
]2、第二种，include((<list?of?path()/re_path()?instances>,?<application?namespace>))
rom django.urls import include, path
from . import views
polls_patterns = ([
path('', views.IndexView.as_view(), name='index'),
path('<int:pk>/', views.DetailView.as_view(), name='detail'),
], 'polls')
urlpatterns = [
path('polls/', include(polls_patterns)),
]