Spring boot — это платформа с открытым исходным кодом, разработанная компанией Pivotal, используемая для создания автономных приложений Spring производственного уровня с минимально возможной конфигурацией. Гибкость загрузки Spring позволяет объединять его приложения в виде файлов fat/uber, которые можно развернуть как простой файл jar. Вот почему Spring boot — отличный выбор для разработки микросервисных приложений на Java.

Spring boot — любимая среда разработки приложений Java для программистов, а REST — стандарт де-факто для разработки веб-API. В этом руководстве мы будем разрабатывать простой REST API для загрузки Spring, который возвращает «Hello World».

Весна и ОТДЫХ

Весенний ботинок

Spring — одна из старейших сред разработки приложений Enterprise Edition на Java. Он мощный, но легкий и может быть развернут в любом веб-контейнере, даже в Tomcat. Он работает быстрее, чем другие фреймворки, что делает его особенно популярным в мобильных вычислениях и удобен для разработчиков.

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

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

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

Простая кривая обучения Spring boot в сравнении и простота интеграции сделали его таким популярным среди многих компаний и стали одной из множества причин его популярности по сравнению с другими фреймворками.

REST/RESTful API

Помимо использования HTTP для простоты, REST предлагает ряд других преимуществ по сравнению со своими конкурентами:

  • REST позволяет использовать множество форматов данных, включая XML и JSON.
  • В сочетании с JSON REST обычно считается более простым в работе и более быстрым.
  • JSON, который стал отраслевым стандартом веб-API, REST предлагает лучшую поддержку веб-клиентов.
  • REST обеспечивает превосходную производительность за счет кэширования неизмененной и нединамической информации.
  • Его производительность и простота использования позволили ему стать протоколом, наиболее часто используемым крупными сервисами, такими как Yahoo, eBay, Amazon и даже Google.
  • REST обычно быстрее и использует меньшую пропускную способность. REST также легче интегрировать с существующими веб-сайтами без необходимости рефакторинга инфраструктуры сайта, что позволяет разработчикам работать быстрее, а не тратить время на переписывание сайта с нуля.

Одна из причин популярности REST API заключается в том, что он удобен для пользователя и понятен разработчикам. Разработка с REST проще, чем с другими API, когда вы действительно сосредоточены на данных. О популярности REST можно судить по тому, что сейчас он составляет более 70% общедоступных API, согласно данным Stormpath.

Создание нашего API

Что тебе понадобится

Для нашего проекта мы будем создавать проект Maven для примера Hello World. Таким образом, требуется, чтобы у нас были следующие инструменты и технологии для нашего проекта.

· Весенняя загрузка версии 2.2.2+

· Java8+

· Мавен 3.0+

· IDE на ваш выбор.

В этом руководстве мы будем использовать Spring Boot версии 2.3.10 и Java 8.

Шаг 1 — Создайте загрузочный проект Spring

Мы начнем с того, что перейдем к инициализатору Spring по адресу https://start.spring.io/. Разработчики Spring boot сделали возможным создание загрузочных проектов Spring в рекордно короткие сроки.

Как упоминалось ранее, мы будем использовать Maven для управления нашими зависимостями. Итак, в разделе проекта выберите Maven Project.

Для этого проекта мы будем использовать Spring boot версии 2.4.10, поэтому в разделе spring boot выберите Spring boot 2.4.10.

Выберите язык программирования по умолчанию, например Java, и jar в качестве упаковки, а также установленную версию Java. Для этого проекта мы будем использовать Java 8.

В разделе «Метаданные проекта» измените группу на «com.codacum», измените артефакт на «spring-boot-hello-world» и измените описание своего проекта на «Spring boot hello world».

Последним важным шагом является добавление необходимых зависимостей. Для этого проекта мы будем использовать только зависимость Spring Web, поэтому перейдите к кнопке добавления зависимости, где вы можете выполнить поиск и выбрать зависимость «Spring Web».

Если вы правильно выполнили все вышеперечисленные шаги, ваш экран должен выглядеть примерно так:

Теперь мы закончили создание нашего проекта, нажмите кнопку «Создать», чтобы загрузить zip-файл проекта в вашу систему.

Шаг 2 — Импортируйте свой проект в свою IDE

Далее мы будем импортировать наш проект в нашу IDE. Для этого шага вы можете использовать любую IDE по вашему выбору. Многие программисты используют Intellij IDE для своих проектов REST API, поскольку Intellij автоматически загружает зависимости Spring всякий раз, когда мы начинаем новые проекты. Другие IDE включают Eclipse и код Microsoft Visual Studio.

Найдите загруженный zip-файл и распакуйте его в любую папку. Запустите IDE, перейдите к файлам и откройте проект. Перейдите в папку, в которую вы распаковали свой проект, и нажмите «ОК», чтобы открыть.

Теперь Intellij автоматически загрузит все ваши зависимости для вашего проекта. Если по какой-то причине ваши зависимости не загружаются, выберите Maven на стороне поездки вашей IDE и обновите свою IDE. Это перезапустит вашу среду IDE и повторно инициирует загрузку ваших зависимостей. Если ваш проект был успешно импортирован, ваша IDE должна выглядеть примерно так:

Шаг 3 — Создание нашей конечной точки REST

На этом этапе мы создадим конечную точку REST, которая будет возвращать «Hello World!» нить. Мы закончили со всеми настройками, теперь давайте начнем писать код.

Для нашей конечной точки мы создадим новый пакет под названием «контроллер». Разверните каталог проекта и выберите com.codacuum.springboothelloworld. Щелкните правой кнопкой мыши и выберите «новый пакет» и введите имя пакета как «com.codacuum.springboothelloworld.controller».

При нажатии Enter будет создан новый пакет в разделе com.codacuum.springboothelloworld.

Щелкните правой кнопкой мыши новый пакет и выберите «новый класс Java». Введите имя класса как HelloWorldController и введите этот код в свой класс.

package com.codacuum.springboothelloworld.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RESTController;
@RESTController
public class HelloWorldController {
@GetMapping(“/hello-world”)
public String HelloWorld(){
return “Hello World”;
}
}

@RESTController — это аннотация весенней загрузки, которая информирует наше приложение о том, что наш класс HelloWorldController будет предоставлять конечные точки REST. Это поможет нам создавать веб-сервисы RESTful.

Точно так же аннотация @GetMapping используется для обработки HTTP-запросов GET. Запросы GET используются для получения исходников. «/hello-world» — это URI, необходимый для доступа к источнику.

HelloWorld() — это простой метод Java, возвращающий строку. В данном случае это строка «Hello World».

Шаг 4 — Проверьте нашу конечную точку HelloWorld

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

По умолчанию Spring boot заставляет сервер tomcat работать на порту 8080. Если вы хотите изменить порт по умолчанию, вы можете прочитать эту статью.

Затем откройте браузер и введите следующий URL-адрес: https://localhost:8080/hello-world. Вы должны увидеть сообщение Hello World в своем браузере:

Что дальше?

Поздравляем с завершением вашего первого проекта Spring boot и REST API. На этом мы приветствуем вас в мире Spring Boot. В этом руководстве вы узнали об основах загрузки Spring, о том, как настроить проект, добавить зависимости проекта и запустить API.

Таким образом, вы только немного коснулись того, на что способен Spring Boot, поскольку ваше путешествие по изучению Spring Boot и REST API только началось.