Кодик
Начать бесплатно

Как написать свой первый REST API на Spring Boot

Простое руководство для новичков: как создать первый REST API на Spring Boot, написать контроллеры и получить первые ответы в JSON.

Разработка

6 мин

Spring Boot давно стал стандартом для создания бэкенд-приложений на Java. Его сила в простоте и скорости: можно буквально за несколько минут поднять рабочий REST API. В этой статье разберёмся, как сделать первый шаг.

REST API — это способ общения между клиентом и сервером через HTTP-запросы. Несколько примеров:

  • GET /users — получить список пользователей

  • POST /users — создать нового пользователя

  • DELETE /users/1 — удалить пользователя с ID = 1

Шаг 1. Создаём проект

Быстрее всего стартовать через Spring Initializr:

  1. Указываем язык — Java.

  2. Выбираем зависимость: Spring Web.

  3. Скачиваем и открываем проект в IDE (IntelliJ IDEA, Eclipse или VS Code).

Шаг 2. Первый контроллер

В папке src/main/java создаём класс:


import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Привет, это мой первый REST API!";
    }
}

Что происходит?

  • @RestController — класс отвечает за REST-запросы.

  • @GetMapping("/hello") — обрабатывает GET-запрос по адресу /hello.

  • Метод возвращает строку, и она отображается в браузере.

Шаг 3. Запускаем приложение

В проекте уже есть класс с аннотацией @SpringBootApplication. Запускаем его. Переходим в браузере на http://localhost:8080/hello — и видим ответ от API. 🎉

Шаг 4. Работа с данными

Добавим список пользователей:


import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
public class UserController {

    @GetMapping("/users")
    public List<String> getUsers() {
        return List.of("Алиса", "Боб", "Ева");
    }
}

Теперь при запросе /users мы получим JSON:


["Алиса", "Боб", "Ева"]

Что дальше?

  • Добавить методы POST, PUT, DELETE.

  • Подключить базу данных (Spring Data JPA).

  • Настроить тесты и документацию (например, Swagger).

Вывод

Spring Boot позволяет быстро развернуть REST API: от первого запроса до работы с данными — всего несколько строк кода. Освоив базу, можно строить полноценные сервисы, от учебных проектов до микросервисов.

Чтобы чувствовать себя уверенно в Java и Spring Boot, важно понимать основы программирования. В приложении Кодик можно изучить Python, JavaScript, Lua и другие языки, пройти курсы и получить сертификат. Это отличная точка старта для перехода к серьёзным backend-фреймворкам.

А ещё у нас есть активный telegram-канал, где мы обсуждаем крутые идеи, делимся опытом и вместе разбираем задачи — учиться становится не только полезно, но и весело.

Комментарии