一、概述
''' URL是服务器的入口，用户通过浏览器发送过来的任何请求，都是发送到一个指定的url地址，然后被响应 在Django项目中编写路由，就是向外界暴露我们接收哪些url请求，除此之外的任何url都不被处理，也没有返回。通俗的理解，url就是web服务对外暴露的api 要设计应用程序的url，可以创建一个非正式的称为URLconf的Python模块。此模块是纯Python代码，是URL路径表达式与Python函数之间的映射 '''
二、简单的路由配置
from django.conf.urls import url
from django.contrib import admin
from app01 import views # 导入后端逻辑
urlpatterns = [
url(正则表达式，views视图函数，参数，别名),
]
- 正则表达式：一个正则表达式字符串，每个正则表达式前面的r是可选的但是建议加上，它是告诉Python这个字符串是原始的，字符串中的任何字符都不能转义
- views视图函数：一个可调用的对象，通常为一个视图函数或一个指定视图函数路径的字符串
- 参数：可选的要传递给视图的默认参数(字典形式)
- 别名：一个可选的name参数
- urlpatterns中的元素是书写顺序从上往下逐一匹配正则表达式，一旦匹配成功则不再继
path re_path path的区别：
''' url格式: url(r'^admin/', admin.site.urls) 需要到导入url模块: from django.conf.urls import url 可用使用正则表达式 Django1.0中使用 re_path: re_path(r'^publish/([0-9]{4})/([0-9]{2})$',views.publish), Django2.0中使用，完全兼容url
需要导入re_path模块： from django.urls import re_path
path:
需要导入path模块： from django.urls import path 不能使用正则表达式，2.0独有 '''
三、django2.0版的path
from django.contrib import admin from django.urls import path from app01 import views urlpatterns = [ path('admin/', admin.site.urls), path('server/<int:proj_id>/',views.proj_detail) ]
- 要捕获一段URL中的值，需要使用尖括号<> ，而不是之前的小括号()
- 捕获值中可以包含一个转换器类型(converter type)，比如使用<int:proj_id>捕获一个整数变量，如果没有转换器，将匹配任意字符
- 如果使用int转换器类型，而url中实际传入了string字符，将没法匹配到这条路由 直接抛出404 例如 http://127.0.0.1:8000/server/project/
- 使用path转换器，默认情况下不能使用正则匹配(可以注册自定义转换器)，所以要么使用url/re_path 正则匹配，要么使用path
django默认支持的以下5个转换器
- str 匹配除了路径分隔符(/)之外的非空字符串，默认就是str
- init 匹配整数，包含0
- slug 匹配字母、数字以及横杠、下划线组成的字符串
- uuid 匹配格式化的uuid 如 353b3f42-4b83-11e9-8eff-9cb6d0129e8e
- path 匹配任何非空字符 包含了路径分隔符，不能用?
注册自定义转换器
class FourDigitYearConverter: regex = '[0-9]{4}' # 匹配规则 def to_python(self, value): return int(value) def to_url(self, value): return '%04d' % value # 两个def是固定语法
使用 register_converter将其注册到url配置中
from django.contrib import admin from django.urls import path,register_converter from app01 import views,converteres register_converter(converteres.FourDigitYearConverter.,'yyyy') urlpatterns = [ path('admin/', admin.site.urls), path('app/<int:proj_id>/',views.proj_detail), path('articles/2003/', views.special_case_2003), path('articles/<yyyy:year>/', views.year_archive) ]
四、APPEND_SLASH
# 是否开启URL访问地址后面不为/ 跳转至带有/ 的路径配置项 APPEND_SLASH = True # django setting.py配置文件中没有APPEND_SLASH这个参数，但django默认这个参数为APPEND_SLASH = True，其作用就是自动在url结尾后面加/
# 如果 APPEND_SLASH = False url中如果没有加/ 会报404
五、无名分组
- 按位置传参
- 分组后，会把分组出来的数据，当做位置从参数传给视图函数，视图函数必须要定义形参接收，否则报错
- url示例：re_path(r'^publish/([0-9]{4})/([0-9]{2})$',views.publish),
- 视图函数示例：def publish(request,*args):
六、有名分组
- 按关键字传参
- 分组后，会把分组出来的数据，当关键字参数传给视图函数，所以视图函数需要定义形参，形参名要跟分组的名字对应，与顺序无关
- url示例： re_path('^app/(?P<proj_id>[0-9]{2})',views.proj_detail),
- 视图函数示例: def proj_detail(request,proj_id):
- 注意：有名分组和无名分组不要混用
- 分组后捕获的数据默认都是str类型
from django.contrib import admin from django.urls import path,re_path urlpatterns = [ path('admin/', admin.site.urls), re_path('^app/(?P<proj_id>[0-9]{2})',views.proj_detail), ]
from django.shortcuts import render,HttpResponse # Create your views here. def proj_detail(request,proj_id): print(proj_id,type(proj_id)) return HttpResponse('ok')
七、反向解析(通俗的理解就是，通过url层中的name反向解析出真正的url地址)
''' 在使用django项目时，一个常见的需求是获得url的最终形式，以用于嵌入到生成的内容中(视图中和限时给用户的url等)或用于处理服务端的导航(重定向等)。 此时这些url尽量不要写死(如果多出调用这个URL，会导致扩展时容易产生错误)，或者设计一种与URLconf毫不相关的专门的UR生成机制 因为这样容易导致一定程度上产生过期的URL 在需要URL的地方，对于不同的层级，django提供不同的工具用于URL反差 模板层: 使用url模板标签 视图层: 使用from django.urls import reverse()函数 '''
1、无参数(未分组)
url('^proj/app/index', views.index, name='app_index') #name就是反向解析的名字
from django.conf.urls import url # 导入url from django.urls import path, re_path # 导入path re_path from app01 import views urlpatterns = [ url('^proj/app/index', views.index, name='app_index'), url('^proj/app/edit', views.edit, name='app_edit') ]
模板层调用：# 实际等于：<a href="/proj/app/edit">新增项目</a>
<a href="{% url 'app_edit' %}">新增项目</a>
视图层调用:（需要导入reverse模块）
from django.shortcuts import render,reverse,redirect # Create your views here. def index(request): return render(request,'index.html') def edit(request): url=reverse('app_index') # 传url中定义的name值 print(url) return redirect(url)
2、无名分组
url层
url('^proj/app/delete/([0-9]{1})',views.app_delete,name='app_delete')
模板层调用，通过位置传参：
<a href="{% url 'app_delete' 1 %}">删除项目</a> # 参数紧跟name后面
视图函数中调用：
def index(request): url=reverse('app_detail',args=(1,)) # 通过args传参 print(url) return redirect(url)
3、有名分组
url层
url('^proj/app/delete/(?P<app_id>[0-9]{1})',views.app_delete,name='app_delete')
模板层调用：
{#<a href="{% url 'app_delete' 1 %}">删除项目</a>#} # 既可以按位置传参
<a href="{% url 'app_delete' app_id=1 %}">删除项目</a> # 也可以按关键字传参 注意：此处的关键字就是url中有名分组中定义的
视图层中调用：
from django.shortcuts import render,HttpResponse,reverse,redirect def index(request): # url=reverse('app_detail',kwargs={'app_id':1}) # 既可以按kwargs关键字传参 url=reverse('app_detail',args=(1,)) # 也可以按args位置传参 return redirect(url)
八、路由分发
当一个django项目里面有多个APP目录时，前期共用的一个url系统，会容易造成混淆，维护非常不方便，于是路由分发就让每个APP拥有自己的单独的url，然后向总的url中注册。
总路由(不能加结束符$)
from django.conf.urls import url,include urlpatterns = [ url(r'^server/', include('server.urls')), url(r'^account/', include('account.urls')) ]
子路由
from django.conf.urls import url from server import views urlpatterns = [ url(r'^server_add/$',views.server_add), ]
九、名称空间
名称空间(namespace)是标识符的可见范围。一个标识符可在多个名称空间中定义，它在不同空间中的含义是互不相干的。这样在一个新的名称空间中可定义任何标识符，它们不会与任何已有的标识符发生冲突，因为已有的定义都处于其他名称空间中
由于name没有作用域，django在反向解析url时，会在项目全局顺序搜索，当查到第一个name指定的url时，立即返回
在开发项目时，会经常使用name属性反解出url，当不小心在不同app的urls中定义相同的name时，可能会导致url反解错误，为了避免这种事情发生，引入了名称空间
不同app的urls中定义相同的name时，可能出现反解错误
总urls.py
from django.conf.urls import url, include urlpatterns = [ url(r'^server/', include('server.urls')), url(r'^account/', include('account.urls')) ]
account的urls.py
from django.conf.urls import url from account import views urlpatterns = [ url(r'^account_list',views.account_list,name='list'), url(r'^account_add/$',views.account_add,name='add'), ]
server的urls.py
from django.conf.urls import url from server import views urlpatterns = [ url(r'^server_list/$',views.server_list,name='list'), url(r'^server_add/$',views.server_add,name='add') ]
account的视图函数
from django.shortcuts import HttpResponse, reverse, redirect # Create your views here. def account_list(request): return HttpResponse('this is account_list page') def account_add(request): url = reverse('list') print(url) return redirect(url)
server的视图函数
from django.shortcuts import HttpResponse, reverse, redirect # Create your views here. def server_list(request): return HttpResponse('this is a server_list page') def server_add(request): url = reverse('list') print(url) return redirect(url)
这样就会在反解时，出现错误，如下图，访问server和account都跳account的路由
如何解决呢
在总urls.py里指定namespace
from django.conf.urls import url, include urlpatterns = [ url(r'^server/', include(('server.urls', 'server'))), url(r'^account/', include(('account.urls', 'account'))) ] # django2.0 不支持namespace格式，include中把子路由和namespace用元组包起来
在视图函数反向解析的时候，指定是哪个名称空间下的
def account_add(request): url = reverse('account:list') print(url) return redirect(url)
在模板里：
<a href="{% url 'server:list' %}">服务器列表</a>
十、伪静态
''' 伪静态是相对真实静态来讲的，通常我们为了增强搜索引擎的友好面，都将文章内容生成静态页面，
但是有的朋友为了实时的显示一些信息。或者还想运用动态脚本解决一些问题。
不能用静态的方式来展示网站内容。但是这就损失了对搜索引擎的友好面。
怎么样在两者之间找个中间方法呢，这就产生了伪静态技术。就是展示出来的是以html一类的静态页面形式 '''
urls.py中配置
url(r'^server_edit/(?P<id>[0-9]{1}).html',views.server_edit)
浏览器中访问:必须带html
http://127.0.0.1:8000/server/server_edit/1.html
十一、根路径响应到指定函数
根路径的url配置必须放到第一行(因为URLconf是自上而下匹配的)
urlpatterns = [ url(r'^$',views.server_index), # 根路径响应到指定函数 url(r'^server_list/$', views.server_list, name='list'), url(r'^server_add/$', views.server_add, name='add'), url(r'^server_edit/(?P<id>[0-9]{1}).html',views.server_edit), ]
十二、没有配置的路径，响应到指定错误的视图函数
必须写到url配置文件中的最后一行
urlpatterns = [ url(r'^$',views.server_index), url(r'^server_list/$', views.server_list, name='list'), url(r'^server_add/$', views.server_add, name='add'), url(r'^server_edit/(?P<id>[0-9]{1}).html',views.server_edit), url(r'',views.server_error) # 最后一行 ]