3.2　路由分发详解

从3.1节看到，我们设置项目路由分发功能的时候，除了使用内置函数path和include之外，还在路由中设置了参数namespace，该参数是可选参数，是Django设置路由的命名空间。

路由函数include设有参数arg和namespace，参数arg指向项目应用App的urls.py文件，其数据格式以元组或字符串表示；可选参数namespace是路由的命名空间。

若要对路由设置参数namespace，则参数arg必须以元组格式表示，并且元组的长度必须为2。以路由path('', include(('index.urls', 'index'), namespace='index'))为例，参数arg为('index.urls', 'index')，参数的每个元素说明如下：

• 第一个元素为项目应用的urls.py文件，比如('index.urls','index')的“index.urls”，这是代表项目应用index的urls.py文件。
• 第二个元素可以自行命名，但不能为空，一般情况下是以项目应用的名称进行命名，如('index.urls','index')的“index”是以项目应用index进行命名的。

如果路由设置参数namespace并且参数arg为字符串或元组长度不足2的时候，比如我们将首页的路由分发设为path('', include(('index.urls'), namespace='index'))，当运行项目的时候，Django就会提示错误信息，如图3-3所示。

图3-3　运行结果

路由函数include的作用是将当前路由分配到某个项目应用的urls.py文件，而项目应用的urls.py文件可以设置多条路由，这种情况类似计算机上的文件夹A，并且该文件夹下包含多个子文件夹，而Django的命名空间namespace相当于对文件夹A进行命名。

假设项目路由设计为：在babys文件夹的urls.py定义3条路由，每条路由都使用路由函数include，并分别命名为A、B、C，每条路由对应某个项目应用的urls.py文件，并且每个项目应用的urls.py文件里定义若干条路由。

根据上述的路由设计模式，将babys文件夹的urls.py视为计算机上的D盘，在D盘下有3个文件夹，分别命名为A、B、C，每个项目应用的urls.py所定义的若干条路由可视为这3个文件夹里面的文件。在这种情况下，Django的命名空间namespace等同于文件夹A、B、C的文件名。

Django的命名空间namespace可以为我们快速定位某个项目应用的urls.py，再结合路由命名name就能快速地从项目应用的urls.py找到某条路由的具体信息，这样就能有效管理整个项目的路由列表。有关路由函数include的定义过程，可以在Python安装目录下找到源码（Lib\site-packages\django\urls\conf.py）进行解读。