返回主目录:Django框架
Django 路由控制
一、路由的作用
二、路由简单配置
三、有名分组与无名分组
四、路由分发
五、反向解析
六、名称空间
一、路由的作用
URL配置(URLconf)就像Django 所支撑网站的目录。它的本质是URL与要为该URL调用的视图函数之间的映射表;
你就是以这种方式告诉Django,对于客户端发来的某个URL调用哪一段逻辑代码对应执行
--> url相当于中介,你要想要干嘛,直接找他,他帮你牵线搭桥
二、路由简单配置
Django的1.0版本与2.0具体配置参数是不一样的
(1) Django 1.11版本
基本格式:
from django.conf.urls import url
urlpatterns = [
url(正则表达式, views视图函数,参数,别名),
]
参数说明:
- 正则表达式:一个正则表达式字符串
- views视图函数:一个可调用对象,通常为一个视图函数或一个指定视图函数- 路径的字符串
- 参数:可选的要传递给视图函数的默认参数(字典形式)
- 别名:一个可选的name参数
(2) Django 2.0版本
基本格式:
from django.urls import path
from django.contrib import admin
from app01 import views
urlpatterns = [
path('admin/', admin.site.urls),
path('index/', views.index),
]
配完路由,便可以在views.py中完成相应的路由逻辑!!!
关于输入http://127.0.0.1:8000会自动跳转为http://127.0.0.1:8000/的原因:
Django settings.py配置文件中默认没有 APPEND_SLASH 这个参数,
但 Django 默认这个参数为 APPEND_SLASH = True。 其作用就是自动在网址结尾加'/'。
# settings.py中配置
# 是否开启URL访问地址后面不为/跳转至带有/的路径的配置项
APPEND_SLASH=True
三、无名分组与有名分组
(1) 无名分组
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),
]
在url的第一个参数是正则表达式,用来匹配浏览器中的路径地址。
注意事项:
- urlpatterns中的元素按照书写顺序从上往下逐一匹配正则表达式,一旦匹配成功则不再继续。
- 若要从URL中捕获一个值,只需要在它周围放置一对圆括号(分组匹配)。
- 不需要添加一个前导的反斜杠,因为每个URL 都有。例如,应该是^articles 而不是 ^/articles。
- 每个正则表达式前面的'r' 是可选的但是建议加上(防止出现特殊含义的字符)。
此处匹配的数字/字符都将会以位置参数的形式传给views.py文件下对应的处理逻辑函数或类
(2) 有名分组
在更高级的用法中,可以使用分组命名匹配的正则表达式组来捕获URL中的值并以关键字参数形式传递给视图。
在Python的正则表达式中,分组命名正则表达式组的语法是(?P<name>pattern),其中name是组的名称,pattern是要匹配的模式。
下面是以上URLconf 使用命名组的重写:
urlpatterns = [
url(r'^articles/2003/$', views.special_case_2003),
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive),
url(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>[0-9]{2})/$', views.article_detail),
]
ps:从结果上来看,与上面的实现一样,区别在于此处传入的值为关键字参数而不是位置参数。
举个栗子:
url为: /articles/2017/12/ 可以等效看作:
--> views.month_archive(request, year="2017", month="12")
四、路由分发
Django每一个app下面都可以有自己的urls.py路由控制文件、templas文件夹、static文件夹
项目下的urls.py(总路由)不再做路由与视图函数的匹配关系,而是做路由的分发,让应用下的urls.py路由控制文件去做详细的匹配关系。
ps:注意路由分发的总路由,千万不要用$结尾
(1) 导什么包
Django1.1版本的分发
from django.conf.urls import url,include
(2) 主从urls如何写 (注意版本,下面的是2.0版本的书写方式)
# 项目文件下的:urls
from django.urls import path,re_path,include
from app01 import views
from app01 import urls
urlpatterns = [
# re_path(r'^app01/',include('app01.urls')),#行 2.0版本的是re_path对应1.0版本的 urls
# re_path(r'^app01/&',include('app01.urls')),#不行
# path('app01/',include('app01.urls')),#行
# path('app01/', include(urls)),
]
# 在app01里的 urls
from django.urls import path,re_path
from app01 import views
urlpatterns = [
re_path(r'^test/(?P<year>[0-9]{4})/$',views.url_test),
]
五、反向解析
在使用Django 项目时,常见的需求是获得URL 的最终形式,
以用于嵌入到生成的内容中(视图中和显示给用户的URL等)或者用于处理服务器端的导航(重定向等)。
在需要URL的地方,对于不同层级,Django 提供不同的工具用于URL 反查:
- 在模板中:使用url 模板标签。
- 在Python 代码中:使用from django.urls import reverse()函数
例子:
urls.py文件中:
urlpatterns = [
# 给url匹配模式起名为app01_index
url(r'^index/(\d*)', views.index, name='app01_index'),
]
解释:app01_index是正则表达式识别的内容为 /index/
views.py文件中:
def index(request, ar):
print(ar) # 1231
url = reverse('app01_index', args=(ar,))
print(url) # /index/1231
return render(request, 'login.html', locals())
解释:类似于join方法,将字段进行拼接
login.html文件中:
<body>
<p>{% url 'app01_index' ar %}</p>
</body>
url:http://127.0.0.1:8000/index/1231
界面显示:/index/1231
六、名称空间
由于name没有作用域,Django在反解URL时,会在项目全局顺序搜索,当查找到第一个name指定URL时,立即返回
我们在开发项目时,会经常使用name属性反解出URL,当不小心在不同的app的urls中定义相同的name时,
可能会导致URL反解错误,为了避免这种事情发生,引入了命名空间。
项目urls.py下:
from django.urls import path,re_path,include
urlpatterns = [
path('app01/', include('app01.urls')),
path('app02/', include('app02.urls'))
]
app01应用下的urls.py:
from django.urls import path,re_path
from app01 import views
urlpatterns = [
re_path(r'index/',views.index,name='index'),
]
views.py
def index(request):
url=reverse('index')
print(url)
return HttpResponse('index app01')
app02应用下的urls.py:
from django.urls import path, re_path, include
from app02 import views
urlpatterns = [
re_path(r'index/', views.index,name='index'),
]
views.py
def index(request):
url=reverse('index')
print(url)
return HttpResponse('index app02')
--->>>这样都找index,app01和app02找到的都是app02的index
在路由分发的时候指定名称空间,即可解决这个问题。
path('app01/', include(('app01.urls','app01'))),
path('app02/', include(('app02.urls','app02')))
url(r'app01/',include('app01.urls',namespace='app01')),
url(r'app02/',include('app02.urls',namespace='app02'))
url(r'app01/',include(('app01.urls','app01'))),
url(r'app02/',include(('app02.urls','app02')))
在视图函数反向解析的时候,指定是那个名称空间下的
url=reverse('app02:index')
print(url)
url2=reverse('app01:index')
print(url2)
在模板文件里:
<a href="{% url 'app02:index'%}">这是一个模板文件</a>
补充:
1.伪静态网页
就是在URL后面加上.html,将动态的网页伪装成静态网页
url(r'^index.html',views.index)
url(r'^index/\d+.html',views.index)
2.虚拟环境
每一个项目都有属于自己的python环境,避免导入多余的模块造成资源浪费
(1) django1.0与django2.0之间的区别
django2.0里面的path第一个参数不支持正则,你写什么就匹配,100%精准匹配
django2.0里面的re_path对应着django1.0里面的url
(2) 虽然django2.0里面的path不支持正则表达式,但是它提供五个默认的转换器
str,匹配除了路径分隔符(/)之外的非空字符串,这是默认的形式
int,匹配正整数,包含0。
slug,匹配字母、数字以及横杠、下划线组成的字符串。
uuid,匹配格式化的uuid,如 075194d3-6885-417e-a8a8-6c931e272f00。
path,匹配任何非空字符串,包含了路径分隔符(/)(不能用?)
(3) 自定义转换器:
1.正则表达式
2.写两个方法一个叫to_python,一个叫to_url
3.注册(起一个名字 比如叫xxx)
url(r'^index/<str:id>',views.index)
url(r'^index/<xxx:id>',views.index)
(4)) 自定义转换器
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')
PS:路由匹配到的数据默认都是字符串形式