Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

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

2 В этом уроке мы разберем понятие маршрутизации. В веб-разработке - это важная составляющая, потому что она определяет, как веб-приложение обрабатывает различные HTTP-запросы пользователей.

3 <h2>Что такое роутинг</h2>

4 В Go-приложениях вся бизнес-логика описывается в обработчиках. Каждый обработчик - это логика поведения веб-приложения на определенный HTTP-запрос от клиента. Но веб-приложению нужно определить, какой обработчик используется для определенного запроса.

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

6 Чаще всего роутинг осуществляется двумя способами:

7 <ul><li>По пути HTTP-запроса</li>

8 <li>По HTTP-методу запроса</li>

9 </ul>Разберем каждый подход подробнее.

10 <h3>Роутинг по пути HTTP-запроса</h3>

11 Роутинг по пути HTTP-запроса используется во всех веб-приложениях. Путь - это часть URL, которая идет после домена. Например, в URL https://example.com/about путь - это /about.

12 Правила сопоставления пути HTTP-запроса с обработчиком описываются в коде при инициализации веб-приложения:

13 Когда приходит новый запрос от клиента, веб-приложение ищет соответствующий обработчик по пути HTTP-запроса. В примере выше при запросе по пути /path1 будет вызван обработчик path1Handler, а при запросе по пути /path2 будет вызван обработчик path2Handler.

14 Мы видим, чтобы в Fiber настроить роутинг наGETHTTP-запрос, достаточно вызвать метод webApp.Get() и передать путь HTTP-запроса с нужным обработчиком.

15 Рассмотрим маршрутизацию по пути HTTP-запроса на конкретном примере. Нам нужно реализовать веб-приложение с обучающими курсами. Оно должно уметь обрабатывать два типа запросов:

16 <ul><li>Запрос по пути /about должен возвращать текст "The best school for Software Engineers"</li>

17 <li>Запрос по пути /courses должен возвращать список курсов. Мы будем возвращать список курсов в виде строки "Java, Go, Python"</li>

18 </ul>Запускаем веб-приложение и переходим в браузере на страницу со списком курсов:<a>http://localhost/courses</a>. Видим, что в ответ пришло сообщение "Java, Go, Python".

19 Если мы перейдем на страницу с информацией о компании<a>http://localhost/about</a>- в ответ приходит строка "The best school for Software Engineers".

20 Веб-приложение понимает, какой обработчик необходимо вызвать по пути HTTP-запросов. Поэтому мы получаем в ответе сообщение, которое соответствует HTTP-запросу. Но что будет, если мы отправим HTTP-запрос по несуществующему пути?

21 Если отправить запрос по несуществующему пути, например,/about2, то ответ будет таким: "Cannot GET /about2" с HTTP статусом 404 Not Found. Так происходит, потому что мы не настроили обработчик для пути/about2, и веб-приложение не знает, какой обработчик ему вызвать. В таком случае возвращается стандартный ответ с HTTP-статусом 404 Not Found.

22 Мы разобрали, как настроить роутинг по HTTP-запросам. В нашем примере веб-приложение только возвращало запрашиваемые данные. В иных случаях нам часто требуется не только возвращать данные, но и изменять их. Для этого используется роутинг по методам HTTP-запросов.

23 <h3>Роутинг по HTTP-методу запроса</h3>

24 HTTP-метод - это метод, который указывает, какое действие нужно выполнить по HTTP-пути запроса. Мы рассмотрим два наиболее популярных HTTP-метода:

25 <ul><li>GET- получение данных</li>

26 <li>POST- создание или изменение данных</li>

27 </ul>В Fiber роутинг по HTTP-методу запроса настраивается с помощью специальных функций:

28 <ul><li>webApp.Get() - для роутинга GET-запросов</li>

29 <li>webApp.Post() - для роутинга POST-запросов</li>

30 </ul>Рассмотрим роутинг по HTTP-методам на конкретном примере. Предположим, что мы разрабатываем онлайн-счетчик, который умеет обрабатывать следующие HTTP-запросы:

31 <ul><li>POST /counter, который увеличивает счетчик на единицу</li>

32 <li>GET /counter, который возвращает текущее значение счетчика и не изменяет его состояние</li>

33 </ul>В этих HTTP-запросах совпадает путь, но различаются методы. И именно по ним веб-приложение понимает, какой обработчик нужно вызывать.

34 Так это выглядит на Go с использованием фреймворка Fiber:

35 Запускаем веб-приложение, открываем браузер и переходим на страницу<a>http://localhost/counter</a>. В ответ получаем строку "0". Нам вернулся корректный ответ, потому что мы еще не увеличивали счетчик.

36 Счетчик увеличивается с помощью POST-запроса. Есть разные способы осуществить такой запрос, но проще всего использовать утилитуcurl. Для этого открываем терминал и выполняем следующую команду:

37 В ответ получаем статус "HTTP/1.1 200 OK" - успешное выполнение запроса. Переходим на страницу<a>http://localhost/counter</a>в браузере и видим, что счетчик увеличился на единицу.

38 Мы можем бесконечно увеличивать счетчик, и в любой момент при переходе на страницу<a>http://localhost/counter</a>мы получим текущее значение счетчика.

39 Так мы реализовали веб-приложение, которое умеет обрабатывать HTTP-запросы с разными методами, но одинаковыми путями.

40 Во всех примерах мы описывали статичные пути, когда запрос точно совпадает с описанным путем обработчика. В некоторых приложениях такого подхода недостаточно из-за дополнительных требований. Разберем, как их можно реализовать.

41 <h2>Что такое динамический роутинг и как его реализовать</h2>

42 Представим, что нам необходимо усложнить веб-приложение онлайн-счетчика и добавить возможность работать со счетчиками различных событий. Нам нужно, чтобы у каждого типа события было несколько счетчиков.

43 Чтобы работать с различными счетчиками, добавим возможность указывать название события в пути запроса. Например, для события click будет путь запроса /counter/click, а для события view - путь запроса /counter/view. Событий может быть много, поэтому нам нужно описать их. Для этого используемдинамический роутинг.

44 Динамический роутинг позволяет указывать часть пути HTTP-запроса, которая будет изменяться в зависимости от запроса. Например, в нашем случае мы можем указать, что часть пути запроса /counter будет всегда одинаковой. При этом вторая часть пути запроса будет меняться в зависимости от события /counter/:event:

45 Запустим приложение и проверим его работу. Для начала увеличим счетчик нескольких событий, а затем проверим, что у них корректное состояние:

46 <ol><li>Отправим POST-запрос на http://localhost/counter/clicks три раза</li>

47 <li>Откроем в браузере страницу http://localhost/counter/clicks и проверим, что счетчик события clicks равен трем</li>

48 <li>Отправим POST-запрос на http://localhost/counter/views два раза</li>

49 <li>Откроем в браузере страницу http://localhost/counter/views и проверим, что счетчик события views равен двум</li>

50 </ol>Мы увеличили счетчики двух событий:clicksиviews. После этого мы получили и проверили значения обоих счетчиков. Благодаря динамическому роутингу мы работали с двумя событиями, при этом использовали одни и те же обработчики. При необходимости мы можем добавлять новые события и не менять код обработчиков.

51 <h2>Выводы</h2>

52 В этом уроке мы разобрали, что такое роутинг - это процесс сопоставления HTTP-запроса с обработчиком, который будет обрабатывать этот запрос. Еще его называют маршрутизацией. Роутинг осуществляется с помощью путей и методов запроса, а динамический роутинг позволяет обрабатывать запросы с разными путями, и при этом использовать один обработчик.