Django的URL路由基础
一、概述
URL路由在Django项目中的体现就是urls.py文件,这个文件可以有很多个,但绝对不会在同一目录下。实际上Django提倡项目有个根urls.py,各app下分别有自己的一个urls.py,既集中又分治,是一种解耦的模式。
随便新建个Django项目,默认会自动创建一个/project_name/urls.py文件,并自动包含一些内容,这就是项目的根URL。
如果要自己编写URL路由,基本也是这个套路。
二、Django如何处理请求
当用户请求一个页面时,Django根据下面的逻辑执行操作:
1、决定要使用的根URLconf模块。通俗地讲,就是你可以自定义项目入口url是哪个文件!
2、加载该模块并寻找可用的URLpatterns。它是django.urls.path()或django.urls.re_path()实例的一个列表。
3、依次匹配每个URL模式,在与请求的URL相匹配的第一个模式停下来。也就是说,url匹配是从上往下的短路操作,所以url在列表中的位置非常关键。
4、导入并调用匹配行中给定的视图,该视图是一个简单地python函数,或基于类的视图。视图将获得如下参数:
(1).一个HttpRequest实例
(2).如果匹配的表达式返回了未命名的组,那么匹配的内容将作为位置参数提供给视图。
(3).关键字参数由表达式匹配的命名组组成,但是可以被django.urls.path()的可选参数kwargs覆盖。
(4).若没有匹配到任何表达式,或者过程中抛出异常,将调用一个适当的错误处理视图。
三、简单实例
注:
1.要捕获一段url中的值,需要使用尖括号,而不是圆括号;
2.可以转换捕获到的值为指定类型,例如例子中的int。默认情况下,捕获到的结果保存为字符串类型,不包含/这个特殊字符;
3.匹配模式的最开头不需要添加/,因为默认情况下,每个url都带一个最前面的/,既然是都有的部分,就不用特别写一个了。
每当urls.py文件被第一次加载的时候,urlpatterns里的表达式们都将被预先编译,这会大大提高系统处理路由的速度。
四、path转换器
默认情况下,Django内置下面的路径转换器:
·str:匹配任何非空字符串,但不含/,如果没有专门指定转换器,那么这个是默认使用的。
·int:匹配0和正整数,返回一个int类型。
·path:匹配任何非空字符串,重点是可以包含路径分隔符‘/’。这个转换器可以帮助匹配整个url而不是一段一段的url字符串。(要区分path转换器和path()方法)。
·uuid:匹配一个uuid格式的对象。为了防止冲突,规定必须使用破折号,所有字母必须小写。返回一个UUID对象。
·slug:可理解为注释、后缀、附属等概念,是url拖在最后的一部分解释性字符。该转换器匹配任何ASCII字符以及连接符和下划线。
五、使用正则表达式
Django2.0之后的url虽然改配置了,但它依然向老版本兼容。而这个兼容的办法,就是用re_path()方法代替path()方法。
与path()方法不同的在于两点:
·re_path()由于是用正则进行匹配的,则只能匹配到正则指定的长度或规则。
·传递给视图的所有参数都是字符串类型。而不像path()方法可以指定转换成某种类型。在视图中接收参数时一定要小心。
六、URLconf匹配URL中的部分
请求的URL被看做是一个普通的python字符串,URLconf在其上查找并匹配。进行匹配时将不包括GET或POST请求方式的参数以及域名。
例如,在https://www.example.com/myapp/的请求中,URLconf将查找myapp/。
在https://www.example.com/myapp/?page=3的请求中,URLconf也将查找myapp/。
URLconf不检查使用何种HTTP请求方法,所有请求方法POST、GET、HEAD等都将路由到同一个URL的同一个视图。在视图中,才根据具体请求方法的不同,进行不同的处理。
七、指定视图参数的默认值
有一个小技巧,我们可以指定视图参数的默认值。下面是一个URLconf和视图的示例:
在上面的例子中,两个URL模式指向同一个视图。但是第一个模式不会从URL中捕获任何值。如果第一个模式匹配,page()函数将使用num参数的默认值“1”。如果第二个模式匹配,page()将使用捕获的num值。
八、自定义错误页面
当Django找不到与请求匹配的URL时,或者当抛出一个异常时,将调用一个错误处理视图。Django默认的自带的错误视图包括400、403、404和500,分别表示请求错误、拒绝服务、页面不存在和服务器错误。它们分别位于:
·handler400 —— django.conf.urls.handler400。
·handler403 —— django.conf.urls.handler403。
·handler404 —— django.conf.urls.handler404。
·handler500 —— django.conf.urls.handler500。
这些值可以在根URLconf中设置。在其它app中的二级URLconf中设置这些变量无效。
Django有内置的HTML模板,用于返回错误页面给用户,但是这些页面实在丑陋,通常都自定义错误页面。
首先,在根URLconf中额外增加下面的条目,并导入views模块:
然后在app/views.py文件中增加四个处理视图:
再根据自己的需求,创建对应的400、403、404、500.html四个页面文件,就可以了(要注意好模板文件的引用方式,视图的放置位置等等)。