django之路由分发

路由分发决定哪一个路由由哪一个视图函数来处理。

注意：django2.0里的re_path和django1.0里的url除了名字不一样，其他都一样。

简单配置

from django.urls import path,re_path

from app01 import views
urlpatterns = [
    path(\'admin/\', admin.site.urls),
    path(\'timer/\',views.timer),


    # 路由配置:  决定哪一个路由由哪一个视图函数来处理
    # repath和django1.0里的url用法一样
    # 不写^，articles前面可以写任何东西(edward/123/articles)；同理，不写$，2003后面也可以写任何东西。
    re_path(r\'^articles/2003/$\',views.special_case_2003),

    # 正则匹配年份
    # 如果是2003，会匹配第一个
    # 如果去掉$就不走第三个了，因为匹配到年份那就不往后匹配了，而是直接执行arvhive_year了。
    re_path(r\'^articles/([0-9]{4})/$\',views.archive_year), # year_archive(request,1999)。django2.1.5不用传第二个参数了

    re_path(r\'^articles/([0-9]{4})/([0-9]{2})/$\',views.month_archive),

    # re_path(r\'^articles/(?P[0-9]{4})/(?P[0-9]{2})/(?P[0-9]{2})/$\', views.article_detail),
]

注意：

若要从URL 中捕获一个值，只需要在它周围放置一对圆括号。
不需要添加一个前导的反斜杠，因为每个URL 都有。例如，应该是^articles 而不是 ^/articles。
每个正则表达式前面的\'r\' 是可选的但是建议加上。它告诉Python 这个字符串是“原始的” —— 字符串中任何字符都不应该转义

有名分组

# urls
    # 有名分组,?P相当于是起了个名字，然后把名字当做参数传给视图函数，后面才是正则部分。
    re_path(r\'^articles/(?P[0-9]{4})/(?P[0-9]{2})/$\',views.month_archive),
   \'\'\'
   month_archive(request,year=2009,momth=12)  
   这样在views视图，不管传入的参数的顺序是什么，year就是year，month就是month，但是名字必须是year和month
   \'\'\'

#views
def month_archive(request, month,year):  # 顺序颠倒也没有问题，不管顺序是什么都会正常显示year和month
    return HttpResponse(\'year:%s,month:%s\' % (year,month))

路由分发

在app01下面重新创建一个urls的文件，把关于app01的url放到里面，然后再在公共项目的urls里导入app01的urls

# app01 urls.py
from django.urls import path, re_path

from app01 import views

urlpatterns = [。
    re_path(r\'^articles/2003/$\', views.special_case_2003),
    re_path(r\'^articles/([0-9]{4})/$\', views.archive_year),  # year_archive(request,1999)。
    re_path(r\'^articles/(?P[0-9]{4})/(?P[0-9]{2})/$\', views.month_archive),
]

# demo urls.py
urlpatterns = [
    path(\'admin/\', admin.site.urls),
    path(\'timer/\', views.timer),

    # 分发：
    re_path(r\'^app01\', include(\'app01.urls\')),   
    # re_path(r\'^\', include(\'app01.urls\')   #  路径里面不用写app01了
]

反向解析

反向解析就是给url起一个别名，我们用别名去找这个url就行，这样不管url如何改变，我们都可以用别名找到它。

1. 在模板中进行反向解析

urls.py

from django.urls import path, re_path, include

from app01 import views

urlpatterns = [
    path(\'admin/\', admin.site.urls),
    path(\'timer/\', views.timer),
    path(\'login.html/\',views.login,name=\'Log\'),

    # 分发：
    re_path(r\'^\', include(\'app01.urls\')),
]

DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Logintitle>
head>
<body>


<form action="{% url \'Log\' %}" method="post">
    用户名 <input type="text" name="user">
    密码 <input type="password" name="pwd">
    <input type="submit">
form>

body>
html>

2. 在视图函数里进行反向解析

# app01 urls

re_path(r\'^articles/2003/$\', views.special_case_2003,name =\'s_c_2003\'),
re_path(r\'^articles/([0-9]{4})/$\', views.archive_year,name=\'y_a\'),

from django.urls import reverse
def special_case_2003(request):
    url = reverse(\'s_c_2003\')  #  不需要参数，因为不含正则是一个完整的url，找到后直接匹配
    url2 = reverse(\'y_a\',args=(4009,))   #  ^articles/([0-9]{4})/ 需要给一个四位数字的参数，匹配正则，参数可以是任意四位数字，具体数字按需求写。
    print(url)  # /articles/2003/
    print(url2)  # /articles/4009/
    return HttpResponse("special_case_2003")  # HttpResponse里面写的是响应体的内容

命名空间

主项目 urls.py

from django.urls import path, re_path, include

from app01 import views

urlpatterns = [
    path(\'admin/\', admin.site.urls),
    path(\'timer/\', views.timer),
    path(\'login.html/\', views.login, name=\'Log\'),

    # 分发：
    # 命名空间不可以重名
    re_path(r\'^app01\', include((\'app01.urls\', \'app01\'))),
    re_path(r\'^app02\', include((\'app02.urls\', \'app02\'))),
]

app01

 # urls
re_path(\'index/\',views.index,name=\'index\')

# views
def index(request):


    # return HttpResponse(reverse(\'index\'))  # 找到的也是app02的index,用名称空间解决这个问题。

    # 用命名空间解决
    return HttpResponse(reverse(\'app01:index\')) # # 冒号之前是namespace，冒号之后是名字

app02

# urls
re_path(\'index/\',views.index,name=\'index\')

# views
def index(request):

    # return HttpResponse(reverse(\'index\'))  # 找到的app02的index,用命名空间解决名字冲突的问题

    return HttpResponse(reverse(\'app02:index\'))

path方法(django2.0)

re_path有两个问题：

1.不能进行字符转换。

def month_archive(request, month, year):
    print(type(month))  # str
    print(type(year))  # str
    return HttpResponse(\'year:%s,month:%s\' % (year, month))

2.同样的正则表达式，需要写多遍，不易于维护。

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

而path可以解决这两个问题

# urls
from django.urls import path
path(\'articles/\',views.path_year)

#views
def path_year(request,year):
    print(type(year))   # int
    return HttpResponse(\'path year\')

基本规则：

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

path转换器

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

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

自定义path转换器

在实际开发中，django自带的转换器是不能满足我们的需求的，这就需要自定义转换器了

操作步骤：

1.在app里创建一个类，写自定义转换的规则

url_convert.py

class MonConvert:
    regex = "[0-9]{2}"   # 只能叫regex

    def to_python(self, value):
        return int(value)  #  不转化就是字符串，可以根据需求做任何操作。

    def to_url(self, value):  # 用于反向解析
        return "%04d" % value

2.在urls里注册自定义转换器

from django.urls import path, re_path, include,register_converter
from app01.url_convert import MonConvert

# 注册自定义转换器
register_converter(MonConvert,\'mm\')

3.在路由分发里使用自定义转换器

urlpatterns = [
    path(\'articles/\',views.path_month),
]

Registering custom path converters¶

For more complex matching requirements, you can define your own path converters.

A converter is a class that includes the following:

A regex class attribute, as a string.
A to_python(self, value) method, which handles converting the matched string into the type that should be passed to the view function. It should raise ValueError if it can’t convert the given value.
A to_url(self, value) method, which handles converting the Python type into a string to be used in the URL.