Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 Важнейшей частью любого веб-фреймворка является механизм, который отвечает за маршрутизацию. Во Flask для построения карты маршрутов использовались специальные декораторы. В Django для этого используется свой небольшой<a>eDSL</a>. Он описываетurlpatterns- набор образцов, с которыми сопоставляются пути из каждого входящего запроса.

2 Каждый образец состоит из описания статических и динамических частей пути в виде строки или регулярного выражения:

3 <ul><li>Статические части пути в образце просто проверяются на равенство соответствующим участкам пути в запросе</li>

4 <li>Динамические участки пути позволяют захватывать значения и передавать во view в качестве аргументов</li>

5 </ul>Как только выясняется, что путь или его начало совпали с образцом, происходит либо вызов view, либо передача оставшейся части пути во вложенный блокurlpatterns. В большинстве больших Django-проектовurlpatternsвложены друг в друга и представляют собой дерево.

6 В этом уроке подробно разберем статические и динамические маршруты, а также рассмотрим вложенныеurlpatternsи обратные маршруты.

7 <h2>Статические маршруты</h2>

8 Мы с вами уже описали один статический маршрут:

9 Здесь path сопоставляет образец '' с вьюхой views.index. Образец "пустая строка" соответствует пустому пути - запросам главной страницы сайта. Любой не пустой путь не совпадет с таким образцом. Статические образцы обычно описываются строками вида fruits/apples/golden_one и ожидают запросов строго по этому же пути.

10 Имя домена не фигурирует вurlpatterns, что позволяет размещать одно и то же приложение на любом домене.

11 <h2>Динамические маршруты</h2>

12 Авторы Django - сторонники использования читаемых URL. Это означает, что маршруты в Django-приложениях выглядят так, что понятно, куда ведет путь. Например, по пути /users/42/pets/101/med_info/ можно догадаться, что запрашивается медицинская информация (med_info) для питомца с идентификатором 101 (pets/101). Он принадлежит пользователю с идентификатором 42 (user/42).

13 Иногда получается пойти дальше и вместо идентификаторов использовать имена. Например, такое возможно для имен пользователей, которые обычно уникальны в пределах системы. URL при использовании имен может выглядеть так: /users/~bob/books/.

14 Пути, которые включают в себя данные - идентификаторы и имена - называются динамическими. И динамические маршруты используются как раз с такими путями.

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

16 Опишемurlpatternsдля примера пути, который приведен выше:

17 Здесь <int:XXX> означает ту самую динамическую часть пути. int означает, что в этом участке пути ожидается целое число в виде строки. Если сервер получит запрос по пути /users/42/pets/101/med_info/, маршрутизация закончится вызовом вью med_info_view(request, user_id=42, pet_id=101).

18 Кроме int Django предоставляет и другие преобразователи путей - path converters. Более того, можно определять и собственные. А если пути специфические, то всегда можно использовать регулярные выражения, чтобы выделить интересные нам части пути.

19 <h3>Вложенные urlpatterns</h3>

20 Иногда маршрутов становится слишком много и среди них намечаются группы, у которых общая статическая часть. Например, это маршруты ко views одного приложения. В этом случае стоит воспользоваться возможностью включения однихurlpatternsв другие.

21 Предположим, у нас в проекте есть приложение project.users, в котором все views находятся под общим префиксом/users/. Нам достаточно создать модуль project.users.urls с описаниемurlpatternsуже без префикса и подключить модуль в корневой project.urls:

22 В новом набореurlpatternsу образцов нет префиксаusers. А в основномurlpatternsуказано, что все пути, которые начинаются сusers, нужно сопоставлять с образцами из project.users.urls.

23 Мы подключили вложенные urlpatterns с помощью функции django.urls.include и указали модуль в виде строки. Можно импортировать модуль и указать вместо цели маршрута сразу его: path('users/', project.users.urls) - эти два варианта эквивалентны. Но неявное подключение вместо импорта решает одну важную задачу: избавляет от потенциальных циклических импортов.

24 Ранее мы закомментировали в нашем мини-проекте строчку path('admin/', admin.site.urls). Это тоже включение админки в нашу карту маршрутов по префиксуadmin. Подобным образом в приложение часто подключаются сторонние пакеты, у которых собственные маршруты.

25 <h3>Обратные маршруты или reverse</h3>

26 Часто нужно получить для определенного маршрута правильный путь. Например, необходимо кому-то дать ссылку на медицинскую карточку питомца пользователя. Если мы будем вручную собирать путь из строк, то при изменениях в маршруте новый путь может стать некорректным.

27 Чтобы была возможность для любого маршрута всегда получить правильный путь, нужно произвести операцию, обратную маршрутизации - у Django есть функции<a>reverse</a>и<a>reverse_lazy</a>. Они позволяют получить путь по имени маршрута. Поэтому маршруты, которые нужно обращать, необходимо поименовать (задать уникальное имя):

28 Когда маршрут поименован, можно получить путь вызовом вида reverse('pet_med_info', kwargs={'user_id': 42, 'pet_id': 101}). Как бы ни менялась маршрутизация в дальнейшем, пока путь содержит те же именованные участки и назван по-старому, эта функция будет давать актуальный для маршрута путь.

29 Функция reverse_lazy нужна, когда путь нужно получить на этапе инициализации программы, например, при описании class based views. Во время инициализации путь может потребоваться до того, как вся карта маршрутов будет построена. И тут функция reverse_lazy всего лишь оставляет обещание вернуть путь, когда он реально понадобится - когда сервер уже начнет отвечать на запросы.

30 В итоге reverse_lazy используем в атрибутах классов, а в теле вьюх и шаблонах - reverse. Последняя работает быстрее, но только с готовой картой маршрутов.