三、路由控制器

三、路由控制器

Route路由是一种映射关系！路由是把客户端强求的URL路径和用户请求的应用程序[这里指的是Django里面的视图进行映射的一种关系]。

请求路径和视图函数不是一对一映射关系！

from django.contrib import admin
from django.urls import path
from django.shortcuts import HttpResponse
from app01.views import get_timer,index

urlpatterns = [
    # 请求路劲和视图函数的映射关系，一旦请求路径和某一个path中的路劲匹配成功，则调用该path中的视图函数
    path('admin/', admin.site.urls),
    # 多对一映射
    path("timer/", get_timer),
    path("", get_timer),
    path("timer/", get_timer),  # get_timer(requests)
    path("timer/", index),  # index(requests)
]

在django中所有的路由最终都被保存到一个变量 urlpatterns., urlpatterns必须声明在主应用下的urls.py总路由中。这是由配置文件settings设置的。

在django运行中，当客户端发送了一个http请求到服务端，服务端的web服务器则会从http协议中提取url地址, 从程序内部找到项目中添加到urlpatterns里面的所有路由信息的url进行遍历匹配。如果相等或者匹配成功，则调用当前url对象的视图方法。

在给urlpatterns路由列表添加路由的过程中,django一共提供了2个函数给开发者注册路由.

from django.urls import path # 字符串路由
from django.urls import re_path # 正则路由，会把URL地址看成一个正则模式与客户端的请求URL地址进行正则匹配

# path和re_path 使用参数一致，紧紧在url参数和接收参数时写法不一致

（1）基本使用

urls.py

urlpatterns = [
    # 请求路劲和视图函数的映射关系，一旦请求路径和某一个path中的路劲匹配成功，则调用该path中的视图函数
    path('admin/', admin.site.urls),
    # 多对一映射
    path("timer/", get_timer),
    path("", get_timer),
    # path("timer/", get_timer),  # get_timer(requests)
    # path("timer/", index),  # index(requests)
    # path("articles/2012/12/12/", article_detail),
    # 正则和简单分组
    re_path("articles/(\d{4})$", article_archive_by_year),
    # re_path("articles/(\d{4})/(\d{1,2})", article_archive_by_month),
    # 有名分组
    re_path("articles/(?P<year>\d{4})/(?P<month>\d{1,2})", article_archive_by_month),
]
"""
请求路径：/articles/2021/12
re.findall("articles/(\d{4})/(\d{1,2})","/articles/2010/12")
一旦匹配成功：调用article_archive_by_month(reques,2010,12)
    if 是简单分组:
        调用article_archive_by_year(request,2010,12)
    else if 是有名分组:
        调用article_archive_by_year(request,year=2010,mouth=12)    
"""

（2）路由分发

1. Import the include() function: from django.urls import include, path
2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))

（3）路由转发器

有时候上面的内置的url转换器并不能满足我们的需求，因此django给我们提供了一个接口可以让我们自己定义自己的url转换器。

# 注册转换器
from django.urls import register_converter
from django.shortcuts import HttpResponse
# 自定义路由转换器
class MobileConverter(object):
    regex = "1[3-9]\d{9}"
    def to_python(self,value):
        print(type(value))
        # 将匹配结果传递到视图内部时使用
        # 返回str还是int主要看需求,纯数字的可以返回int
        return value

    def to_url(self,value):
        # 将匹配结果用于反向解析传值时使用
        return value
    
# register_converter(路由转换器的类名,调用别名)
register_converter(MobileConverter,"mobile")

path("index/<mobile:mobile>",index)

def index(request,mobile):
    print(":::",type(mobile))
    return HttpResponse(f"hi,{mobile}用户")

（4）反向解析

在使用Django 项目时，一个常见的需求是获得URL 的最终形式，以用于嵌入到生成的内容中（视图中和显示给用户的URL等）或者用于处理服务器端的导航（重定向等）。人们强烈希望不要硬编码这些URL（费力、不可扩展且容易产生错误）或者设计一种与URLconf 毫不相关的专门的URL 生成机制，因为这样容易导致一定程度上产生过期的URL。

在需要URL 的地方，对于不同层级，Django 提供不同的工具用于URL 反查：

• 在模板中：使用url模板标签
• 在Python 代码中：使用from django.urls import reverse 函数。

urls.py中为url设置别名参数：

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

urlpatterns = [
    #...
    url(r'^articles/([0-9]{4})/$', views.year_archive, name='news-year-archive'),
    #...
]

应用之在模板中反向解析:

<a href="{% url 'news-year-archive' 2012 %}">2012 Archive</a>
<a href="/articles/2012/">2012 Archive</a>

应用之在py文本中反向解析:

from django.shortcuts import redirect
from django.urls import reverse

def redirect_to_year(request):
    year = 2006
    reverse_path=reverse('news-year-archive', args=(year,))
    return redirect(reverse_path)  # 等效 redirect("/articles/2006/")