path匹配器
默认情况下,Django内置下面的路径转换器:
- str:匹配任何非空字符串,但不含斜杠/,如果没有专门指定转换器,那么这个是默认使用的;
- int:匹配自然数,返回一个int类型
- slug:可理解为注释、后缀、附属等概念,是url拖在最后的一部分解释性字符
该转换器匹配任何ASCII字符以及连接符和下划线,比如’ building-your-1st-django-site‘; - uuid:匹配一个uuid格式的对象。为了防止冲突,规定必须使用破折号,所有字母必须小写
例如’075194d3-6885-417e-a8a8-6c931e272f00‘ 。返回一个UUID对象; - path:匹配任何非空字符串,重点是可以包含路径分隔符’/‘。这个转换器可以帮助匹配整个url而不是一段一段的url字符串。
自定义path转换器
其实就是写一个类,并包含下面的成员和属性:
- 类属性regex:一个字符串形式的正则表达式属性;
- to_python(self, value) 方法:一个用来将匹配到的字符串转换为你想要的那个数据类型,并传递给视图函数
’如果转换失败,它必须弹出ValueError异常; - to_url(self, value)方法:将Python数据类型转换为一段url的方法,上面方法的反向操作。
例如,新建一个convertpath.py文件,与urlconf同目录,写个下面的类:
class FourDigitYearConverter:
regex = '[0-9]{4}'
def to_python(self, value):
return int(value)
def to_url(self, value):
return '%04d' % value
写完类后,在URLconf 中注册,并使用它,如下所示,注册了一个yyyy:
from django.urls import register_convertpath, path
from . import converters, views
register_converter(converters.FourDigitYearConverter, 'yyyy')
urlpatterns = [
path('articles/2019/', views.special_case_2019),
path('articles/<yyyy:year>/', views.year_archive),
...
]
使用正则表达式
Django2.0的url虽然改‘配置’了,但它依然向老版本兼容。而这个兼容的办法,就是用re_path()方法代替path()方法。
re_path()方法在本质上就是以前的url()方法,只不过导入的位置变了。
与path()方法不同的在于两点:
- year中匹配不到10000等非四位数字,这是正则表达式决定的
- 传递给视图的所有参数都是字符串类型。而不像path()方法中可以指定转换成某种类型。在视图中接收参数时要小心。
对于Django 1.x版本,只需要使用from django.urls import re_path正确导入re_path()方法,并用它替换url()方法就可以。