Начало работы

Если вы начинаете работу со Spring Boot или вообще со Spring, начните с этого раздела. Он отвечает на основные вопросы «что?», «как?» и «почему?». Он включает введение в Spring Boot, а также инструкции по установке. Затем мы покажем вам, как создать ваше первое приложение Spring Boot, обсуждая некоторые основные принципы по ходу дела.

1. Введение в Spring Boot

Spring Boot помогает создавать автономные приложения Spring, пригодные для рабочей среды, которые можно запускать. Мы используем предопределённый подход к платформе Spring и сторонним библиотекам, чтобы вы могли начать работу с минимальными усилиями. Большинству приложений Spring Boot требуется очень мало конфигурации Spring.

Вы можете использовать Spring Boot для создания приложений Java, которые можно запустить с помощью java -jar или более традиционных развертываний war.

Наши основные цели:

Обеспечить радикально более быстрый и широко доступный опыт начала работы для всех разработчиков Spring.
Иметь предопределённый подход по умолчанию, но быстро уходить на второй план, когда требования начинают отличаться от значений по умолчанию.
Предоставлять различные нефункциональные функции, которые характерны для широкого класса проектов (такие как встроенные серверы, безопасность, метрики, проверки состояния и внешняя конфигурация).
Абсолютно никакой генерации кода (если не применяется нативный образ) и никаких требований к конфигурации XML.

2. Требования к системе

Spring Boot 3.1.3 требует Java 17 и совместим до и включая Java 20. Также требуется Spring Framework 6.0.11 или выше.

Явная поддержка сборки предоставляется для следующих инструментов сборки:

Инструмент сборки	Версия
Maven	3.6.3 или более поздняя
Gradle	7.x (7.5 или более поздняя) и 8.x

Инструмент сборки

Версия

Maven

3.6.3 или более поздняя

Gradle

7.x (7.5 или более поздняя) и 8.x

2.1. Контейнеры сервлетов

Spring Boot поддерживает следующие встроенные контейнеры сервлетов:

Имя	Версия сервлета
Tomcat 10.1	6.0
Jetty 11.0	5.0
Undertow 2.3	6.0

Вы также можете развернуть приложения Spring Boot в любом сервлете, совместимом с 5.0+.

2.2. GraalVM Native Images

Приложения Spring Boot могут быть преобразованы в нативный образ с помощью GraalVM 22.3 или более поздней версии.

Образы могут быть созданы с использованием плагинов Gradle/Maven средств native build tools или инструмента native-image, предоставляемого GraalVM. Вы также можете создавать нативные образы с помощью native-image Paketo buildpack.

Поддерживаются следующие версии:

Название	Версия
GraalVM Community	22.3
Native Build Tools	0.9.24

Название

Версия

GraalVM Community

22.3

Native Build Tools

0.9.24

3. Установка Spring Boot

Spring Boot можно использовать с традиционными инструментами разработки Java или установить как инструмент командной строки. В любом случае, вам нужен Java SDK v17 или выше. Перед началом работы вы должны проверить текущую установку Java, используя следующую команду:

$ java -version

Если вы новичок в разработке Java или хотите поэкспериментировать с Spring Boot, вы можете сначала попробовать Spring Boot CLI (интерфейс командной строки). В противном случае, читайте дальше для инструкций по установке «классическим» способом.

3.1. Инструкции по установке для разработчика Java

Вы можете использовать Spring Boot так же, как и любой стандартный Java-библиотеку. Для этого включите соответствующие spring-boot-*.jar файлы в вашу рабочую область. Spring Boot не требует интеграции с какими-либо специальными инструментами, поэтому вы можете использовать любой IDE или текстовый редактор. Также нет ничего особенного в приложении Spring Boot, поэтому вы можете запускать и отлаживать приложение Spring Boot так же, как и любое другое Java-программу.

Хотя вы можете скопировать JAR-файлы Spring Boot, мы рекомендуем использовать инструмент сборки, поддерживающий управление зависимостями (такой как Maven или Gradle).

3.1.1. Установка Maven

Spring Boot совместим с Apache Maven 3.6.3 и более поздними версиями. Если у вас еще нет Maven, вы можете следовать инструкциям на сайте maven.apache.org.

На многих операционных системах Maven можно установить с помощью менеджера пакетов. Если вы используете OSX Homebrew, попробуйте brew install maven. Пользователи Ubuntu могут запустить sudo apt-get install maven. Пользователи Windows с Chocolatey могут запустить choco install maven из командной строки с правами администратора.

Зависимости Spring Boot используют org.springframework.boot id группы. Обычно ваш файл Maven POM наследуется от проекта spring-boot-starter-parent и объявляет зависимости от одного или нескольких “Стартеров”. Spring Boot также предоставляет необязательный плагин Maven для создания исполняемых JAR-файлов.

Дополнительные сведения о работе с Spring Boot и Maven можно найти в разделе Начало работы справочного руководства по плагину Maven.

3.1.2. Установка Gradle

Spring Boot совместим с Gradle 7.x (7.5 или выше) и 8.x. Если у вас еще нет Gradle, вы можете следовать инструкциям на сайте gradle.org.

Зависимости Spring Boot могут быть объявлены, используя org.springframework.boot group. Обычно в вашем проекте объявляются зависимости от одного или нескольких “Стартеров”. Spring Boot предоставляет полезный плагин Gradle, который можно использовать для упрощения объявления зависимостей и создания исполняемых JAR-файлов.

Обёртка Gradle

Обёртка Gradle предоставляет удобный способ «получения» Gradle при необходимости построения проекта. Это небольшой скрипт и библиотека, которые вы коммитите вместе с кодом для запуска процесса сборки. Подробнее см. docs.gradle.org/current/userguide/gradle_wrapper.html.

Дополнительные сведения о работе с Spring Boot и Gradle можно найти в разделе Начало работы справочного руководства по плагину Gradle.

3.2. Установка Spring Boot CLI

Spring Boot CLI (интерфейс командной строки) — это инструмент командной строки, который можно использовать для быстрого прототипирования с Spring.

Вам не нужно использовать CLI для работы с Spring Boot, но это быстрый способ создать приложение Spring без IDE.

3.2.1. Ручная установка

Вы можете загрузить дистрибутив Spring CLI с одного из следующих сайтов:

После загрузки следуйте инструкциям из файла INSTALL.txt из распакованного архива. В кратце, есть скрипт spring (spring.bat для Windows) в папке bin/ в файле .zip. В качестве альтернативы, вы можете использовать java -jar с файлом .jar (скрипт помогает убедиться, что переменная среды classpath установлена правильно).

3.2.2. Установка с помощью SDKMAN!

SDKMAN! (менеджер набора инструментов разработки) может использоваться для управления несколькими версиями различных бинарных SDK, включая Groovy и Spring Boot CLI. Загрузите SDKMAN! с sdkman.io и установите Spring Boot, выполнив следующие команды:

$ sdk install springboot
$ spring --version
Spring CLI v3.1.3

Если вы разрабатываете новые функции для CLI и хотите получить доступ к созданной вами версии, используйте следующие команды:

$ sdk install springboot dev /path/to/spring-boot/spring-boot-cli/target/spring-boot-cli-3.1.3-bin/spring-3.1.3/
$ sdk default springboot dev
$ spring --version
Spring CLI v3.1.3

Предыдущие инструкции устанавливают локальную инстанцию spring, называемую инстанцией dev. Она указывает на целевую папку сборки, поэтому каждый раз, когда вы перестраиваете Spring Boot, spring обновляется.

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

$ sdk ls springboot

================================================================================
Available Springboot Versions
================================================================================
> + dev
* 3.1.3

================================================================================
+ - local version
* - installed
> - currently in use
================================================================================

3.2.3. Установка с OSX Homebrew

Если вы работаете на Mac и используете Homebrew, вы можете установить Spring Boot CLI, выполнив следующие команды:

$ brew tap spring-io/tap
$ brew install spring-boot

Homebrew установит spring в /usr/local/bin.

Если вы не видите формулу, ваша установка brew может быть устаревшей. В этом случае, выполните brew update и повторите попытку.

3.2.4. Установка с MacPorts

Если вы работаете на Mac и используете MacPorts, вы можете установить Spring Boot CLI, выполнив следующую команду:

$ sudo port install spring-boot-cli

3.2.5. Завершение команд

Spring Boot CLI включает скрипты, которые обеспечивают завершение команд для оболочек BASH и zsh. Вы можете source скрипт (также имеющий имя spring) в любой оболочке или поместить его в ваш личный или системный файл инициализации bash-completion. В системе Debian системные скрипты находятся в <installation location>/shell-completion/bash, и все скрипты в этой директории выполняются при запуске новой оболочки. Например, для ручного выполнения скрипта, если вы установили его с помощью SDKMAN!, используйте следующие команды:

$ . ~/.sdkman/candidates/springboot/current/shell-completion/bash/spring
$ spring <HIT TAB HERE>
  grab  help  jar  run  test  version

Если вы устанавливаете Spring Boot CLI с помощью Homebrew или MacPorts, скрипты завершения команд автоматически регистрируются в вашей оболочке.

3.2.6. Установка с помощью Scoop (Windows)

Если вы работаете на Windows и используете Scoop, вы можете установить Spring Boot CLI, выполнив следующие команды:

> scoop bucket add extras
> scoop install springboot

Scoop устанавливает spring в ~/scoop/apps/springboot/current/bin.

Если вы не видите манифест приложения, ваша установка scoop может быть устаревшей. В этом случае, выполните scoop update и повторите попытку.

4. Разработка вашего первого приложения Spring Boot

В этом разделе описывается, как разработать небольшое веб-приложение «Hello World!», демонстрирующее некоторые ключевые особенности Spring Boot. Вы можете выбрать Maven или Gradle в качестве системы сборки.

Веб-сайт spring.io содержит множество руководств «Начало работы» guides, использующих Spring Boot. Если вам нужно решить конкретную задачу, проверьте их в первую очередь.

Вы можете сократить шаги, перейдя по ссылке start.spring.io и выбрав «Веб» стартер из поиска зависимостей. Это сгенерирует новую структуру проекта, чтобы вы могли начать кодирование сразу. Подробнее см. в руководстве пользователя start.spring.io.

4.1. Предварительные условия

Прежде чем начать, откройте терминал и выполните следующие команды, чтобы убедиться, что у вас установлена действительная версия Java:

$ java -version
openjdk version "17.0.4.1" 2022-08-12 LTS
OpenJDK Runtime Environment (build 17.0.4.1+1-LTS)
OpenJDK 64-Bit Server VM (build 17.0.4.1+1-LTS, mixed mode, sharing)

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

4.1.1. Maven

Если вы хотите использовать Maven, убедитесь, что Maven установлен:

$ mvn -v
Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
Maven home: usr/Users/developer/tools/maven/3.8.5
Java version: 17.0.4.1, vendor: BellSoft, runtime: /Users/developer/sdkman/candidates/java/17.0.4.1-librca

4.1.2. Gradle

Если вы хотите использовать Gradle, убедитесь, что Gradle установлен:

$ gradle --version

------------------------------------------------------------
Gradle 8.1.1
------------------------------------------------------------

Build time:   2023-04-21 12:31:26 UTC
Revision:     1cf537a851c635c364a4214885f8b9798051175b

Kotlin:       1.8.10
Groovy:       3.0.15
Ant:          Apache Ant(TM) version 1.10.11 compiled on July 10 2021
JVM:          17.0.7 (BellSoft 17.0.7+7-LTS)
OS:           Linux 6.2.12-200.fc37.aarch64 aarch64

4.2. Настройка проекта с помощью Maven

Нам нужно начать с создания файла Maven pom.xml. Файл pom.xml — это рецепт, используемый для сборки вашего проекта. Откройте ваш любимый текстовый редактор и добавьте следующее:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>myproject</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.3</version>
    </parent>

    <!-- Additional lines to be added here... -->

</project>

Приведенный выше пример должен обеспечить работоспособную сборку. Вы можете проверить его, выполнив mvn package (на данный момент вы можете проигнорировать предупреждение «jar будет пустым — нет содержимого для включения!»).

На этом этапе вы можете импортировать проект в IDE (большинство современных Java IDE включают встроенную поддержку Maven). Для простоты мы продолжаем использовать простой текстовый редактор в этом примере.

4.3. Настройка проекта с помощью Gradle

Нам нужно начать с создания файла Gradle build.gradle. Файл build.gradle — это скрипт сборки, используемый для сборки вашего проекта. Откройте ваш любимый текстовый редактор и добавьте следующее:

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.1.3'
}

apply plugin: 'io.spring.dependency-management'

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
}

Приведенный выше пример должен обеспечить работоспособную сборку. Вы можете проверить его, выполнив gradle classes.

На этом этапе вы можете импортировать проект в IDE (большинство современных Java IDE включают встроенную поддержку Gradle). Для простоты мы продолжаем использовать простой текстовый редактор в этом примере.

4.4. Добавление зависимостей Classpath

Spring Boot предоставляет ряд «Starters», которые позволяют добавлять jar-файлы в ваш classpath. «Starters» предоставляют зависимости, которые, вероятно, понадобятся при разработке конкретного типа приложения.

4.4.1. Maven

Большинство приложений Spring Boot используют spring-boot-starter-parent в разделе parent POM. spring-boot-starter-parent — это специальный стартер, который предоставляет полезные значения по умолчанию для Maven. Он также предоставляет раздел dependency-management, чтобы вы могли опустить version теги для «благословенных» зависимостей.

Поскольку мы разрабатываем веб-приложение, мы добавляем зависимость spring-boot-starter-web. Прежде чем это сделать, мы можем посмотреть, что у нас есть сейчас, выполнив следующую команду:

$ mvn dependency:tree

[INFO] com.example:myproject:jar:0.0.1-SNAPSHOT

Команда mvn dependency:tree выводит древовидное представление зависимостей вашего проекта. Вы можете увидеть, что spring-boot-starter-parent не предоставляет зависимостей самостоятельно. Чтобы добавить необходимые зависимости, отредактируйте свой pom.xml и добавьте зависимость spring-boot-starter-web непосредственно под разделом parent:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

Если вы снова запустите mvn dependency:tree, вы увидите, что теперь есть ряд дополнительных зависимостей, включая веб-сервер Tomcat и сам Spring Boot.

4.4.2. Gradle

Большинство приложений Spring Boot используют плагин org.springframework.boot Gradle. Этот плагин предоставляет полезные значения по умолчанию и задачи Gradle. Плагин io.spring.dependency-management Gradle предоставляет управление зависимостями, позволяя опустить version теги для «благословенных» зависимостей.

$ gradle dependencies

> Task :dependencies

------------------------------------------------------------
Root project 'myproject'
------------------------------------------------------------

Команда gradle dependencies выводит древовидное представление зависимостей вашего проекта. Сейчас в проекте нет зависимостей. Чтобы добавить необходимые зависимости, отредактируйте свой build.gradle и добавьте зависимость spring-boot-starter-web в раздел dependencies:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

Если вы снова запустите gradle dependencies, вы увидите, что теперь есть ряд дополнительных зависимостей, включая веб-сервер Tomcat и сам Spring Boot.

4.5. Написание кода

Чтобы завершить наше приложение, нам нужно создать один Java-файл. По умолчанию Maven и Gradle компилируют исходные файлы из src/main/java, поэтому вам нужно создать эту структуру директорий и затем добавить файл под названием src/main/java/MyApplication.java, содержащий следующий код:

Java

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@SpringBootApplication
public class MyApplication {

    @RequestMapping("/")
    String home() {
        return "Hello World!";
    }

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }

}

Kotlin

import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
import org.springframework.web.bind.annotation.RequestMapping
import org.springframework.web.bind.annotation.RestController

@RestController
@SpringBootApplication
class MyApplication {

    @RequestMapping("/")
    fun home() = "Hello World!"

}

fun main(args: Array<String>) {
    runApplication<MyApplication>(*args)
}

Хотя здесь немного кода, происходит довольно много. Мы рассмотрим важные части в следующих разделах.

4.5.1. Аннотации @RestController и @RequestMapping

Первая аннотация в нашем классе MyApplication — это @RestController. Это аннотация-стереотип. Она предоставляет подсказки для людей, читающих код, и для Spring, что класс выполняет определённую роль. В данном случае наш класс — веб-@Controller, поэтому Spring учитывает его при обработке входящих веб-запросов.

Аннотация @RequestMapping предоставляет информацию о маршрутизации. Она сообщает Spring, что любой HTTP-запрос с путем / должен быть сопоставлен с методом home. Аннотация @RestController сообщает Spring, что полученный строковый результат должен быть непосредственно передан обратно вызывающему объекту.

Аннотации @RestController и @RequestMapping — аннотации Spring MVC (они не специфичны для Spring Boot). Подробнее см. раздел MVC в документации по Spring Reference.

4.5.2. Аннотация @SpringBootApplication

Вторая аннотация на уровне класса — @SpringBootApplication. Эта аннотация является мета-аннотацией, она объединяет @SpringBootConfiguration, @EnableAutoConfiguration и @ComponentScan.

Из них аннотация, которая нас больше всего интересует здесь, — это @EnableAutoConfiguration. @EnableAutoConfiguration сообщает Spring Boot «предположить», как вы хотите настроить Spring, на основе добавленных jar-зависимостей. Поскольку spring-boot-starter-web добавила Tomcat и Spring MVC, автоматическая настройка предполагает, что вы разрабатываете веб-приложение, и настраивает Spring соответствующим образом.

Starters и Автонастройка

Автоматическая настройка предназначена для хорошей работы со «Starters», но эти два понятия не связаны напрямую. Вы можете свободно выбирать и комбинировать зависимости jar-файлов вне стартеров. Spring Boot по-прежнему делает всё возможное, чтобы настроить ваше приложение.

4.5.3. Метод «main»

Последняя часть нашего приложения — это метод main. Это стандартный метод, соответствующий соглашению Java для точки входа в приложение. Наш метод main делегирует Spring Boot классу SpringApplication, вызывая run. SpringApplication загружает наше приложение, запускает Spring, который, в свою очередь, запускает настроенный веб-сервер Tomcat. Мы должны передать MyApplication.class в качестве аргумента методу run, чтобы сообщить SpringApplication о том, какой является основным компонентом Spring. Массив args также передаётся для обработки аргументов командной строки.

4.6. Запуск примера

4.6.1. Maven

В данный момент ваше приложение должно работать. Поскольку вы использовали spring-boot-starter-parent POM, у вас есть полезная run цель, которую можно использовать для запуска приложения. Введите mvn spring-boot:run из корневого каталога проекта для запуска приложения. Вы должны увидеть вывод, подобный следующему:

$ mvn spring-boot:run

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v3.1.3)
....... . . .
....... . . . (log output here)
....... . . .
........ Started MyApplication in 0.906 seconds (process running for 6.514)

Если вы откроете веб-браузер по адресу localhost:8080, вы должны увидеть следующий вывод:

Hello World!

Для безопасного выхода из приложения нажмите ctrl-c.

4.6.2. Gradle

В данный момент ваше приложение должно работать. Поскольку вы использовали org.springframework.boot плагин Gradle, у вас есть полезная bootRun цель, которую можно использовать для запуска приложения. Введите gradle bootRun из корневого каталога проекта для запуска приложения. Вы должны увидеть вывод, подобный следующему:

$ gradle bootRun

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v3.1.3)
....... . . .
....... . . . (log output here)
....... . . .
........ Started MyApplication in 0.906 seconds (process running for 6.514)

Если вы откроете веб-браузер по адресу localhost:8080, вы должны увидеть следующий вывод:

Hello World!

Для безопасного выхода из приложения нажмите ctrl-c.

4.7. Создание исполняемого JAR-файла

Мы завершаем пример, создав полностью автономный исполняемый JAR-файл, который можно запустить в рабочей среде. Исполняемые JAR-файлы (иногда называемые «жирными JAR-файлами») — это архивы, содержащие скомпилированные классы вместе со всеми JAR-зависимостями, необходимыми вашему коду для выполнения.

Исполняемые JAR-файлы и Java

Java не предоставляет стандартного способа загрузки вложенных JAR-файлов (JAR-файлов, которые сами содержатся внутри JAR-файла). Это может быть проблематично, если вы хотите распространить автономное приложение.

Для решения этой проблемы многие разработчики используют «сверх» JAR-файлы. Сверх-JAR-файл упаковывает все классы из всех зависимостей приложения в один архив. Проблема этого подхода в том, что становится трудно понять, какие библиотеки включены в ваше приложение. Это также может быть проблематично, если одно и то же имя файла (но с разным содержимым) используется в нескольких JAR-файлах.

Spring Boot использует другой подход и позволяет вам непосредственно вкладывать JAR-файлы.

4.7.1. Maven

Для создания исполняемого JAR-файла нам нужно добавить spring-boot-maven-plugin в наш pom.xml. Для этого вставьте следующие строки сразу после раздела dependencies:

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

spring-boot-starter-parent POM включает конфигурацию <executions> для привязки цели repackage. Если вы не используете родительский POM, вам нужно объявить эту конфигурацию самостоятельно. Подробности см. в документации плагина.

Сохраните ваш pom.xml и запустите mvn package из командной строки следующим образом:

$ mvn package

[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building myproject 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] .... ..
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ myproject ---
[INFO] Building jar: /Users/developer/example/spring-boot-example/target/myproject-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:3.1.3:repackage (default) @ myproject ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------

Если вы посмотрите в каталог target, вы должны увидеть myproject-0.0.1-SNAPSHOT.jar. Размер файла должен быть около 18 МБ. Если вы хотите взглянуть внутрь, вы можете использовать jar tvf следующим образом:

$ jar tvf target/myproject-0.0.1-SNAPSHOT.jar

Вы также должны увидеть гораздо меньший файл с именем myproject-0.0.1-SNAPSHOT.jar.original в каталоге target. Это исходный JAR-файл, созданный Maven до его переупаковки Spring Boot.

Для запуска этого приложения используйте команду java -jar следующим образом:

$ java -jar target/myproject-0.0.1-SNAPSHOT.jar

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v3.1.3)
....... . . .
....... . . . (log output here)
....... . . .
........ Started MyApplication in 0.999 seconds (process running for 1.253)

Как и прежде, для выхода из приложения нажмите ctrl-c.

4.7.2. Gradle

Для создания исполняемого JAR-файла нам нужно запустить gradle bootJar из командной строки следующим образом:

$ gradle bootJar

BUILD SUCCESSFUL in 639ms
3 actionable tasks: 3 executed

Если вы посмотрите в каталог build/libs, вы должны увидеть myproject-0.0.1-SNAPSHOT.jar. Размер файла должен быть около 18 МБ. Если вы хотите взглянуть внутрь, вы можете использовать jar tvf следующим образом:

$ jar tvf build/libs/myproject-0.0.1-SNAPSHOT.jar

Для запуска этого приложения используйте команду java -jar следующим образом:

$ java -jar build/libs/myproject-0.0.1-SNAPSHOT.jar

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::  (v3.1.3)
....... . . .
....... . . . (log output here)
....... . . .
........ Started MyApplication in 0.999 seconds (process running for 1.253)

Как и прежде, для выхода из приложения нажмите ctrl-c.

5. Что читать дальше

Надеюсь, этот раздел дал вам основы Spring Boot и помог начать работу с собственными приложениями. Если вы ориентируетесь на задачи, вы можете перейти на spring.io и изучить некоторые из руководств по началу работы, которые решают конкретные задачи «Как это сделать с Spring?». У нас также есть справочная документация по Spring Boot, посвященная «Как сделать».

В противном случае, следующим логичным шагом является чтение using.html. Если вы действительно нетерпеливы, вы также можете перейти к чтению о функциях Spring Boot.