Django的路由层(URLconf)
URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表;你就是以这种方式告诉Django,对于客户端发来的某个URL调用哪一段逻辑代码对应执行。
urlpatterns = [ url(正则表达式, views视图函数,参数,别名), ]
参数说明:
- 一个正则表达式字符串
- 一个可调用对象,通常为一个视图函数或一个指定视图函数路径的字符串
- 可选的要传递给视图函数的默认参数(字典形式)
- 一个可选的别名(name)参数
view:
当正则表达式匹配到某个条目时,自动将封装的HttpRequest对象作为第一个参数,正则表达式“捕获”到的值作为第二个参数,传递给该条目指定的视图。
如果是简单捕获,那么捕获值将作为一个位置参数进行传递,如果是命名捕获,那么将作为关键字参数进行传递。
kwargs:
任意数量的关键字参数可以作为一个字典传递给目标视图。
name:
对你的URL进行命名,可以让你能够在Django的任意处,尤其是模板内显式地引用它。相当于给URL取了个全局变量名,你只需要修改这个全局变量的值,
在整个Django中引用它的地方也将同样获得改变。这是极为古老、朴素和有用的设计思想,而且这种思想无处不在。
一、简单的路由配置
1、在/first_pro/first_pro/urls.py中进行路由配置
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), path('login/', views.login), # 路由配置: 路径--------->视图函数 # 正则匹配:r'^articles/2003/$' 以articles/2003/开头且以articles/2003/结尾 re_path(r'^articles/2003/$', views.special_case_2003), # special_case_2003(request) # 正则匹配四位的任意数字,多对一 re_path(r'^articles/(/[0-9]{4})/$', views.year_archive), # year_archive(request,1999) # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive), # month_archive(request,2009,12) # 改写为有名分组 re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive) # month_archive(request,y=2009,m=12) # ([0-9]+):匹配前面的数字一次或无限次作为详情 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail)
]
注意:
-
若要从URL中捕获一个值,值需要在它周围放置一对圆括号。
-
不需要添加一个前导的反斜杠,因为每个URL都有。例如,应该是^articles而不是^/articles。
-
每个正则表达式前面的'r'是可选的但是建议加上。它告诉python这个字符串是“原始的”—— 字符串中任何字符都不应该转义
2、/first_pro/app01/views.py编写对应的视图函数
from django.shortcuts import render,HttpResponse def timer(request): import time ctime = time.strftime('%Y-%m-%d %H:%M:%S') # 2018-06-30 05:48:11 """ render方法: 1、帮忙找到timer.html取出里面的数据; 2、按照固定的语法({})把变量嵌套到html文件中 """ return render(request, 'timer.html', {"date":ctime}) # 使用render方法,返回一个页面 def special_case_2003(request): return HttpResponse("special_case_2003") # HttpResponse:响应对象 def year_archive(request,year): return HttpResponse(year) def month_archive(request,y,m): return HttpResponse(y+"-"+m)
3、访问调用示例
''' 一些请求的例子: /articles/2005/03/ 请求将匹配列表中的第三个模式。Django 将调用函数views.month_archive(request, '2005', '03')。 /articles/2005/3/ 不匹配任何URL 模式,因为列表中的第三个模式要求月份应该是两个数字。 /articles/2003/ 将匹配列表中的第一个模式不是第二个,因为模式按顺序匹配,第一个会首先测试是否匹配。请像这样自由插入一些特殊的情况来探测匹配的次序。 /articles/2003 不匹配任何一个模式,因为每个模式要求URL 以一个反斜线结尾。 /articles/2003/03/03/ 将匹配最后一个模式。Django 将调用函数views.article_detail(request, '2003', '03', '03')。 '''
4、设置项是否开启URL访问地址后面不为/ 跳转至带有/的路径
APPEND_SLASH=True
二、有名分组(named group)
上面的示例使用简单的、没有命名的正则表达式组(通过圆括号)来捕获URL 中的值并以位置 参数传递给视图。在更高级的用法中,可以使用命名的正则表达式组来捕获URL 中的值并以关键字 参数传递给视图。
在Python 正则表达式中,命名正则表达式组的语法是(?Ppattern),其中name 是组的名称,pattern 是要匹配的模式。 下面是以上URLconf 使用命名组的重写:
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/(?P<year>[0-9]{4})/$', views.year_archive), re_path(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive), re_path(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail), ]
这个实现与前面的示例完全相同,只有一个细微的差别:捕获的值作为关键字参数而不是位置参数传递给视图函数。例如视图函数month_archive:
def month_archive(request,year,month): return HttpResponse(year+"-"+month)
url访问调用效果如下:
/articles/2005/03/ 请求将调用views.month_archive(request, year='2005', month='03')函数,而不是views.month_archive(request, '2005', '03')。 /articles/2003/03/03/ 请求将调用函数views.article_detail(request, year='2003', month='03', day='03')
在实际应用中,这意味你的URLconf 会更加明晰且不容易产生参数顺序问题的错误 —— 你可以在你的视图函数定义中重新安排参数的顺序。当然,这些好处是以简洁为代价;有些开发人员认为命名组语法丑陋而繁琐。
三、应用include函数实现分发
为了实现路由解耦,创建/first_pro/app01/urls.py文件。将/first_pro/first_pro/urls.py中关于app01的路由配置注释。
1、应用include函数设置/first_pro/app01/urls分发路径
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), path('login/', views.login), #分发: # re_path(r"app01/", include("app01.urls")) # 改写如下:不用app01 re_path(r"^", include("app01.urls")) ]
(1)分发总结
1)分发配置为re_path(r"app01/", include("app01.urls"))时:访问页面需要按照如下规则:
2)分发配置为re_path(r"^", include("app01.urls"))时:访问页面不需要添加app01:
(2)include使用注意
1)include() 的正则表达式并不包含一个 $ (字符串结尾匹配符),但是包含了一个斜杆/;
2)每当Django遇到 include() 时,它将截断匹配的URL,并把剩余的字符串发往包含的URLconf作进一步处理。
2、在/first_pro/app01/urls.py进一步配置app01路由
# -*- coding:utf-8 -*- __author__ = 'Qiushi Huang' from django.contrib import admin from django.urls import path,re_path from app01 import views urlpatterns = [ # 路由配置: 路径--------->视图函数 # 正则匹配:r'^articles/2003/$' 以articles/2003/开头且以articles/2003/结尾 re_path(r'^articles/2003/$', views.special_case_2003), # special_case_2003(request) # 正则匹配四位的任意数字,多对一 re_path(r'^articles/([0-9]{4})/$', views.year_archive), # year_archive(request,1999) # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive), # month_archive(request,2009,12) # 改写为有名分组 re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive) # month_archive(request,y=2009,m=12) # ([0-9]+):匹配前面的数字一次或无限次作为详情 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail) ]
四、路由控制——登录验证示例
1、在/first_pro/first_pro/urls.py中,编写路由配置login:
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), path('login/', views.login) ]
2、修改/first_pro/app01/views.py文件,配置login视图函数
from django.shortcuts import render,HttpResponse def login(request): print(request.method) # GET或POST # get请求来的话拿到页面,post请求来的话做校验 if request.method == 'GET': return render(request, "login.html") # post请求 else: print(request.POST) # <QueryDict: {'user': ['yuan'], 'pwd': ['123']}> user = request.POST.get("user") pwd = request.POST.get("pwd") if user=="yuan" and pwd=="123": return HttpResponse("登录成功") # 返回字符串 else: return HttpResponse("用户名或密码错误!")
取请求的方式:request.method。
得到GET请求的时候,通过render方法拿到页面;得到POST请求的时候,由于request.POST得到一个字典,通过get()方法拿到键值。
3、在/first_pro/templates/中,创建login.html模板
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <!--在不指名action的情况下,默认使用当前页面的ip地址和端口(同源)--> <form action="http://127.0.0.1:8000/login/" method="post"> 用户名 <input type="text" name="user"> 密码 <input type="password" name="pwd"> <input type="submit"> </form> </body> </html>
action代表的是一个路径。由于同源的原因,可以写为action="http://127.0.0.1:8000/login/",也可以写为action="/login/"。
由于提交的是login函数,在urls.py控制器中查找到对应的path('login/', views.login)。找到对应的视图函数来进行处理。
4、在浏览器登录,输入正确用户名和密码后,执行效果:
五、路由控制——反向解析
在使用Django 项目时,一个常见的需求是获得URL 的最终形式,以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)。人们强烈希望不要硬编码这些URL(费力、不可扩展且容易产生错误)或者设计一种与URLconf 毫不相关的专门的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()
方法。
1、在模板中实现反向解析
(1)修改配置/first_pro/first_pro/urls.py,设置别名
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), # path('login/', views.login), path('login.html', views.login, name='Log'), ]
(2)修改模板first_pro/templates/login.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <!--在不指名action的情况下,默认使用当前页面的ip地址和端口(同源)--> <!--<form action="http://127.0.0.1:8000/login/" method="post">--> <form action="{% url 'Log' %}" method="post"> 用户名 <input type="text" name="user"> 密码 <input type="password" name="pwd"> <input type="submit"> </form> </body> </html>
注意form表单的修改。
(3)从新路由地址访问
注意:
1)模板中的<form action="{% url 'Log' %}" method="post">,在页面渲染
时改为了<form action="/login/html" method="post">。django在执行return render(request,"login.html")时,并不是直接返回的login.html页面,而是经过了处理(主要是渲染模板语法)。
2)模板语法有两种:一种是"{{ }}";一种是"{% %}"。在遇到这两种情况时,会进行相应的语法渲染,将渲染的结果交给页面浏览器。
2、使用django.core.urlresolvers.reverse()
函数实现反向解析
(1)在/first_pro/app01/urls.py中给视图函数路由配置别名:
from django.contrib import admin from django.urls import path,re_path from app01 import views urlpatterns = [ # 路由配置: 路径--------->视图函数 # 正则匹配:r'^articles/2003/$' 以articles/2003/开头且以articles/2003/结尾 re_path(r'^articles/2003/$', views.special_case_2003, name="s_c_2003"), # special_case_2003(request) # 正则匹配四位的任意数字,多对一 re_path(r'^articles/([0-9]{4})/$', views.year_archive, name="y_a"), # year_archive(request,1999) # 正则匹配一个四位的数字作为年,还要匹配一个2位的数字作为月 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/$', views.month_archive), # month_archive(request,2009,12) # 改写为有名分组 re_path(r'^articles/(?P<y>[0-9]{4})/(?P<m>[0-9]{2})/$', views.month_archive) # month_archive(request,y=2009,m=12) # ([0-9]+):匹配前面的数字一次或无限次作为详情 # re_path(r'^articles/([0-9]{4})/([0-9]{2})/([0-9]+)/$', views.article_detail) ]
(2)修改/first_pro/first_pro/urls.py配置(为了修改路径区分更大)
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), # path('login/', views.login), path('login.html/', views.login, name='Log'), #分发: # re_path(r"app01/", include("app01.urls")) # 改写如下:不用app01 # re_path(r"^", include("app01.urls")) re_path(r"^app01/", include("app01.urls")) ]
(3)在/first_pro/app01/views.py中导入反向解析
from django.shortcuts import render,HttpResponse # Create your views here. # 反向解析函数 from django.urls import reverse def timer(request): import time ctime = time.strftime('%Y-%m-%d %H:%M:%S') # 2018-06-30 05:48:11 url = reverse("s_c_2003") url = reverse("y_a", args=(4009,)) # '^articles/([0-9]{4})/$' print(url) # /app01/articles/4009/ """ render方法: 1、帮忙找到timer.html取出里面的数据; 2、按照固定的语法({})把变量嵌套到html文件中 """ return render(request, 'timer.html', {"date":ctime}) # 使用render方法,返回一个页面
(4)在浏览器访问http://127.0.0.1:8000/timer/,在程序控制台输出:
/app01/articles/4009/,可以发现反向解析放在任意视图中均可以生效。
六、路由控制——名称空间
命名空间(英语:Namespace)是表示标识符的可见范围。一个标识符可在多个命名空间中定义,它在不同命名空间中的含义是互不相干的。这样,在一个新的命名空间中可定义任何标识符,它们不会与任何已有的标识符发生冲突,因为已有的定义都处于其它命名空间中。
由于name没有作用域,Django在反解URL时,会在项目全局顺序搜索,当查找到第一个name指定URL时,立即返回。
我们在开发项目时,会经常使用name属性反解出URL,当不小心在不同的app的urls中定义相同的name时,可能会导致URL反解错误,为了避免这种事情发生,引入了命名空间。
1、不同app定义相同name,URL反解现象
1)创建app02应用
$ python3 manage.py startapp app02
2)文件配置修改
/first_pro/first_pro/urls.py:
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), #分发: re_path(r"^app01/", include("app01.urls")), re_path(r"^app02/", include("app02.urls")), ]
/first_pro/app01/urls.py:
urlpatterns = [ # 路由配置: 路径--------->视图函数 # re_path("index/", views.index) re_path("index/", views.index, name="index") ]
/first_pro/app02/urls.py:
urlpatterns = [ # 路由配置: 路径--------->视图函数 # re_path("index/", views.index) re_path("index/", views.index, name= "index") # 别名重复 ]
/first_pro/app01/views.py:
# 反向解析函数 from django.urls import reverse def index(request): # 反向解析 return HttpResponse(reverse("index"))
/first_pro/app02/views.py:
# 反向解析函数 from django.urls import reverse def index(request): # 反向解析 return HttpResponse(reverse("index"))
3)在页面上访问这两个应用地址
可以看到两个都解析为/app02/index/,可以看出在不同app中出现两个别名重复,导致了URL反解错误。
2、命名空间解决URL反解错误
1)配置命名空间
/first_pro/first_pro/urls.py:
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('timer/', views.timer), #分发: re_path(r"^app01/", include(("app01.urls","app01"))), # 换为一个元组 re_path(r"^app02/", include(("app02.urls","app02"))), ]
注意:这里include里面包含的是一个元组
/first_pro/app01/views.py:
from django.urls import reverse def index(request): # 反向解析 return HttpResponse(reverse("app01:index"))
/first_pro/app02/views.py:
from django.urls import reverse def index(request): # 反向解析 return HttpResponse(reverse("app02:index"))
2)在页面上访问测试
可以看到引入了命名空间后,URL反解正常。
七、Django2.0版的path
思考情况如下:
urlpatterns = [ re_path('articles/(?P<year>[0-9]{4})/', year_archive), re_path('article/(?P<article_id>[a-zA-Z0-9]+)/detail/', detail_view), re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/edit/', edit_view), re_path('articles/(?P<article_id>[a-zA-Z0-9]+)/delete/', delete_view), ]
存在两个问题:
第一个问题,函数 year_archive
中year参数是字符串类型的,因此需要先转化为整数类型的变量值,当然year=int(year)
不会有诸如如TypeError或者ValueError的异常。那么有没有一种方法,在url中,使得这一转化步骤可以由Django自动完成?
第二个问题,三个路由中article_id都是同样的正则表达式,但是你需要写三遍,当之后article_id规则改变后,需要同时修改三处代码,那么有没有一种方法,只需修改一处即可?
在Django2.0中,可以使用 path
解决以上的两个问题。
1、基本示例
from django.urls import path from . import views urlpatterns = [ path('articles/2003/', views.special_case_2003), path('articles/<int:year>/', views.year_archive), path('articles/<int:year>/<int:month>/', views.month_archive), path('articles/<int:year>/<int:month>/<slug>/', views.article_detail), ]
基本规则:
- 使用尖括号(
<>
)从url中捕获值。相当于有名分组,括号内的int是path内置的转换器 - 捕获值中可以包含一个转化器类型(converter type),比如使用
<int:name>
捕获一个整数变量。若果没有转化器,将匹配任何字符串,当然也包括了/
字符。 - 无需添加前导斜杠
对first_pro进行修改:
/first_pro/first_pro/urls.py:
from django.contrib import admin from django.urls import path,re_path, include from app01 import views urlpatterns = [ path("articles/<int:year>/",views.path_year) # path_year(request,2010) ]
/first_pro/app01/views.py:
from django.shortcuts import render,HttpResponse # Create your views here. def month_archive(request,y,m): print(m) # 11 print(type(m)) # <class 'str'> print(y) # 2010 print(type(y)) # <class 'str'> return HttpResponse(y+"-"+m) def path_year(request, year): print(year) # 2010 print(type(year)) # <class 'int'> return HttpResponse("path year")
运行效果:
同时控制台输出:2010和<class 'int'>,说明使用<int:year>捕获的是一个整数变量。
以下是根据 2.0官方文档 而整理的示例分析表:
2、path转化器(path converters)
文档原文是Path converters,暂且翻译为转化器。
Django默认支持以下5个转化器:
- str,匹配除了路径分隔符(/)之外的非空字符串,这是默认的形式
- int,匹配正整数,包含0
- slug,匹配字母、数字以及横杠、下划线组成的字符串。(变量常用)
- uuid,匹配格式化的uuid,如 075194d3-6885-417e-a8a8-6c931e272f00
- path,匹配任何非空字符串,包含了路径分隔符 (捕获任何字符串,非空即可,但是?不行作用是分隔符)
3、注册自定义转化器
对于一些复杂或者复用的需要,可以定义自己的转化器。转化器是一个类或接口,它的要求有三点:
- regex类属性,字符串类型
- to_python(self, value)方法,value是由类属性regex所匹配到的字符串,返回具体的Python变量值,以供Django传递到对应的视图函数中
- to_url(self, value)方法,和to_python相反,value是一个具体的Python变量值,返回其字符串,通常用于url反向引用
应用示例:
(1)创建/first_pro/app01/url_convert.py文件
class MonConvert: # regex 类属性,字符串类型。因此不能随便取其他名字 regex = "[0-9]{2}" # 两位的数字 # to_python(self, value)方法,value是由类属性regex所匹配到的字符串,返回具体的Python变量值 def to_python(self, value): return int(value) # to_url(self, value) 方法,value是一个具体的Python变量值,返回其字符串,通常用于url反向引用 def to_url(self, value): return '%04d' % value
(2)注册定义的url转换器:/first_pro/first_pro/urls.py
from django.contrib import admin from django.urls import path,re_path, include, register_converter # 注意register_converter模块引入 from app01.url_convert import MonConvert # 引入创建的转换器 # 注册定义的url转换器 register_converter(MonConvert, "mm") from app01 import views urlpatterns = [ path("articles/<mm:month>", views.path_month) ]
(3)自定义转化器/first_pro/app01/urls.py
from django.shortcuts import render,HttpResponse # 自定义转化器 def path_month(request, month): print(month, type(month)) return HttpResponse("path month....")
(4)访问验证
程序控制台输出:12 <class 'int'>,可以看到month被转化为了数字类型。