Что такое spring.factories?

Файл spring.factories — это ключевой механизм, который Spring Boot использует для поддержки автоматической конфигурации и расширяемости. Он реализует паттерн Service Provider Interface (SPI), позволяя библиотекам и модулям объявлять свои компоненты, которые должны быть автоматически загружены в контекст приложения Spring.

Как это работает

Файл располагается по пути src/main/resources/META-INF/spring.factories внутри JAR-файла вашей библиотеки или приложения. Внутри него определяются пары «ключ-значение», где ключ — это полное имя интерфейса или абстрактного класса из Spring Boot, а значение — список полных имён классов, реализующих этот интерфейс.

Например, чтобы зарегистрировать собственную автоконфигурацию, вы можете добавить такую запись:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.MyCustomAutoConfiguration

Основные варианты использования

• Автоконфигурация: Ключ EnableAutoConfiguration позволяет вашим классам конфигурации автоматически подключаться при запуске приложения. Spring Boot сканирует все spring.factories в classpath и собирает все такие классы.
• Слушатели событий Application: Через ключ ApplicationListener можно зарегистрировать слушателей, которые будут реагировать на события жизненного цикла приложения (например, ApplicationReadyEvent).
• Прочие расширения: Существуют и другие ключи, например, для FailureAnalyzer (анализаторы ошибок), SpringApplicationRunListener (слушатели запуска) и т.д.

Практический пример

Допустим, мы создаём стартер, который автоматически настраивает кастомный сервис логирования. Сначала создадим класс автоконфигурации:

package com.example.starter;

import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class LoggingAutoConfiguration {
    @Bean
    @ConditionalOnMissingBean
    public LoggingService loggingService() {
        return new DefaultLoggingService();
    }
}

Затем в файле src/main/resources/META-INF/spring.factories нашего стартера укажем:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.starter.LoggingAutoConfiguration

Теперь, когда другое приложение добавит наш стартер в зависимости, LoggingAutoConfiguration будет автоматически подхвачен, и бин LoggingService создастся в контексте Spring.

Эволюция в Spring Boot 2.7+

Начиная с Spring Boot 2.7, рекомендуется постепенно переходить с spring.factories на новый механизм — регистрацию автоконфигураций через файл META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports. В нём просто перечисляются полные имена классов конфигурации, по одному на строку. Это более простой и современный подход.

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