Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

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

2 В этом уроке мы разберем основные способы конфигурации фреймворка и ключевые опции, о которых полезно знать.

3 В конфигурацию фреймворка может входить:

4 <ul><li>Включение цветного вывода логов</li>

5 <li>Настройки сервера - порта или адреса, на котором сервер должен работать</li>

6 <li>Уровни логирования для разных компонентов фреймворка</li>

7 <li>Настройки взаимодействия с базой данных</li>

8 <li>Конфигурация библиотек</li>

9 </ul><h2>Конфигурационный файл</h2>

10 Основная конфигурация Spring Boot хранится в файлеapplication.yml, расположенном в директорииsrc/main/resources. По умолчанию этого файла нет. Его нужно создать в тот момент, когда что-то требует конфигурации:

11 Сейчас это основной, но не единственный способ настройки. До сих пор во многих статьях и документации можно встретить подход, основанный на файлахproperties. Сам файл называетсяapplication.properties. Его располагают в директорииsrc/main/resources:

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

13 <h2>Стандартные опции</h2>

14 Какие возможности по конфигурированию Spring Boot у нас есть? Обычно об этом узнают из статей или<a>документации</a>. Опций очень много, поэтому для удобства они сгруппированы по темам. Обратите внимание, что описание свойств сделано в форматеproperties- так удобнее.

15 Вот некоторые опции, которые стоит установить сразу:

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

17 <h2>Нестандартные опции</h2>

18 Конфигурация нужна не только для самого Spring Boot - ее можно использовать и для собственных нужд. Этим активно пользуются сторонние библиотеки. Обычно в их документации рекомендуется размещать опции в файлах по названию библиотек:src/main/resources/name.properties.

19 Spring Boot автоматически подхватывает эти файлы. Все опции можно хранить вapplication.yml, но сначала их нужно правильно перенести. Обсудим, как работает перенос. Если библиотека предлагает хранить опции в файлеname.properties, то в файлеapplication.ymlэти опции нужно расположить внутри ключаspring.

20 Для примера рассмотрим опции библиотекиinstancio, которая используется в наших тестах:

21 Еще можно добавлять свои опции. Обычно они хранятся на верхнем уровне:

22 Структура самих опций может быть любой. Тут действуем по задаче.

23 <h2>Использование опций</h2>

24 Любые опции можно использовать в коде напрямую, в том числе:

25 <ul><li>Опции, которые вы добавили сами</li>

26 <li>Опции, определенные Spring Boot</li>

27 <li>Опции, определенные сторонними библиотеками</li>

28 </ul>Во всех трех случаях подход не меняется. Ниже мы рассмотрим два способа их использования.

29 <h3>Аннотация @Value</h3>

30 Самый простой способ использовать опции - это аннотация @Value. Она подставляет значение в поле нужного класса - например, контроллера:

31 <h3>Объект с конфигурацией</h3>

32 Для примера представим, что опций много, и они нужны в разных местах. В таком случае подход с @Value неудобен - возникнет дублирование. Нам придется постоянно указывать полные пути в разных местах приложения и исправлять их вручную, если они поменяются.

33 Чтобы было удобнее, можно создать класс, объект которого Spring Boot автоматически заполнит данными из конфигурационного файла.

34 Предположим, что мы будем работать с пользователем по умолчанию. Для этого создадим конфигурацию, в которую поместим имя и возраст пользователя:

35 Чтобы получить доступ к этим опциям в коде, создадим класс, помеченный несколькими аннотациями:

36 Здесь мы видим три вида аннотаций:

37 <ul><li>Аннотации, которые генерируют геттеры и сеттеры, делая работу удобнее</li>

38 <li>Аннотация @Component, которая указывает, что Spring Boot должен воспринимать этот класс как часть системы</li>

39 <li>Аннотация @ConfigurationProperties, которая указывает, что этот класс отвечает за работу со свойствами под ключомuser</li>

40 </ul>Чтобы использовать этот класс, в любом другом классе создадим свойство, куда Spring Boot передает объект класса DefaultUserProperties, заполненный опциями. Дальше его можно использовать в обычном порядке: