Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы разберем основные элементы Spring Boot для работы с HTTP на примере CRUD приложения для создания страниц сайта. Под такими страницами обычно понимают что-то подобное:

2 Нам понадобится модель страницы. Для начала создадим класс Page с тремя полями:

3 <ul><li>slug- слаг (идентификатор, который используется для построения ссылок)</li>

4 <li>name- имя страницы</li>

5 <li>body- содержимое страницы</li>

6 </ul>Структура директорий может быть любой, потому что Spring не накладывает ограничений на нее. Мы будем придерживаться общепринятых стандартов и хранить наши файлы так, как принято в реальных проектах. Например, модели часто кладут в директориюmodel:

7 Следующий шаг - реализуем пять CRUD-маршрутов:

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

9 Взаимодействие с этим приложением с использованием консольной утилиты http для выполнения запросов выглядит так:

10 Наше приложение возвращает данные в JSON-формате, причем в зависимости от ситуации:

11 <ul><li>Приложение возвращает объект, если мы работаем с одиночным ресурсом - например, созданием</li>

12 <li>Приложение возвращает массив, если мы работаем с коллекцией - например, списком</li>

13 </ul>Подробнее на эту тему мы поговорим в уроке про REST API.

14 Рассмотрим пример кода такого приложения:

15 Сначала разберем общие концепции, а затем поговорим о каждом обработчике в отдельности.

16 Над классом приложения добавлена аннотация @RestController. Эта аннотация указывает на классы, которые содержат обработчики маршрутов. Пока мы помещаем обработчики в том же классе, в котором стартует приложение - так проще. В будущем мы будем размещать обработчики в контроллерах.

17 Каждый обработчик помечен аннотацией описания маршрута. Эти аннотации отвечают за то, какой маршрут обрабатывает обработчик и какой метод HTTP при этом используется. Это не одна аннотация, а набор аннотаций под каждый HTTP-метод - @GetMapping(), @DeleteMapping и так далее.

18 Каждый обработчик возвращает либо коллекцию объектов, либо объект, либо ничего не возвращает. А как Java-сущности превращаются в JSON? Это происходит автоматически с помощью библиотеки Jackson. Она входит в пакетspring-boot-starter-json, который подключается черезspring-boot-starter-web.

19 Автоматическая конвертация - это очень удобная штука, которая убирает шаблонный код.

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

21 <h2>Добавление страницы</h2>

22 Обработчик добавления страницы принимает на вход данные страницы, добавляет их в коллекцию страниц и возвращает эти же данные наружу:

23 Обсудим, как данные из HTTP-тела попадают в код. Это происходит с помощью аннотации @RequestBody, которой помечается переменная с типом Page. Имя переменной не важно. Spring Boot автоматически создает объект этого типа и заполняет его данными, которые были в теле. Для работы этого механизма имена полей в Page должны совпадать с именами в теле запроса. При этом данных может быть отправлено меньше, чем содержится в Page.

24 <h2>Показ страницы</h2>

25 Обработчик вывода страницы принимает на вход идентификатор, в качестве которого выступает слаг страницы. Затем обработчик ищет эту страницу в списке страниц и возвращает наружу. Страница может не найтись, поэтому возвращается Optional:

26 Здесь мы видим работу с параметрами пути в Spring Boot. В маршруте они указываются через фигурные скобки {id}, а в параметрах метода - извлекаются с помощью аннотации @PathVariable. Имя переменной должно совпадать с именем переменной в шаблоне, потому что происходит сопоставление.

27 <h2>Удаление страницы</h2>

28 Удаление страницы просто удаляет объект из списка страниц. Сам метод ничего не возвращает:

29 <h2>Список страниц</h2>

30 Вывод списка возвращает список страниц с возможностью указать лимит по выводу:

31 Лимит определяется параметром запроса localhost:8080/pages?limit=1. Параметры запроса попадают в код через параметры обработчика, помеченные аннотацией @RequestParam. У параметра можно задать значение по умолчанию в аннотации с помощью defaultValue. Имя переменной сопоставляется с именем параметра запроса.

32 <h2>Обновление страницы</h2>

33 Обновление устроено сложнее всего. Этот обработчик принимает на вход идентификатор обновляемой страницы и новые данные. Затем выполняется поиск необходимой страницы в общем списке. Если страница найдена, то выполняется ее обновление:

34 Здесь используются уже знакомые нам концепции, но они появляются вместе. Параметры в обработчиках могут идти в любом порядке, с любыми именами и допустимыми аннотациями. Технически вызов таких методов работает через механизм Reflection, который позволяет определить сигнатуру метода и правильно вызывать его в рантайме.