Django源码之路由的本质(上)——逐步剖析底层执行流程

news/2024/6/19 5:58:16 标签: django, python, 后端

目录

1. 前言

2. 路由定义

3. 路由定义整体源码分析

3.1 partial实现path函数调用

3.2 图解_path函数

3.3 最终

4.URLPattern和Pattern的简单解析

5. 小结


1. 前言

在学习Django框架的时候,我们大多时候都只会使用如何去开发项目,对其实现流程并不是很清楚明了。

这篇文章的目的就是带你先从Django最基础的路由层开始剖析底层源码,一步一步带你学会,Django路由是如何来进行实现的,它的底层又是基于什么来完成的。

2. 路由定义

若你只想看源码解析,请直接跳过当前点

Django的路由定义是在urls.py里面的,我们通过两种形式来定义路由:

  • 普通路由定义:path方法

python">urlpatterns = [
    path('test/', views.test),
]

第一个参数:路径名

第二个参数:执行的视图函数

  • 正则路由定义:re_path方法

python">from django.urls import path, re_path

from app01 import views

urlpatterns = [
    re_path(r'login/(?P<name>\d{4})/', views.login),
]

第一个参数:路径+正则匹配

第二个参数:执行的视图函数

补充:

我在这里采用的有名分组,也就是将后面匹配到的参数传递给login函数,并且形参得跟路由定义的分组名一样

加上括号的原因:将匹配到的参数传递给视图函数,不加的话,就不会进行传递,只会进行匹配

  • 无名分组:没有名字的分组参数,将参数传递到函数,此时的形参可以任意名字:

python">urlpatterns = [
    re_path(r'login/(\d{4})/', views.login),
]

python">def login(request, vv):
    print(vv)
    return HttpResponse('code')

  • 有名分组:顾名思义,在进行正则匹配的时候,传递一个固定的参数名:

语法:?P<名字>

python">urlpatterns = [
    re_path(r'login/(?P<name>\d{4})/', views.login),
]

python">def login(request, name):
    print(name)
    return HttpResponse('code')

3. 路由定义整体源码分析

ok, 前面上点开胃菜,现在才开始正餐了。

从上面可以看出来,pathre_path已经帮我们都封装好了,我们只需要直接定义就好了,前面写匹配URL,后面写视图函数

那么此时,就会通过我们在网址栏输入的URL来进行相应视图函数的匹配

下面,我们来看path函数的内部实现

3.1 partial实现path函数调用

我们通过ctrl + 左键,点击path函数,可以进入到内部源码进行查看,如下:

path = partial(_path, Pattern=RoutePattern)

这里涉及到partial函数,大致说一下:

partial:可以实现在调用函数之前,固定一部分参数,并且返回一个新函数,

主要用于简化函数的调用,从而封装两个具有部分功能相同的函数,但部分不同的。提高了代码的可维护性和可读性。

用法

1. 参数一:原函数

2. 关键字参数:原函数的关键字参数,需要固定的一部分参数


可以从源码中,很好的体现这一点:

path = partial(_path, Pattern=RoutePattern)
re_path = partial(_path, Pattern=RegexPattern)

pathre_path的共同方法都是_path,都是采用相同的方式进行路由匹配的,但是不同的是他们匹配的方式是不一样的

path是普通的匹配,但是re_path是通过正则的形式来进行匹配的,所以我们通过提前固定好Pattern,来实现两个不同的匹配机制,这使得代码更有维护性,也更方便,只需要更改Pattern,就可以更换不同的匹配模式


当然,再写path的时候,我们所传递的参数,最终都会通过partial传递给_path

3.2 图解_path函数

我们先直接来看_path的整体

python">def _path(route, view, kwargs=None, name=None, Pattern=None):
    from django.views import View

    if kwargs is not None and not isinstance(kwargs, dict):
        raise TypeError(
            f"kwargs argument must be a dict, but got {kwargs.__class__.__name__}."
        )
    if isinstance(view, (list, tuple)):
        # For include(...) processing.
        pattern = Pattern(route, is_endpoint=False)
        urlconf_module, app_name, namespace = view
        return URLResolver(
            pattern,
            urlconf_module,
            kwargs,
            app_name=app_name,
            namespace=namespace,
        )
    elif callable(view):
        pattern = Pattern(route, name=name, is_endpoint=True)
        return URLPattern(pattern, view, kwargs, name)
    elif isinstance(view, View):
        view_cls_name = view.__class__.__name__
        raise TypeError(
            f"view must be a callable, pass {view_cls_name}.as_view(), not "
            f"{view_cls_name}()."
        )
    else:
        raise TypeError(
            "view must be a callable or a list/tuple in the case of include()."
        )

直接上图(通过代码 + 图解一步一步分析):

当然,里面有很多其实是不需要的,对于我们现在

我们逐步来进行分析并且删除:

  • 第一步

直接看黑色的圈起来的部分,这部分是判断传递进来的是否有kwargs这个额外参数,目前是用不上的,可以直接剔除

  • 第二步

这一部分可以看到,这里的isinstance是用于判断view是否是列表或者元组

回到开始,我们传递进来的path参数是一个视图函数 , 是一个函数,所以这部分也可以剔除

path('test/', views.test)
  • 第三步

callable 的作用是:判断当前是否为可执行的

函数,肯定是可执行的,所以会走这一层,那么下一层也不需要了

  • 最终

最终,我们获得目前的_path函数所需要的内容

python">def _path(route, view, kwargs=None, name=None, Pattern=None):
    from django.views import View

    pattern = Pattern(route, name=name, is_endpoint=True)
    return URLPattern(pattern, view, kwargs, name)

3.3 最终

可以看到哈,我们最终返回了一个

URLPattern(pattern, view, kwargs, name)

也就是URLPattern对象

URLPattern中,又封装了Pattern对象,而这个Pattern对象,其实就是最开始我们通过partial传递进来的匹配模式


所以,最终path函数就是这样的:

python">urlpatterns = [
    URLPattern(
        Pattern('test/', is_endpoint=True),
         views.test,
        )
]

本质上,就是一个URLPattern的对象

4.URLPattern和Pattern的简单解析

本质上,URLPatternPattern都是两个被封装好的类,一个是路由整体对象,一个是用于路由匹配的匹配模式对象,在这里很好的体现了面向对象的封装性,在后续维护中,我们也能很好的进行修改维护,比如我们需要再添加一个匹配模型,我们可以另外单独定义一个Pattern类,传递给_path,这样就可以使用我们自己的模式匹配了。

5. 小结

当然,本篇文章只是简单介绍了path的底层源码,并没有分析具体的匹配过程,但下一篇文章会继更新相关的匹配过程。

明白了path的底层本质,对于后面我们分析具体的匹配机制,会更加轻松。


 


http://www.niftyadmin.cn/n/5462901.html

相关文章

vue 视频添加水印

1.需求背景 其实腾讯云点播的api也支持视频水印&#xff0c;但是只有单个水印&#xff0c;大概效果是这样子的&#xff0c;不满足我们的需求&#xff0c;我们的需求是需要视频中都是水印。 腾讯云点播水印 项目需求的水印&#xff08;主要是防录屏,最后的实现效果是这样&…

汽车电子开发流程

汽车电子开发流程 一、IATF 16949介绍 随着汽车制造业的不断全球化&#xff0c;整车企业寻找供应商的范围也在不断扩大。为了降低成本&#xff0c;势必需要对这些质量管理体系予以统一。在这个大背景下&#xff0c;2002年国际汽车特别工作组和日本汽车制造商协会&#xff0c;…

LINUX查看有哪些消息队列

命令&#xff1a; $ ipcs -q------ Message Queues -------- key msqid owner perms used-bytes messages 0x00002db3 0 root 666 0 0注意2db3是十六进制

Mybatis添加数据后获取自增主键的ID

1、问题概述&#xff1f; 我们在使用mybatis或者mybatisplus向mysql数据库添加数据的时候&#xff0c;经常使用的id是自增主键&#xff0c;数据添加成功后&#xff0c;我们想使用这个id&#xff0c;这个时候我们就需要获取这个id。 如果你不会使用springboot整合mybatis框架&…

给web开发零基础小白的简明入门教程

1.网页三大件&#xff1a;HTML、CSS、JS HTML&#xff08;HyperText Markup Language超文本标记语言&#xff09;&#xff1a;构成网页的结构&#xff0c;结构由元素&#xff08;标签&#xff09;组成。 CSS&#xff08;Cascading Style Sheets层叠样式表&#xff09;&#xf…

深入解析语言模型:原理、实战与评估

引言 随着人工智能的飞速发展&#xff0c;语言模型作为自然语言处理&#xff08;NLP&#xff09;的核心技术之一&#xff0c;日益受到业界的广泛关注。本文旨在深入探讨语言模型的原理、实战应用以及评估方法&#xff0c;帮助读者更好地理解和应用这一技术。 一、语言模型原理…

基于uQRCode封装的前端二维码生成组件实践

在前端开发中&#xff0c;二维码生成已成为一种常见需求。二维码凭借其简洁、方便的特点&#xff0c;被广泛应用于产品推广、信息交互等多个场景。在此背景下&#xff0c;开发一个易于使用且性能优越的二维码生成组件变得至关重要。本文基于uQRCode封装了一个前端二维码生成组件…

DSSS-UQPSK学习笔记

文章目录 非平衡四相键控-直接序列扩频&#xff08;UQPSK-DSSS&#xff09;信号因其能同时传输两路不同功率、不同速率信号的特点&#xff0c;在需要图象和数据综合业务传输的领域得到了广泛应用。 系统信号的调制方式为非平衡四相键控&#xff08;Unbalanced Quadrature Phase…