精通Django 3 Web开发
上QQ阅读APP看书,第一时间看更新

3.1 设置路由分发规则

一个完整的路由包含:路由地址、视图函数(或者视图类)、路由变量和路由命名。其中基本的信息必须有:路由地址和视图函数(或者视图类),路由地址即我们常说的网址;视图函数(或者视图类)即项目应用(App)的views.py文件所定义的函数或类;路由变量和路由命名是路由的变量和命名设置,使路由具有动态变化和命名引用功能。(动态变化是指一个路由地址按照某个规律演变多种不同的路由地址;命名引用是指在视图、模型等其他项目文件使用路由命名生成相应的路由地址)

在默认情况下,设置路由地址是在项目同名的文件夹的urls.py文件里实现,这也是由配置文件settings.py的ROOT_URLCONF决定,以项目babys为例,配置属性ROOT_URLCONF指向babys文件夹的urls.py,如图3-1所示。

图3-1 配置属性ROOT_URLCONF

一个项目中可能设有多个项目应用(App),而babys文件夹的urls.py是定义项目所有路由地址的总入口,如果项目中所有路由地址都在babys文件夹的urls.py中定义,当项目功能规模越来越大的时候,babys文件夹的urls.py定义的路由地址就会越来越多,从而造成难以管理的问题。

为了更好区分各个项目应用(App)的路由地址,我们在babys文件夹的urls.py中分别为每个项目应用(App)定义一条路由入口。首先在每个项目应用(App)的文件夹里创建urls.py文件,以项目babys的项目应用index为例,其目录结构如图3-2所示。

图3-2 目录结构

除了项目应用index之外,我们还要在项目应用shopper和commodity分别创建新的urls.py文件。然后在PyCharm里打开babys文件夹的urls.py文件,将项目应用index、shopper和commodity新建的urls.py添加到babys文件夹的urls.py,添加方法由Django内置函数path和include实现,详细代码如下:

babys文件夹的urls.py定义了5条路由信息,分别是Admin站点管理、首页地址(项目应用index的urls.py)、商品信息(项目应用commodity的urls.py)、购物车信息(项目应用shopper的urls.py)和媒体资料。其中,Admin站点管理在创建项目时已自动生成,一般情况下无须更改;媒体资料的路由地址是在第2.4.6节配置的。整个babys文件夹的urls.py的代码说明如下:

  • from django.contrib import admin:导入内置Admin功能模块。
  • from django.urls import path,include:导入Django的路由函数模块。
  • urlpatterns:代表整个项目的路由集合,以列表格式表示,每个元素代表一条路由信息。
  • path('admin/', admin.site.urls):设定Admin管理系统的路由信息。'admin/'代表127.0.0.1:8000/admin的路由地址,admin后面的斜杠是路径分隔符,其作用等同于计算机中文件目录的斜杠符号;admin.site.urls指向内置Admin功能所自定义的路由信息,可以在Python目录Lib\site-packages\django\contrib\admin\sites.py中找到具体的定义过程。
  • path('', include(('index.urls', 'index'), namespace='index')):路由地址为“/”,即127.0.0.1:8000,通常是网站的首页;路由函数include是将该路由地址分发给项目应用index的urls.py处理。
  • path('commodity', include(('commodity.urls', 'commodity'), namespace='commodity')):路由地址为“/commodity”,即127.0.0.1:8000/commodity,这是商品详细和商品列表页面;路由函数include是将该路由地址分发给项目应用commodity的urls.py处理。
  • path('shopper', include(('shopper.urls', 'shopper'), namespace='shopper')):路由地址为“/shopper”,即127.0.0.1:8000/shopper,这是购物车、个人中心、用户注册等页面;路由函数include是将该路由地址分发给项目应用shopper的urls.py处理。
  • re_path('media/(?P<path>.*)', serve, {'document_root':settings.MEDIA_ROOT}, name='media'):路由地址为“/media/xxx”,即127.0.0.1:8000/media/xxx,这是媒体资源定义的路由地址,路由函数re_path表示允许在路由地址里面设置正则表达式。

从babys文件夹的urls.py定义的路由信息得知,每个项目应用(App)的路由地址交给项目应用的urls.py自行管理,这是路由的分发规则,使路由按照一定的规则进行分类管理。整个路由设计模式的工作原理说明如下:

(1)当运行babys项目时,Django从babys文件夹的urls.py找到各个项目应用(App)的urls.py,然后读取每个项目应用(App)的urls.py定义的路由信息,从而生成完整的路由列表。

(2)用户在浏览器上访问某个路由地址时,Django就会收到该用户的请求信息。

(3)Django从当前请求信息中获取路由地址,并在路由列表里匹配相应的路由信息,再执行路由信息所指向的视图函数(或视图类),从而完成整个请求响应过程。