Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 До сих пор мы встречались только со статическими маршрутами. В таких маршрутах нет изменяемых частей - адрес точно совпадает с маршрутом и не меняется. На практике чаще встречаютсядинамические маршруты. Для примера проанализируем адреса курсов на Хекслете:

2 <ul><li><a>https://ru.hexlet.io/courses/php-introduction-to-oop</a></li>

3 <li><a>https://ru.hexlet.io/courses/php-object-oriented-design</a></li>

4 <li><a>https://ru.hexlet.io/courses/js-react</a></li>

5 </ul>В этом уроке вы познакомитесь с динамическими маршрутами и узнаете, как правильно работать с множественными параметрами пути и порядком определения.

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

7 Вернемся еще раз к адресам курсов на Хекслете:

8 <ul><li><a>https://ru.hexlet.io/courses/php-introduction-to-oop</a></li>

9 <li><a>https://ru.hexlet.io/courses/php-object-oriented-design</a></li>

10 <li><a>https://ru.hexlet.io/courses/js-react</a></li>

11 </ul>Обратите внимание, что в этих адресах прослеживается определенная структура:

12 <blockquote>/courses/<имя курса>

13 </blockquote>Для таких адресов создается ровно один маршрут, в котором изменяемая часть попадает внутрь через контекст как параметр:

14 В этих примерах мы столкнулись сдинамическими маршрутами. Они имеют внутри себя изменяемые части, но при этом обработчик у маршрута только один. Например, указанные выше адреса курсов соответствуют одному маршруту, который можно записать так:

15 В этом маршруте секция {id} означает, что на это место подставляется конкретный идентификатор курса:

16 Имя изменяемой части можно выбирать произвольно - например, вместо {id} можно написать {lala}. Способ записи зависит от конкретного фреймворка. Здесь мы записали имя с обрамляющими фигурными скобками {}, как это принято в Javalin.

17 <h2>Параметры пути</h2>

18 Изменяемая часть маршрута в Javalin называетсяпараметром пути. В примере выше есть только один такой параметр - это id. Доступ к нему мы получаем через метод ctx.pathParam():

19 Как и в случае с параметрами запроса, возвращаемый тип метода ctx.pathParam() будет равен String. Это подходит не для всех случаев. Поэтому ctx содержит метод, который позволяет автоматически конвертировать данные в нужный тип:

20 Откуда берутся конкретные значения в параметрах пути? Конкретные ссылки формируются на страницах сайта. Для примера можно посмотреть на<a>список постов в блоге Хекслета</a>. На каждый пост есть ссылка, которая формируется в коде как обычная строчка с подстановкой:

21 Чтобы пользователям было удобнее, разработчики стараются использовать в адресах не числовые идентификаторы, а человекочитаемые названия. Например, вместо/courses/332показывают/courses/php-mvc. Эту часть адреса называют словомслаг(<a>slug</a>). В каждом случае мы используем уникальный слаг, при этом его формат обязан соответствовать требованиям формирования адресов.

22 Как правило, такие имена содержат символы латинского алфавита с дефисами между словами:

23 <blockquote>this-that-other-outre-collection

24 </blockquote>Подведем промежуточный итог:

25 <ul><li>Понятия "адрес" и "маршрут" обозначают разные вещи</li>

26 <li>Если маршрут статический, то он всегда совпадает с адресом - например,/about</li>

27 <li>Если маршрут динамический, то ему могут соответствовать бесконечное число адресов, даже если таких страниц на сайте нет - например,/courses/</li>

28 </ul><h2>Обработка ошибок</h2>

29 Большинство фреймворков позволяют задавать любое значение в качестве параметра.Параметромсчитается набор символов, который находится между символами слеша / или после последнего слеша. Фреймворк не знает, какие значения подходят конкретно в нашем случае, поэтому он не может принимать решение за программиста.

30 Предположим, что в нашей базе данных есть 10 курсов c идентификаторами от 1 до 10. Адрес каждого курса формируется так:

31 <blockquote>/courses/{id}

32 </blockquote>В таком случае адрес/courses/1вернет курс с идентификатором1. А вот адрес/courses/11выдаст ошибку 404, потому что такого курса не существует. Чтобы программа сработала именно так, мы должны все правильно реализовать. По идее, код должен выполнять два обязательных действия:

33 <ul><li>Проверять наличие данных в базе</li>

34 <li>Выбрасывать исключения в тех случаях, когда данных нет</li>

35 </ul>При этом исключения должны быть такими, чтобы фреймворк понимал их и обрабатывал как ошибку 404. В Javalin такое исключение работает из коробки. Код в таком случае выглядит примерно так:

36 <h2>Множественные параметры пути</h2>

37 Иногда в маршруте может быть более одного параметра. Обычно такие маршруты используются для вложенных ресурсов. Именно так работает пример ниже, где уроки вложены в курсы:

38 <h2>Порядок определения</h2>

39 В работе с динамическими маршрутами нужно следить за порядком их определения. Иначе мы можем столкнуться с ситуацией, когда одному адресу соответствует несколько маршрутов. Если это произойдет, фреймворк выберет подходящий маршрут, который идет первым по порядку определения.

40 Посмотрите на этот пример:

41 При таком порядке программа обработает запрос на страницу/courses/buildчерез маршрут/courses/{id}. Это не то, что мы задумывали. Чтобы исправить, поменяем маршруты местами:

42 Ситуация с неверным обработчиком повторится, если мы добавим курс, в которой значениеidравноbuild. Чтобы предотвратить эту проблему, мы просто запрещаем создавать такиеid.