spring boot

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

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

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

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

• Обеспечьте радикально более быстрое и широко доступное начало работы для всей разработки Spring.

• Будьте самоуверенны, но быстро уходите с дороги, поскольку требования начинают отличаться от значений по умолчанию.

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

• Абсолютно никакой генерации кода и требований к настройке XML.

Установка и начало работы

Справочная документация включает подробные инструкции по установке, а также подробное руководство getting started .

Вот краткий тизер полного приложения Spring Boot на Java:

 import org.springframework.boot.*;import org.springframework.boot.autoconfigure.*;import org.springframework.web.bind.annotation.*;@RestController@SpringBootApplicationpublic class Пример {@RequestMapping("/")String home( ) {return "Привет, мир!";
	} public static void main(String[] args) {SpringApplication.run(Example.class, args);
	}

}

Получение помощи

У вас возникли проблемы с Spring Boot? Мы хотим помочь!

• Ознакомьтесь со справочной документацией, особенно с практическими рекомендациями — в них представлены решения наиболее распространенных вопросов.

• Изучите основы Spring — Spring Boot основан на многих других проектах Spring; посетите сайт Spring.io, чтобы найти множество справочной документации. Если вы новичок в Spring, попробуйте одно из руководств.

• Если вы выполняете обновление, прочтите примечания к выпуску, чтобы получить инструкции по обновлению и «новые и заслуживающие внимания» функции.

• Задайте вопрос — мы отслеживаем stackoverflow.com на предмет вопросов, отмеченных тегом spring-boot . Вы также можете общаться с сообществом Gitter.

• Сообщайте об ошибках Spring Boot по адресу github.com/spring-projects/spring-boot/issues.

Отчеты о проблемах

Spring Boot использует интегрированную систему отслеживания проблем GitHub для записи ошибок и запросов функций. Если вы хотите поднять проблему, следуйте приведенным ниже рекомендациям:

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

• Если проблема еще не существует, создайте новую проблему.

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

• Если вам нужно вставить код или включить трассировку стека, используйте Markdown. ``` экранируется до и после вашего текста.

• Если возможно, попробуйте создать тестовый пример или проект, воспроизводящий проблему, и привязать его к проблеме.

Сборка из исходного кода

Вам не нужно выполнять сборку из исходного кода, чтобы использовать Spring Boot (бинарные файлы в repo.spring.io), но если вы хотите опробовать новейшую и лучшую версию, Spring Boot можно собрать и опубликовать в локальном кеше Maven с помощью Gradle. обертка. Вам также понадобится JDK 17.

 $ ./gradlew публикацииToMavenLocal

Это создаст все jar-файлы и документацию и опубликует их в локальном кеше Maven. Он не будет запускать ни один из тестов. Если вы хотите построить все, используйте задачу build :

 $ ./gradlew сборка

Модули

В Spring Boot есть несколько модулей. Вот краткий обзор:

пружинный ботинок

Основная библиотека, предоставляющая функции, поддерживающие другие части Spring Boot. К ним относятся:

• Класс SpringApplication , предоставляющий статические удобные методы, которые можно использовать для написания автономного приложения Spring. Его единственная задача — создать и обновить соответствующий Spring ApplicationContext .

• Встроенные веб-приложения с возможностью выбора контейнера (Tomcat, Jetty или Undertow).

• Первоклассная внешняя поддержка конфигурации.

• Удобство инициализаторов ApplicationContext , включая поддержку разумных значений по умолчанию для ведения журнала.

весна-загрузка-автоконфигурация

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

Автоконфигурация пытается определить, какие bean-компоненты могут понадобиться пользователю. Например, если HSQLDB находится в пути к классам, а пользователь не настроил никаких подключений к базе данных, то он, вероятно, захочет определить базу данных в памяти. Автоматическая настройка всегда отменяется, когда пользователь начинает определять свои собственные bean-компоненты.

весна-загрузка-стартеры

Стартеры — это набор удобных дескрипторов зависимостей, которые вы можете включить в свое приложение. Вы получаете универсальный магазин для всех необходимых вам Spring и связанных с ним технологий без необходимости искать примеры кода и копировать и вставлять множество дескрипторов зависимостей. Например, если вы хотите начать использовать Spring и JPA для доступа к базе данных, включите в свой проект зависимость spring-boot-starter-data-jpa , и все готово.

пружинно-загрузочный привод

Конечные точки исполнительного механизма позволяют отслеживать ваше приложение и взаимодействовать с ним. Spring Boot Actuator предоставляет инфраструктуру, необходимую для конечных точек привода. Он содержит поддержку аннотаций для конечных точек привода. Этот модуль предоставляет множество конечных точек, включая HealthEndpoint , EnvironmentEndpoint , BeansEndpoint и многие другие.

весна-загрузка-привод-автоконфигурация

Это обеспечивает автоматическую настройку конечных точек исполнительного механизма на основе содержимого пути к классам и набора свойств. Например, если Micrometer находится в пути к классам, он автоматически настроит MetricsEndpoint . Он содержит конфигурацию для предоставления конечных точек через HTTP или JMX. Как и в случае с Spring Boot AutoConfigure, это действие отступит, когда пользователь начнет определять свои собственные bean-компоненты.

весенний загрузочный тест

Этот модуль содержит основные элементы и аннотации, которые могут быть полезны при тестировании вашего приложения.

весна-загрузка-тест-автоконфигурация

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

пружинный загрузчик

Spring Boot Loader предоставляет секретный соус, который позволяет вам создать один jar-файл, который можно запустить с помощью java -jar . Как правило, вам не нужно напрямую использовать spring-boot-loader , а вместо этого работать с плагином Gradle или Maven.

весна-загрузка-devtools

Модуль Spring-boot-devtools предоставляет дополнительные функции во время разработки, такие как автоматический перезапуск, для более плавной разработки приложений. Инструменты разработчика автоматически отключаются при запуске полностью упакованного приложения.

Путеводители

Сайт Spring.io содержит несколько руководств, которые шаг за шагом показывают, как использовать Spring Boot:

• Создание приложения с помощью Spring Boot — это вводное руководство, в котором показано, как создать приложение, запустить его и добавить некоторые службы управления.

• Создание веб-службы RESTful с помощью Spring Boot Actuator — это руководство по созданию веб-службы REST, а также показано, как можно настроить сервер.

Лицензия

Spring Boot — это программное обеспечение с открытым исходным кодом, выпущенное под лицензией Apache 2.0.