Маршруты и маршрутизатор

Для связи определенного интернет-адреса с соответствующим контролером необходимо выполнить следующие шаги:

  • объявить связь определенного пути или шаблона с нужным контроллером.

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

  • оформить все объявленные маршруты в специальный список маршрутов;
  • маршруты необходимо оформить в заранее определенном формате, чтобы подсистема маршрутизатора смогла корректно с ним взаимодействовать.

После поступления запроса Django выделяет из переданного URL путь и передает его маршрутизатору. Далее происходит последовательное сравнение его с элементами списка маршрутов (сверху вниз). Первое найденное совпадение инициирует передачу управления контролеру, который связан с данным шаблонным путем.

Чтобы при переходе по адресу http://localhost:8000/bboard/ активировался контроллер index(), необходимо явно связать его с шаблоном URL bboard/.

Для этого необходимо открыть файл urls.py, расположенный в каталоге с именем проекта. По умолчание содержимое файлы следующее:

from django.contrib import admin
from django.urls import path
urlpatterns = [
    path('admin/ ', admin.site.urls),
]

Список маршрутов присваивается переменной urlpatterns в виде обычного списка Python. Каждый элемент данного списка должен представляться как результат, полученный от функции path() (модуль django.urls). Данная функция принимает на вход ссылку на соответствующий контроллер-функцию и строку с шаблоном URL.

В функцию path() также можно передать перечень маршрутов уровня приложения (в качестве второго параметра). Этот вариант и продемонстрирован в листинге 1.

Теперь добавим в список по умолчанию новый маршрут, обрабатывающий путь bboard/, связывая его с контролером-функцией index(). Для этого содержимое файла urls.py необходимо привести к следующему виду:

from django.contrib import admin
from django.urls import path
from bboard.views import index
urlpatterns = [
    path(' bboard/', index),
    path('admin/ ', admin.site.urls),
]

После сохранения файла запустим отладочный веб-сервер и откроем страницу http://localhost:8000/bboard/.

Маршрутизатор Django не требует, чтобы нужный адрес совпадал полностью, достаточно, если совпадет только начало.

Ранее упоминалось, что функция path() позволяет использовать в качестве второго параметра не ссылку на контроллер-функцию, а другой список маршрутов (по принципу вложенных каталогов на ПК). В этом случае маршрутизатор после фиксации совпадения удаляет начальную часть (текущий поиск) и продолжает проверку по вложенному списку.

Это позволяет сделать удобную иерархию списков маршрутов, что облегчает работу с большими проектами. В список пакета конфигурации (уровень проект) запишем маршрут, который указывает на вложенный список конкретного приложения (уровень приложения). А уже во вложенном списке укажем ссылки на нужные контроллеры.

Сначала изменим список маршрутов уровня приложения bboard. Для этого необходимо в каталоге bboard создать файл urls.py и добавить в него следующий код:

from django.urls import path
from bboard.views import index
urlpatterns = [
    path(' ', index),
]

Далее необходимо изменить код файла urls.py пакета конфигурации:

from django.contrib import admin
from django.urls import path, include
urlpatterns = [
    path(' bboard/', include('bboard.urls')),
    path('admin/ ', admin.site.urls),
]

Как видно, вторым параметром функции path(), указывается вложенный список маршрутов, который представляет собой результат, полученный от функции include() (модуль django.urls). Данная функция принимает только один параметр – путь к модулю, где указан список маршрутов нижележащего уровня.

При получении запроса http://localhost:8000/bboard/ маршрутизатор обнаружит совпадение с bboard/ в первом маршруте. Данный префикс будет автоматически удален, после чего будет продолжен поиск с новым путем (в данном случае это пустая строка). Новый путь совпадает с единственной записью вложенного списка, что приведет к запуску функции index() – откроется интернет-страница с соответствующей фразой.

В списке уровня проекта также присутствует второй маршрут (добавляется по умолчанию):

path('admin/', admin.site.urls),

Данный маршрут обеспечивает связь шаблона admin/ с набором маршрутов, который хранится в свойстве urls экземпляра класса AdminSite. Хранится он в переменной site и обеспечивает доступ к административному разделу сайта Django.



Вы можете оставить комментарий, или Трекбэк с вашего сайта.

Оставить комментарий