路由层

路由层

一、路由的作用

路由即请求地址与视图函数的映射关系,如果把网站比喻为一本书,那路由就好比是这本书的目录,在Django中路由默认配置在urls.py中,如下图:

二、简单的路由配置

# urls.py 
from django.urls import re_path

# 由一条条映射关系组成的urlpatterns这个列表称之为路由表
urlpatterns = [
     re_path(regex, view, kwargs=None, name=None), 
]
# re_path参数介绍
#1、regex:正则表达式,专门用来匹配url地址(url地址中所有内容均被当作字符串)的路径部分,不考虑请求方法如GET、POST或者域名,例如:
  # 请求url地址为:https://www.example.com/myapp/,,正则表达式要匹配的部分是myapp/
  # 请求url地址为: https://www.example.com/myapp/?page=3, 正则表达式要匹配的部分是myapp/

  # 注意:
  # 1.1 django的url配置不会考虑请求方法,换句话说,对于相同的URL地址,所有的请求方法如POST、GET、HEAD等,都将被路由到相同的功能view上
  # 1.2 切记正则表达式开头无需加/
# 2、view:通常为一个视图函数,用来处理业务逻辑
# 3、kwargs:额外传递给视图函数的参数,可选(用法详见第三小节:分组)
# 4、name:为正则表达式匹配到的url地址起别名,可选(用法详见第五小节:反向解析)

案例:

urls.py文件

from django.contrib import admin
from django.urls import path, re_path # 导入re_path,关于path的使用我们在本章最后一小节介绍
from app01 import views # 导入模块views.py

urlpatterns = [
    path('admin/', admin.site.urls), # 由django自动生成该行代码,本质与re_path一样都只是一条匹配规则而已,只不过该规则的实现由django框架提供(对应的视图为admin.site.urls),在没有正式介绍该行代码作用之前,忽略即可,暂时注释掉也可以

    re_path(r'^index/$',views.index), # 新增一条
]
views.py文件
from django.shortcuts import render
from django.shortcuts import HttpResponse # 导入HttpResponse,用来生成响应信息

# 新增视图函数index
def index(request):
    return HttpResponse('index page...')
测试:
python manage.py runserver 8001 # 在浏览器输入:http://127.0.0.1:8001/index/ 会看到 index page...

注意事项

*# 注意一:
正则表达式不需要添加一个前导的反斜杠,因为每个URL都有。例如,应该是^index而不是 ^/index

# 注意二:
每个正则表达式前面的’r’ 是可选的但是建议加上

# 注意三:
如果我们想匹配的路径就只是index/,那么正则表达式应该有开始符与结束符, 如 ^index/$,这样逻辑才算严谨

# 注意四:
刚刚我们在浏览器输入:http://127.0.0.1:8001/index/,Django会拿着路径部分index/去路由表中自上而下匹配正则表达式,一旦匹配成功,则立即执行其后的视图函数,不会继续往下匹配,此处匹配成功的正则表达式是 r’^index/$’。

# 注意五:
但是我们在浏览器输入:http://127.0.0.1:8001/index,Django同样会拿着路径部分index去路由表中自上而下匹配正则表达式,貌似并不会匹配成功任何正则表达式( r’^index/$’匹配的是必须以 / 结尾,所以不会匹配成功index),但实际上仍然会看到结果 index page…,原因如下:

在配置文件settings.py中有一个参数APPEND_SLASH,该参数有两个值True或False

当APPEND_SLASH=True(如果配置文件中没有该配置,APPEND_SLASH的默认值为True),并且用户请求的url地址的路径部分不是以 / 结尾,例如请求的url地址是 http://127.0.0.1:8001/index,Django会拿着路径部分(即index)去路由表中匹配正则表达式,发现匹配不成功,那么Django会在路径后加 / (即index/)再去路由表中匹配,如果匹配失败则会返回路径未找到,如果匹配成功,则会返回重定向信息给浏览器,要求浏览器重新向 http://127.0.0.1:8001/index/地址发送请求

当APPEND_SLASH=False时,则不会执行上述过程,即一旦url地址的路径部分匹配失败就立即返回路径未找到,不会做任何的附加操作

注意: 在输入一次url地址后,浏览器会将其记录到缓存中,若第二次输入相同的url地址,浏览器也会直接在url地址后填充/结尾,如果想规避浏览器缓存的影响,可以像下面这么测试,并且每次测试都换一下?后的变量,保证url地址每次都不同
http://127.0.0.1:8000/index?aaaaa=111111 # 对应视图函数index1

http://127.0.0.1:8000/index/?aaaaa=22222 # 对应视图函数index2*

了解知识:

# django1.x中有一个函数url与Django2.x中的re_path一样,可以查看一下源码如下
'''
from django.conf.urls import url
...
def url(regex, view, kwargs=None, name=None):
    return re_path(regex, view, kwargs, name)
'''

from django.urls import re_path # django2.x中的re_path
from django.conf.urls import url # 在django2.x中同样可以导入1.x中的url

urlpatterns = [
    # 用法完全一致
    url(r'^index/$', views.index),
    re_path(r'^home/$', views.home),
]

django2.x还有一个path,它的用法牵扯到其他知识,所以我们将其放在最后介绍

三、分组

什么是分组、为何要分组呢?比如我们开发了一个博客系统,当我们需要根据文章的id查看指定文章时,浏览器在发送请求时需要向后台传递参数(文章的id号),可以使用 http://127.0.0.1:8001/article/?id=3,也可以直接将参数放到路径中http://127.0.0.1:8001/article/3/

针对后一种方式Django就需要直接从路径中取出参数,这就用到了正则表达式的分组功能了,分组分为两种:普通分组与命名分组

1、普通分组

urls.py文件
from django.contrib import admin
from django.urls import path,re_path
from app01 import views

urlpatterns = [
    path('admin/', admin.site.urls),

    # 下述正则表达式会匹配url地址的路径部分为:article/数字/,匹配成功的分组部分会以位置参数的形式传给视图函数,有几个分组就传几个位置参数
    re_path(r'^article/(\d+)/$',views.article), 
]
views.py文件
from django.shortcuts import render
from django.shortcuts import HttpResponse

# 需要额外增加一个形参用于接收传递过来的分组数据
def article(request,article_id):
    return HttpResponse('id为 %s 的文章内容...' %article_id)
测试:
python manage.py runserver 8001 # 在浏览器输入:http://127.0.0.1:8001/article/3/ 会看到: id为 3 的文章内容...

2、命名分组

当我们对分组命名后,就会按照key=value的关键字参数形式为视图函数传参

urls.py文件

from django.contrib import admin
from django.urls import path,re_path
from app01 import views

urlpatterns = [
    path('admin/', admin.site.urls),

    # 该正则会匹配url地址的路径部分为:article/数字/,匹配成功的分组部分会以关键字参数(article_id=匹配成功的数字)的形式传给视图函数,有几个有名分组就会传几个关键字参数,需要强调一点是:视图函数得到的值均为字符串类型
    re_path(r'^article/(?P<article_id>\d+)/$',views.article), 
]

views.py文件

from django.shortcuts import render
from django.shortcuts import HttpResponse

# 需要额外增加一个形参,形参名必须为article_id
def article(request,article_id):
    return HttpResponse('id为 %s 的文章内容...' %article_id)

测试:

python manage.py runserver 8001 # 在浏览器输入:http://127.0.0.1:8001/article/3/ 会看到: id为 3 的文章内容...

总结

普通分组和命名分组都是为了获取路径中的参数,并传递给视图函数,区别在于普通分组是以位置参数的形式传递,命名分组是以关键字参数的形式传递。

强调

普通分组和有名分组不要混合使用

3、指定默认值

# urls.py中
from django.urls import re_path 
from app01 import views

urlpatterns = [
    re_path(r'^article/$', views.article), # 第一条
    re_path(r'^article/(?P<article_id>\d+)/$',views.article), # 第二条
]

# views.py中,可以为num指定默认值
from django.shortcuts import HttpResponse

def article(request, article_id="1"):
    return HttpResponse('id为 %s 的文章内容...' %article_id)

为视图函数article指定默认参数article_id="1"后,urlpattrens中的两条匹配规则就可以共用一个视图函数了,具体分析如下:
当url为:http://127.0.0.1:8080/article/时,匹配成功第一条
当url为:http://127.0.0.1:8080/article/111/时,匹配成功第二条

4、re_path的参数kwargs

如果我们想额外给视图函数传递参数,就用到了kwargs参数,该参数要求传入一个字典,会按照key=value的形式为视图函数额外传递参数,我们通常用kwargs中的参数来为多个共用一个视图函数的re_path做标记

# urls.py中
from django.contrib import admin
from django.urls import path,re_path
from app01 import views

urlpatterns = [
    path('admin/', admin.site.urls),

    re_path(r'^user/([a-zA-Z]+)/$', article,kwargs={'tag': 1}),  # 第一条
    re_path(r'^user/(\d{4})/$',     article,kwargs={'tag':2}),  # 第二条
    re_path(r'^user/(\d{2})/$',     article,kwargs={'tag':3}),  # 第三条
]

# views.py中,可以为num指定默认值
def article(request, x,tag): # 通过tag的值即可判定是来自于匹配了不同的url
    if tag == 1:
        print('name is %s' %x)
    elif tag == 2:
        print('year is %s' %x)
    elif tag == 3:
        print('mon is %s' %x)
    return HttpResponse('ok')

# 输入url地址依次测试即可
http://127.0.0.1:8080/user/egon/
http://127.0.0.1:8002/user/1995/
http://127.0.0.1:8002/user/12/

注意:如果命名分组的名字与额外参数的key相同了,视图函数最终会获取额外参数中的值,所以应该尽量避免出现这种情况

# urls.py中
urlpatterns = [    
    re_path(r'^user/(?P<xxx>\w+)/$', test,kwargs={'xxx':111})
]
# views.py中, xxx的值始终为111
def test(request,xxx):
    print(xxx)
    return HttpResponse('ok')

四、路由分发

随着项目功能的增加,app会越来越多,路由也越来越多,每个app都会有属于自己的路由,如果再将所有的路由都放到一张路由表中,会导致结构不清晰,不便于管理,所以我们应该将app自己的路由交由自己管理,然后在总路由表中做分发,具体做法如下

1 创建两个app

# 新建项目mystie2
E:\git>django-admin startproject mysite2
# 切换到项目目录下
E:\git>cd mysite2
# 创建app01和app02
E:\git\mysite2>python3 manage.py startapp app01
E:\git\mysite2>python3 manage.py startapp app02 

2在每个app下手动创建urls.py来存放自己的路由,如下:

app01下的urls.py文件

from django.urls import re_path
# 导入app01的views
from app01 import views

urlpatterns = [
    re_path(r'^index/$',views.index), 
]

app01下的views.py

111

暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇
下一篇

You cannot copy content of this page