Django框架-路由层

Posted 2022-11-08 dcentman

Django框架-路由层

一、URL配置（URLconf）

1、基本格式

from django.conf.urls import url
urlpatterns = [
     url(正则表达式, views视图函数，参数，别名),
]

2、参数说明

• 正则表达式：一个正则表达式字符串
• views视图函数：一个可调用对象，通常为一个视图函数或一个指定视图函数路径的字符串
• 参数：可选的要传递给视图函数的默认参数（字典形式）
• 别名：一个可选的name参数

二、关于正则表达式（来自官方文档）

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

urlpatterns = [
    url(r'^articles/2003/$', views.special_case_2003),
    url(r'^articles/([0-9]4)/$', views.year_archive),
    url(r'^articles/([0-9]4)/([0-9]2)/$', views.month_archive),
    url(r'^articles/([0-9]4)/([0-9]2)/([0-9]+)/$', views.article_detail),
]

注意事项：

• urlpatterns中的元素按照书写顺序从上往下逐一匹配正则表达式，一旦匹配成功则不再继续
• 若要从URL中捕获一个值，只需要在它周围放置一对圆括号（分组匹配）
• 不需要添加一个前导的反斜杠，因为每个URL 都有，例如，应该是^articles 而不是^/articles
• 每个正则表达式前面的‘r‘ 是可选的但是建议加上

示例请求：

• 请求/articles/2005/03/与列表中的第三个条目匹配。Django会调用该函数 。views.month_archive(request, ‘2005‘, ‘03‘)
• /articles/2005/3/ 不匹配任何URL模式，因为列表中的第三个条目需要两个数字。
• /articles/2003/将匹配列表中的第一个模式，而不是第二个模式，因为模式是按顺序测试的，第一个是第一个要通过的测试。请随意使用命令插入这样的特殊情况(百度翻译比较生硬)。在这里，Django会调用该函数 views.special_case_2003(request)
• /articles/2003 不匹配任何这些模式，因为每个模式都要求URL以斜杠结尾。
• /articles/2003/03/03/将匹配最终模式。Django会调用该函数。views.article_detail(request, ‘2003‘, ‘03‘, ‘03‘)

三、关于APPEND_SLASH

定义：是否开启URL访问地址后面不为/跳转至带有/的路径的配置项

Django settings.py配置文件中默认没有 APPEND_SLASH 这个参数，但 Django 默认这个参数为 APPEND_SLASH = True。 其作用就是自动在网址结尾加‘/‘。

URLconf如下：

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

urlpatterns = [
    url(r'^login/$', views.login),
]

当没有写 APPEND_SLASH这个参数时（即默认的APPEND_SLASH = True），在地址栏中输入‘login‘：

发现：返回的页面的URL加上了‘/‘，并且客户端进行了两次请求，第一次以‘login‘匹配，没有匹配上，返回301，第二次以‘login/‘匹配才匹配上。

而在地址栏中输入‘test‘：

却发现直接返回404。结合URLconf，不难发现，在APPEND_SLASH = True的情况下，如果客户端发给服务端的URL没有以/结尾，但是该URL加上/后是在URLconf中的，则会返回301，让客户端将该URL加上/后重新发送请求；但是该URL加上/后依然没有在URLconf中，则会直接返回404。

当在settings.py配置文件中指定APPEND_SLASH = False时，我们在地址栏中输入‘login‘：

发现页面直接返回404，严格按照URLconf中的配置进行匹配。

四、分组匹配

1、无名分组

# urls.py
url(r'^test/([0-9]4)/',views,test)
# 路由匹配的时候，会将括号内正则表达式匹配到的内容，当做位置参数传递给视图函数

# views.py
def test(request,number):
    pass

2、有名分组

# urls.py
url(r'^test/(?P<year>\\d+)/',views,test)
# 路由匹配的时候，会将括号内正则表达式匹配到的内容，当做关键字参数year=xxx传递给视图函数

# views.py
def test(request,year):  # 第二个参数必须是year
    pass

3、使用

# 无名有名不能混合使用 !!!
    url(r'^test/(\\d+)/(?P<year>\\d+)/', views.test)

# 但是用一种分组下 可以使用多个
        # 无名分组支持多个
        # url(r'^test/(\\d+)/(\\d+)/', views.test),
        # 有名分组支持多个
        # url(r'^test/(?P<year>\\d+)/(?P<xx>\\d+)/', views.test),

五、URLconf匹配的位置

URLconf 在请求的URL 上查找，将它当做一个普通的Python 字符串。不包括GET和POST参数以及域名。

例如，http://www.example.com/myapp/请求中，URLconf 将查找myapp/。

在http://www.example.com/myapp/?page=3 请求中，URLconf 仍将查找myapp/。

URLconf 不检查请求的方法。换句话讲，所有的请求方法 —— 同一个URL的POST、GET、HEAD等等 —— 都将路由到相同的函数。

六、捕获的参数永远都是字符串

每个在URLconf中捕获的参数都作为一个普通的Python字符串传递给视图，无论正则表达式使用的是什么匹配方式。例如，下面这行URLconf 中：

url(r'^articles/(?P<year>[0-9]4)/$', views.year_archive)

传递到视图函数views.year_archive() 中的year 参数永远是一个字符串类型。

七、视图函数中指定默认值

# 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),
]

# views.py中，可以为num指定默认值
def page(request, num="1"):
    pass

在上面的例子中，两个URL模式指向相同的view - views.page - 但是第一个模式并没有从URL中捕获任何东西。

如果第一个模式匹配上了，page()函数将使用其默认参数num=“1”,如果第二个模式匹配，page()将使用正则表达式捕获到的num值。

八、URL反向解析

在使用Django 项目时，一个常见的需求是获得URL的最终形式，以用于嵌入到生成的内容中（视图中和显示给用户的URL等）或者用于处理服务器端的导航（重定向等）。
人们强烈希望不要硬编码这些URL（费力、不可扩展且容易产生错误）或者设计一种与URLconf 毫不相关的专门的URL 生成机制，因为这样容易导致一定程度上产生过期的URL。
换句话讲，需要的是一个DRY 机制。除了其它有点，它还允许设计的URL 可以自动更新而不用遍历项目的源代码来搜索并替换过期的URL。
获取一个URL 最开始想到的信息是处理它视图的标识（例如名字），查找正确的URL 的其它必要的信息有视图参数的类型（位置参数、关键字参数）和值。
Django 提供一个办法是让URL 映射是URL 设计唯一的地方。你填充你的URLconf，然后可以双向使用它：

• 根据用户/浏览器发起的URL 请求，它调用正确的Django 视图，并从URL 中提取它的参数需要的值。
• 根据Django 视图的标识和将要传递给它的参数的值，获取与之关联的URL。

第一种方式是我们在前面的章节中一直讨论的用法。第二种方式叫做反向解析URL、反向URL 匹配、反向URL 查询或者简单的URL 反查。
在需要URL 的地方，对于不同层级，Django 提供不同的工具用于URL 反查：

• 在模板中：使用url模板标签。
• 在Python 代码中：使用django.core.urlresolvers.reverse() 函数。
• 在更高层的与处理Django 模型实例相关的代码中：使用get_absolute_url() 方法。

上面说了一大堆，你可能并没有看懂。（那是官方文档的生硬翻译）。

咱们简单来说就是可以给我们的URL匹配规则起个名字，一个URL匹配模式起一个名字。

这样我们以后就不需要写死URL代码了，只需要通过名字来调用当前的URL。

举个简单的例子：

url(r'^home', views.home, name='home'),  # 给我的url匹配模式起名为 home
url(r'^index/(\\d*)', views.index, name='index'),  # 给我的url匹配模式起名为index

这样：

在模板里面可以这样引用：

% url 'home' %

在views函数中可以这样引用：

from django.urls import reverse

reverse("index", args=("2018", ))

例子：
考虑下面的URLconf：

from django.conf.urls import url

from . import views

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

根据这里的设计，某一年nnnn对应的归档的URL是/articles/nnnn/。

你可以在模板的代码中使用下面的方法获得它们：

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

<ul>
% for yearvar in year_list %
<li><a href="% url 'news-year-archive' yearvar %"> yearvar  Archive</a></li>
% endfor %
</ul>

在Python 代码中，这样使用：

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

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

如果出于某种原因决定按年归档文章发布的URL应该调整一下，那么你将只需要修改URLconf 中的内容。

在某些场景中，一个视图是通用的，所以在URL 和视图之间存在多对一的关系。对于这些情况，当反查URL 时，只有视图的名字还不够。

注意：

为了完成上面例子中的URL 反查，你将需要使用命名的URL 模式。URL 的名称使用的字符串可以包含任何你喜欢的字符。不只限制在合法的Python 名称。

当命名你的URL 模式时，请确保使用的名称不会与其它应用中名称冲突。如果你的URL 模式叫做comment，而另外一个应用中也有一个同样的名称，当你在模板中使用这个名称的时候不能保证将插入哪个URL。

在URL 名称中加上一个前缀，比如应用的名称，将减少冲突的可能。我们建议使用myapp-comment 而不是comment。

总结：

反向解析
    本质:其实就是给你返回一个能够返回对应url的地址
1.先给url和视图函数对应关系起别名
    url(r'^index/$',views.index,name='kkk')
2.反向解析
    后端反向解析
    后端可以在任意位置通过reverse反向解析出对应的url
    from django.shortcuts import reverse
        reverse('kkk')      
    前端反向解析
        % url 'kkk' %
        
无名分组反向解析
    url(r'^index/(\\d+)/$',views.index,name='kkk')
    后端反向解析
        reverse('kkk',args=(1,))  # 元组传参，一个参数要加逗号，后面的数字通常都是数据的id值
    前端反向解析
        % url 'kkk' 1%   # 后面的数字通常都是数据的id值

有名分组反向解析
    同无名分组反向解析意义的用法
    url(r'^index/(?P<year>\\d+)/$',views.index,name='kkk')
    后端方向解析
        print(reverse('kkk',args=(1,)))  # 推荐你使用上面这种  减少你的脑容量消耗
        print(reverse('kkk',kwargs='year':1))
    前端反向解析  
        <a href="% url 'kkk' 1 %">1</a>  # 推荐你使用上面这种  减少你的脑容量消耗
        <a href="% url 'kkk' year=1 %">1</a>

注意:在同一个应用下 别名千万不能重复!!!

九、路由分发

? 当你的django项目特别庞大的时候，路由与视图函数对应关系特别特别多，那么你的总路由urls.py代码太过冗长，不易维护

? 每一个应用都可以有自己的urls.py,static文件夹,templates文件夹

? 正是基于上述条件，可以实现多人分组开发，等多人开发完成之后 我们只需要创建一个空的django项目，然后将多人开发的app全部注册进来，在总路由实现一个路由分发，而不再做路由匹配(来了之后 我只给你分发到对应的app中)

? 当你的应用下的视图函数特别特别多的时候，你可以建一个views文件夹，里面根据功能的细分再建不同的py文件。

# 方式一
from django.conf.urls import url
from app01 import urls as app01_urls
from app02 import urls as app02_urls
urlpatterns = [
            url(r'^admin/', admin.site.urls),
            url(r'^app01/',include(app01_urls)),
            url(r'^app02/',include(app02_urls)),
        ]

# 方式二
from django.conf.urls import url
urlpatterns = [
            url(r'^admin/', admin.site.urls),
            url(r'^app01/',include('app01.urls')),
            url(r'^app02/',include('app02.urls')),
        ]
# 以字符串代替模块，少了导入模块这一步，并且Django会提示

注意：总路由中，一级路由的后面千万不要加$符号

十、名称空间(了解)

# 多个app起了相同的别名 这个时候用反向解析 并不会自动识别应用前缀
# 如果想避免这种问题的发生
# 方式1:
    # 总路由
        url(r'^app01/',include('app01.urls',namespace='app01'))
        url(r'^app02/',include('app02.urls',namespace='app02'))
    # 后端解析的时候
        reverse('app01:index')
        reverse('app02:index')
    # 前端解析的时候
        % url 'app01:index' %
        % url 'app02:index' %
    # 方式2:
    # 起别名的时候不要冲突即可  一般情况下在起别名的时候通常建议以应用名作为前缀
        name = 'app01_index'
        name = 'app02_index'

十一、伪静态

静态网页:数据是写死的，万年不变

伪静态网页的设计是为了增加百度等搜索引擎seo查询力度

所有的搜索引擎其实都是一个巨大的爬虫程序

网站优化相关 通过伪静态确实可以提高你的网站被查询出来的概率

但是再怎么优化也抵不过RMB玩家

实现：人工在路由上加.html

十二、虚拟环境

? 一般情况下，我们会给每一个项目配备该项目所需要的模块，不需要的一概不装，虚拟环境，就类似于为每个项目量身定做的解释器环境

1、创建虚拟环境

2、使用虚拟环境创建项目

3、新建的虚拟环境是纯净的，只有自带的两个模块pip和setuptools

4、使用虚拟环境创建的项目的标志

十三、django1.X跟django2.X版本区别

1、路由层1.X用的是url，而2.X用的是path

2、2.X中的path第一个参数不再是正则表达式，而是写什么就匹配什么，是精准匹配

当你使用2.X不习惯的时候，2.X还有一个叫re_path，2.x中的re_path就是你1.X的url

3、1.0版本的url和2.0版本的re_path分组出来的数据都是字符串类型

4、虽然2.X中path不支持正则表达式 但是它提供了五种默认的转换器

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

path('index/<int:id>/',index)  # 会将id匹配到的内容自动转换成整型

5、除此之外它还支持自定义转换器

class FourDigitYearConverter:  
    regex = '[0-9]4'  
    def to_python(self, value):  
        return int(value)  
    def to_url(self, value):  
        return '%04d' % value  # 占四位，不够用0填满，超了则就按超了的位数来！
register_converter(FourDigitYearConverter, 'yyyy')  

urlpatterns = [  
    path('articles/2003/', views.special_case_2003),  
    path('articles/<yyyy:year>/', views.year_archive),  
    ...  
]