Django：urls.py中的urlpatterns的格式

在本文中，我们将介绍Django框架中urls.py文件中urlpatterns的格式。

阅读更多：Django 教程

urlpatterns的作用

在Django框架中，urls.py文件是用来定义网站的URL路由规则的。其中，urlpatterns变量用于存储URL和对应的视图函数之间的映射关系。通过定义urlpatterns，我们可以将用户的请求URL与相应的视图函数进行匹配，从而实现用户请求的处理。

urlpatterns的格式

在urls.py文件中，urlpatterns是一个列表，其中每个元素代表了一个URL与对应视图函数的映射关系。每个元素由两部分组成，分别是URL的正则表达式和对应的视图函数，两部分之间用逗号隔开。下面是一个示例：

from django.urls import path
from . import views

urlpatterns = [
    path('home/', views.home),
    path('login/', views.login),
    path('logout/', views.logout),
    ...
]

在这个示例中，urlpatterns列表中包含了三个元素，每个元素都是一个path函数的调用。path函数接收两个参数，第一个参数是URL的正则表达式，第二个参数是对应的视图函数。上述示例中，URL ‘/home/’会被映射到views.py文件中的home函数，URL ‘/login/’会被映射到views.py文件中的login函数，URL ‘/logout/’会被映射到views.py文件中的logout函数。

URL的正则表达式

URL的正则表达式用于匹配用户请求的URL。在Django中，我们可以使用一些特殊的字符来定义正则表达式的模式，如下所示：

• ^：匹配字符串的开头
• $：匹配字符串的结尾
• ?：匹配前面的字符0次或1次
• +：匹配前面的字符1次或多次
• *：匹配前面的字符0次或多次
• ()：将其中的内容作为一个整体进行匹配
• []：匹配中括号中的任意字符
• .：匹配除换行符以外的任意字符
• \d：匹配任意数字字符
• \w：匹配任意字母、数字和下划线字符

下面是一个示例，展示了如何使用正则表达式进行URL匹配：

from django.urls import path
from . import views

urlpatterns = [
    path(r'^', views.home),   # 匹配根目录
    path(r'^articles/(\d+)/', views.article),   # 匹配/articles/后面跟着一个或多个数字的URL
    path(r'^search/(?P<keyword>\w+)/$', views.search),   # 匹配/search/后面跟着一个或多个字母、数字或下划线的URL，并将其作为参数传递给视图函数
]

在这个示例中，URL ‘^‘匹配根目录，’^articles/(\d+)/‘匹配/articles/后面跟着一个或多个数字的URL，并将匹配到的数字作为参数传递给视图函数，’^search/(?P\w+)/$’匹配/search/后面跟着一个或多个字母、数字或下划线的URL，并将匹配到的关键字作为参数传递给视图函数。

路由规则的优先级

在Django框架中，路由规则的优先级是按照urlpatterns列表中元素的顺序进行匹配的。当收到一个URL请求时，Django会按照urlpatterns列表中的顺序依次匹配每个元素，直到找到第一个匹配的路由规则。因此，我们需要根据具体的需求合理定义urlpatterns的顺序，以避免路由规则的冲突。一般来说，我们应该将更具体的路由规则放在前面，将更一般的路由规则放在后面。

考虑以下示例：

from django.urls import path
from . import views

urlpatterns = [
    path('article/<int:id>/', views.article_detail),  # 匹配/article/后面跟着一个整数的URL
    path('article/all/', views.all_articles),  # 匹配/article/all/的URL
    path('article/<slug:slug>/', views.article_by_slug),  # 匹配/article/后面跟着一个slug的URL
    path('article/<str:title>/', views.article_by_title),  # 匹配/article/后面跟着一个字符串的URL
]

在这个示例中，我们首先定义了一个匹配/article/后面跟着一个整数的URL的路由规则，然后是匹配/article/all/的路由规则，再之后是匹配/article/后面跟着一个slug的URL的路由规则，最后是匹配/article/后面跟着一个字符串的URL的路由规则。这样的顺序可以确保精确匹配的路由规则优先被匹配，而较一般的路由规则则被留到最后。

动态URL参数传递

在Django中，我们可以使用URL参数来传递动态数据给视图函数。通过在URL的正则表达式中添加括号，我们可以定义一个URL参数，然后在视图函数中通过参数的形式接收传递的值。

以下是一个示例：

from django.urls import path
from . import views

urlpatterns = [
    path('article/<int:id>/', views.article_detail),  # 匹配/article/后面跟着一个整数的URL
    ...
]

在视图函数article_detail中，我们可以通过参数id来接收URL中传递的id值。例如，当用户访问URL ‘/article/123/’时，Django会将123作为参数传递给article_detail视图函数。

命名URL

在Django中，我们可以给每个URL定义一个在整个项目中唯一的名称。这样做的好处是，我们可以在代码中使用URL的名称来构建URL，而不需要硬编码URL。

以下是一个示例：

from django.urls import path
from . import views

urlpatterns = [
    path('article/<int:id>/', views.article_detail, name='article_detail'),  # 匹配/article/后面跟着一个整数的URL
    ...
]

在这个示例中，我们给article_detail这个URL定义了一个名字。在其他地方，我们可以使用这个名字来构建URL。例如，我们可以使用reverse函数来根据名称构建URL：

from django.urls import reverse

url = reverse('article_detail', args=[123])

在这个例子中，我们将生成的URL赋值给变量url。这个URL将是’/article/123/’，其中123是通过args参数传递的。

总结

通过本文，我们了解了Django框架中urls.py文件中urlpatterns的格式。我们学习了urlpatterns的作用以及如何定义URL与视图函数的映射关系。我们还学习了URL的正则表达式的语法以及如何编写动态URL和命名URL。

正确定义和使用urlpatterns对于构建一个高效的Django应用程序至关重要。准确的路由规则可以帮助我们将用户请求正确地分发到相应的视图函数，从而提供良好的用户体验。希望本文能够帮助您更好地理解和应用Django框架中urls.py文件中urlpatterns的格式。