随着 Django 版本的升级,内部的一些使用方式也发生了一些变化,现在讨论一下关于路由配置的一些差异化:
首先看一下工程的整体结构(仅标注了本文中使用的文件):Django1.x版本中的写法:
1、工程路由文件 urls.py
from django.contrib import admin
from django.conf.urls import url, include # 导入 url 模块
# # 导入应用视图
# 可以在这里设置全局路由,也可以单独配置
urlpatterns = [
url(r'^ admin/$',admin.site.urls),
url(r'^ djapp/$',include('djApp.urls'), name= 'djApp'),
]
2、本地路由文件 djApp/urls.py
#!/usr/bin/env python
# _*_ coding:utf-8 _*_
# 头部两行规范,支持 utf-8
from django.contrib import admin
from django.conf.urls import url, include # 导入 url 模块
# 从当前目录导入 views 文件
from . import views
urlpatterns = [
#例如: 表示直接匹配路由 http://127.0.0.0:8000/djapp
url(r'^/$', name = 'index'),
# 例如: 表示直接匹配路由 http://127.0.0.0:8000/djapp/detail/3
url(r'^detail/(?P<id>[0-9]+)/$', name = 'detail'),
...
]
3、视图文件 views.py
from django.shortcuts import render
# Create your views here.
from django.http import *
from .models import * # 导入模型类
def index(request):
books = BookInfo.objects.all()
context = {
'books': books,
}
return render(request, 'djApp/index.html', context=context)
def detail(request,id):
book_detail = BookInfo.objects.get(pk = id)
context = {
'btitle': book_detail.btitle,
'pub_date': book_detail.bpub_date,
'heros': book_detail.heroinfo_set.all()
}
return render(request, 'djApp/detail_test.html', context=context)
4、模板文件 index.html
使用超链接时:
<li>
<a href="{% url 'djApp:detail' book.id %}">书名:{{ book.btitle }}</a>
</li>
在模板文件 index.html
中,使用的超链接方式,是官方比较推荐的一种方式,这样的好处是:适合实际项目开发,便于各种路径维护的问题(如模块路径更换、路由路径更新会等)
使用方式如图所示:
基本语法为:
{% url "应用空间命名 : 本地路由方法命名" 本地路由方法参数 %}
,即djApp
是在 路由文件中为当前应用创建的一个 空间命名url(r'^ djapp/$',include('djApp.urls'), name= 'djApp')
中的name = "djApp"
;detail
是在 本地路由文件中为def detail(request,id):
方法创建的路由名称;book.id
则是 def detail(request,id):
方法中需要传入的 id
参数
----------------------分割线------------------------
Django2.0版本中路由写法:
上述内容是在Django1.x
版本中,在模板
中使用路由指定的形式进行超链接访问的配置,但是在Django2.0
版本中时,因为系统使用的是from django.urls import path
模块,并非from django.conf.urls import url
模块,所以需要进行一定的配置调整:
方法一:
手动导入from django.conf.urls import url
,完全按照Django1.x
中路由的配置方法进行编写
方法二:
官方文档:URL dispatcher
使用系统推荐的from django.urls import path
模块进行设计,这样就有几处需要进行改动:主要是针对1、工程路由文件 urls.py
、2、本地路由文件 djApp/urls.py
,下面来一一介绍:
1、工程路由文件 urls.py
from django.contrib import admin
from django.urls import path,include
# # 导入应用视图
# 可以在这里设置全局路由,也可以单独配置
urlpatterns = [
path('admin/', admin.site.urls),
# 例如: http://127.0.0.0:8000/djapp
path('djapp/', include('djApp.urls', namespace='djApp'))
]
2、本地路由文件 djApp/urls.py
from django.urls import path
from . import views
# 也可以在每个应用中单独配置 应用的本地路由
app_name = 'djApp'
urlpatterns = [
path('',views.index),
path('index/', views.index),
# 例如: http://127.0.0.0:8000/djapp/detail/3
path('detail/<id>/', views.detail, name = 'detail'),
]
通过这样配置修改,在index.html
模本文件中就可以正常以当前形式进行访问啦,这时我们会发现有几点需要注意的:
1、路由配置形式:
path('detail/<id>/', views.detail, name = 'detail')
直接拼接路由,而非通过正则进行匹配,对于参数,使用<参数>
进行表示,views.detail
表示对应的视图方法,name = "detail"
同样表示为 视图方法
定义的名字(在 模板文件中使用)
2、路由使用 include 模块时:
可以通过path("djapp/", include("djApp.urls", namespace="djApp"))
这种形式进行配置应用的空间命名 namespace="djApp"
,
但是这样配置需要一个前提条件:在本地路由中
配置app_name = 'djApp'
参数,与urlpatterns
同级
关系图如下:
当然,系统提供的路由配置方法还有很多,比如re_path
模块也可以通过正则表达式进行匹配
等,更多详情请查看官方文档:URL dispatcher,这里我只是记录整理了我在工程中遇到的一些问题及解决方案,仅供参考,至此填坑结束,先去踩下一个坑啦
附 : 通过 正则表达式 匹配路由的规则
http://blog.csdn.net/kuangshp128/article/details/75669700
# 通过正则表达式匹配:
#
# ^ (上箭头):要求表 达式对字符串的头部进行匹配,
# $(美元符号):要求表达式对字符串的尾部进行匹配
#
# . (dot):任意单一字符
# \d :任意一位数字
# [A‐Z] :A 到 Z中任意一个字符(大写)
# [a‐z] :a 到 z中任意一个字符(小写)
# [A‐Za‐z]:a 到 z中任意一个字符(不区分大小写)
# + :匹配一个或更多 (例如, \d+ 匹配一个或 多个数字字符)
# [^/]+ :一个或多个不为‘/’的字符
# ? :零个或一个之前的表达式(例如:\d? 匹配零个或一个数字)
# * :匹配0个或更多 (例如, \d* 匹配0个 或更多数字字符)
# {1,3} :介于一个和三个(包含)之前的表达式(例如,\d{1,3}匹配一个或两个或三个数字)
# 动态参数使用方式:
# /(?P< 参数 >)/
# 关于配置URL正则的规则
# 1、主URL开始地方不要加/
# 2、主URL后面地方要加/
# 3、组件(App)的URL前面不要加/
# 4、主URL后面不要加$
# 5、组件(App)后面要加$