Маршрутизация Django

Проще говоря, маршрутизация означает определение соответствующего обработчика на основе URL-ссылки, запрошенной пользователем, и возврат результата обработки, то есть установление отношения сопоставления между URL и представлениями Django.

Маршруты Django настраиваются в urls.py, и каждая запись в urls.py соответствует соответствующему методу обработки.

В разных версиях Django конфигурации urls.py немного отличаются:

Версия Django 1.1.x

метод url(): Можно использовать как обычные пути, так и пути с регулярными выражениями; необходимо вручную добавить символы начала/конца регулярного выражения.

Пример

from django.conf.urls import url # Чтобы использовать url, импортируйте его

urlpatterns = [
    url(r'^admin/$', admin.site.urls),
    url(r'^index/$', views.index), # Обычный путь
    url(r'^articles/([0-9]{4})/$', views.articles), # Путь с регулярным выражением
]

Версии Django после 2.2.x

  • path: используется для обычных путей; нет необходимости вручную добавлять символы начала/конца регулярного выражения, поскольку они уже добавлены на уровне реализации.
  • re_path: используется для путей с регулярными выражениями; необходимо вручную добавить символы начала/конца регулярного выражения.

Пример

from django.urls import re_path # Нужно импортировать re_path
urlpatterns = [
    path('admin/', admin.site.urls),
    path('index/', views.index), # Обычный путь
    re_path(r'^articles/([0-9]{4})/$', views.articles), # Путь с регулярным выражением
]

Резюме:Использование `url` в Django 1.1.x и `re_path` в Django 2.2.x одинаково.


Группировка в путях регулярных выражений

Неименованные группы в путях регулярных выражений

Неименованные группы передают параметры по позиции, соответствуя один к одному.

В представлениях, помимо request, количество остальных параметров должно совпадать с количеством групп в urls.

urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path("^index/([0-9]{4})/$", views.index),
]

views.py

from django.shortcuts import HttpResponse

def index(request, year):
    print(year) # Формальный параметр представляет содержимое одной группы в пути, сопоставляемое по порядку.
    return HttpResponse('Учебник для новичков')

Именованные группы в путях регулярных выражений

Синтаксис:

(?P<组名>正则表达式)

Именованные группы передают параметры по ключевому слову, независимо от позиционного порядка.

В представлениях, помимо request, количество остальных параметров должно совпадать с количеством групп в urls, а имена параметров в представлениях должны соответствовать именам групп в urls.

urls.py

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path("^index/(?P[0-9]{4})/(?P[0-9]{2})/$", views.index),
]

views.py

from django.shortcuts import HttpResponse
def index(request, year, month):
    print(year,month) # Формальный параметр представляет содержимое группы в пути, сопоставляемой по ключевому слову.
    return HttpResponse('Учебник для новичков')

Именованные группы в путях регулярных выражений

Распределение маршрутов (include)

Есть проблема: В проекте Django несколько каталогов приложений, совместно использующих один urls, могут легко вызвать путаницу, а последующее сопровождение неудобно.

Решение: Используйте распределение маршрутов (include), чтобы каждый каталог приложения имел свои собственные urls независимо.

Шаги:

  • 1. Создайте файл urls.py в каждом каталоге приложения.
  • 2. В файле urls в каталоге с именем проекта равномерно распределите пути по каждому каталогу приложения.

Пример

from django.contrib import admin
from django.urls import path,include # Импортируйте include из django.urls
urlpatterns = [
    path('admin/', admin.site.urls),
    path("app01/", include("app01.urls")),
    path("app02/", include("app02.urls")),
]

В каждом каталоге приложения создайте собственный файл urls.py для маршрутизации путей.

каталог app01:

from django.urls import path,re_path 
from app01 import views # 从自己的 app 目录引入 views 
urlpatterns = [ 
    re_path(r'^login/(?P<m>[0-9]{2})/$', views.index, ),
] 

каталог app02:

from django.urls import path,re_path
from app02 import views # 从自己的 app 目录引入views 
urlpatterns = [ 
    re_path("^xxx/(?P[0-9]{4})/$", views.xxx), 
]

Напишите соответствующие функции представлений в файле views.py в каждом каталоге приложения.


Обратное разрешение

По мере роста функциональности, когда URL-адреса в слое маршрутизации меняются, вам нужно изменять соответствующие URL-адреса в слое представлений и слое шаблонов, что очень хлопотно и неудобно для поддержки.

В этом случае мы можем использовать обратное разрешение. Когда URL-адрес в слое маршрутизации меняется, изменённый URL-адрес может быть динамически обратно разрешён в слое представлений и слое шаблонов, что избавляет от необходимости внесения изменений.

Обратное разрешение обычно используется в гиперссылках в шаблонах и перенаправлениях в представлениях.

Обычный путь

В urls.py задайте псевдоним для маршрута,name="route alias"。

path("login1/", views.login, name="login")

В views.py импортируйте reverse из django.urls и используйтеreverse("route alias")Обратное разрешение:

return redirect(reverse("login"))

В HTML-файлах в каталоге templates используйте{% url "route alias" %}Обратное разрешение.

<form action="{% url 'login' %}" method="post"> 

Путь регулярного выражения (неименованные группы)

В urls.py задайте псевдоним для маршрута,name="route alias"。

re_path(r"^login/([0-9]{2})/$", views.login, name="login")

В views.py импортируйте reverse из django.urls и используйтеreverse("route alias", args=(parameters matching the regex,))для обратного разрешения.

return redirect(reverse("login",args=(10,)))

В HTML-файлах в каталоге templates используйте{% url "route alias" parameters matching the regex %}для обратного разрешения.

<form action="{% url 'login' 10 %}" method="post"> 

Путь регулярного выражения (именованные группы)

В urls.py задайте псевдоним для маршрута,name="route alias"。

re_path(r"^login/(?P<year>[0-9]{4})/$", views.login, name="login")

В views.py импортируйте reverse из django.urls и используйтеreverse("route alias", kwargs={"group name": parameters matching the regex})для обратного разрешения.

return redirect(reverse("login",kwargs={"year":3333}))

В HTML-файлах в каталоге templates используйте{% url "route alias" group name=parameters matching the regex %}для обратного разрешения.

<form action="{% url 'login' year=3333 %}" method="post">


namespace

Пространство имён (англ. Namespace) представляет видимую область видимости идентификатора.

Идентификатор может быть определён в нескольких пространствах имён, и его значения в разных пространствах имён не связаны друг с другом.

Любой идентификатор может быть определён в новом пространстве имён, и они не будут конфликтовать ни с какими дублирующимися идентификаторами, потому что дублирующиеся определения находятся в других пространствах имён.

Существующие проблемы:Имя псевдонима маршрута не имеет области видимости. Когда Django выполняет обратное разрешение URL, он последовательно ищет по всему проекту и немедленно возвращает результат, когда находит первый URL, указанный именем псевдонима маршрута. Когда одно и то же имя псевдонима маршрута определено в urls в разных каталогах приложений, это может вызвать ошибки обратного разрешения.

Решение:Используйте пространства имён.

Обычный путь

Определите пространство имён (внутри include — кортеж) в следующем формате:
include(("app名称:urls","app名称"))

Пример:

path("app01/", include(("app01.urls","app01"))) 
path("app02/", include(("app02.urls","app02")))

В app01/urls.py определите тот же псевдоним маршрута.

path("login/", views.login, name="login")

Используйте пространство имён в views.py; синтаксис следующий:

reverse("app名称:路由别名")

Пример:

return redirect(reverse("app01:login")

Используйте пространство имён в HTML-файлах в каталоге templates; синтаксис следующий:

{% url "app名称:路由别名" %}

Пример:

<form action="{% url 'app01:login' %}" method="post">

Другие расширения