Django的路由系统

URLconf配置文件

# URLconf文件
from django.conf.urls import url
urlpatterns = [
     url(regex, view, kwargs=None, name=None),
]

1. regex 是正则表达式
2. view 是视图函数(类)名
3. kwargs是一个字典,是可选的,包含额外传递给视图的参数
4. name是一个别名,稍后解释

正则匹配详解

http://www.conyli.cc:8000/wp-admin/?article=1109

url(r'^item_edit/', views.item_edit)

# 匹配item_edit/开头的URL,类似item_edit/new/也会匹配成功 
r'^item_edit/' 
# 精确匹配,仅能匹配"item_edit/",再有子路径无法匹配成功
r'^item_edit/$'
# 批量匹配一批由任意数字排序的URL,比较常用在内容管理系统内.
r'^book/[0-9]{2,4}/$'
# 分组,匹配类似book/333/ab/这样的URL,注意,如果采用分组,分组匹配的部分会把值传递给对应的视图函数.
r'^book/([0-9]{2,4})/([a-zA-Z]{2})/$'
# 分组命名匹配,与分组类似,但是给每个分组按照正则规则命名,会按照关键字传入视图函数
r'^articles/(?P[0-9]{4})/$'

1. URLconf内的匹配顺序是从上到下,取第一个匹配成功的视图执行响应,后边不再匹配
2. 如果要捕获URL的一部分,在对应的正则匹配的地方用分组元字符,还可以命名.匹配的值会传递给视图函数
3. 正则的开头不要写"/",这个不属于路径的一部分
4. 最好用r字符串传格式,否则会面临正则二次转义的问题
5. 所有正则捕获传递给视图函数的值都是字符串类型,需要注意视图函数中的类型转换.
6. 正则表达式不检查请求类型,GET POST等都是按照同样的路径解析方式

# urls.py中
from django.conf.urls import url

from . import views

urlpatterns = [
    url(r'^blog/$', views.page),
    url(r'^blog/page(?P[0-9]+)/$', views.page),
]
# views.py中，可以为num指定默认值
def page(request, num="1"):
    pass

多重路径匹配

from django.conf.urls import include, url

urlpatterns = [
   url(r'^admin/', admin.site.urls),
   url(r'^blog/', include('blog.urls')),
]
# 其中的blog.urls就是另外一个URLconf文件.会继续拿着以"blog/"开头的路径进行解析.

传递额外参数给视图函数

from django.conf.urls import url
from . import views

urlpatterns = [
    url(r'^blog/(?P[0-9]{4})/$', views.year_archive, {'foo': 'bar'}),
]

命名URL和URL反向解析

<a href="/move_add/?id={{ item.id }}" class="btn btn-primary">录入单据

url(r'^move_add/', views.move_add,name="io_ticket")

<a href="{% url "io_ticket" %}?id={{ item.id }}" class="btn btn-primary">录入单据</a>

# 需要先导入反向解析函数
from django.urls import reverse

reverse_url = reverse("io_ticket")
redirect(reverse_url)

url(r'^blog/(?P<year>[0-9]{2,4})/(?P<title>[a-zA-Z]{2})$', views.year_archive,name="archive")

from django.urls import reverse

reverse_url = reverse("archive",kwargs={"year":2018,"title":"xb"})
redirect(reverse_url)

# URLconf配置文件,用来匹配articles/xxxx/这种路径,x为任意数字
urlpatterns = [
    url(r'^articles/([0-9]{4})/$', views.year_archive, name='news-year-archive'),
]

# 模板内使用url tag 加参数来反向解析URL
<ul>
{% for yearvar in year_list %}
<li><a href="{% url 'news-year-archive' yearvar %}">{{ yearvar }} Archive</a></li>
{% endfor %}
</ul>

def redirect_to_year(request):
    year = 2018
    return redirect(reverse('news-year-archive', args=(year,)))

• 没有模糊匹配的正则表达式起别名
  • 在模板中用{% url name %}来反向解析
  • 在代码中用reverse(name)来反向解析
• 有模糊匹配,只分组,未命名的正则表达式起别名
  • 在模板中用{% url name arg... %}来反向解析
  • 在代码中用reverse(name,(arg1,...))来反向解析
• 有模糊匹配,分组且命名的正则表达式起别名
  • 在模板中用{% url name arg... %}来反向解析,这里官方文档未提到,估计是采用名字相同的变量,然后通过视图给变量传值
  • 在代码中用reverse(name,kwargs={})来反向解析

URL命名空间

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

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

Django是如何处理URL的

1. Django首先需要确定根URLconf模块。通常它是settings.py里 ROOT_URLCONF 设置的值，但是如果传入的HttpRequest对象有一个名为URLconf的属性(通过中间件请求处理设置)，那么它的值将被使用来代替 ROOT_URLCONF 设置。
2. Django加载所有的Python模块并在其中查找urlpatterns变量。它应该是一个以函数 django.conf.urls.patterns() 返回的Python列表，其中的每一个元素是一个django.conf.urls.url实例.
3. Django 拿着HTTP请求，从所有已经获得的URLconf配置文件中，按顺序匹配每个正则表达式，并停止于第一个成功匹配，然后调用对应的视图。
4. 一旦匹配成功，Django给对应的视图传递如下参数：
   1. HttpRequest的一个实例
   2. 分组但未命名的正则表达式按照位置参数传入
   3. 分组且命名的正则表达式按照关键字参数传入
   4. url实例化时候附带的字典参数作为关键字传入,如果这个字典里有和分组且命名的正则表达式关键字参数重名的关键字,则会覆盖正则的参数.
5. 没有正则表达式匹配，或者如果在这个过程中的任意点抛出一个异常，Django会调用一个适当的错误处理视图。