Как создать контроллер в Spring?

Создать контроллер в Spring можно несколькими способами:

1. С использованием аннотации @Controller: Используется для маркировки класса как компонента контроллера, обычно в сочетании с представлением (View).

   // Пример контроллера, возвращающего имя представления
   package com.example.demo.controller;
   
   import org.springframework.stereotype.Controller;
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @Controller
   @RequestMapping("/greet") // Базовый путь для этого контроллера
   public class GreetingController {
   
       @GetMapping("/hello") // Обрабатывает GET-запросы по пути /greet/hello
       public String sayHello() {
           return "hello"; // Возвращает имя представления (например, hello.html)
       }
   }
   

2. С использованием аннотации @RestController: Сочетает в себе функциональность @Controller и @ResponseBody, что означает, что возвращаемое значение метода напрямую преобразуется в формат ответа (например, JSON, XML) и отправляется клиенту. Часто используется для создания RESTful веб-сервисов.

   // Пример REST-контроллера
   package com.example.demo.controller;
   
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class DataController {
   
       @GetMapping("/data") // Обрабатывает GET-запросы по пути /data
       public String getData() {
           return "{\"message\": \"Это тестовые данные\"}"; // Возвращает JSON
       }
   }
   

3. Наследование от абстрактных классов (устаревший подход): В ранних версиях Spring использовалось наследование от классов, таких как AbstractController или ServletForwardingController. Этот подход считается устаревшим и менее гибким по сравнению с использованием аннотаций.

Наиболее распространенный и рекомендуемый способ создания контроллеров в современных Spring-приложениях — использование аннотаций @Controller и @RestController. Spring самостоятельно обнаруживает такие классы в classpath благодаря механизму сканирования компонентов и регистрирует их как контроллеры.

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

• @RequestMapping: Общий для всех HTTP-методов.
• @GetMapping: Для GET-запросов.
• @PostMapping: Для POST-запросов.
• @PutMapping: Для PUT-запросов.
• @DeleteMapping: Для DELETE-запросов.
• @PatchMapping: Для PATCH-запросов.

Понимание потока выполнения:

1. Клиент отправляет HTTP-запрос.
2. Spring DispatcherServlet перехватывает запрос.
3. На основе URL DispatcherServlet находит соответствующий метод в контроллере, используя аннотации @RequestMapping и его производные.
4. Метод контроллера обрабатывает запрос, выполняет необходимую логику (например, обращается к сервисам или репозиториям).
5. Если используется @Controller, метод возвращает логическое имя представления. DispatcherServlet использует ViewResolver для определения реального представления (например, файла HTML).
6. Если используется @RestController, возвращаемое значение метода преобразуется в формат ответа (например, JSON) и отправляется напрямую клиенту.