Может ли собственный стартер работать без предварительной настройки?

Ответ на вопрос о собственных стартерах Spring Boot

Может ли работать без предварительной настройки?

Да, собственный стартер (custom starter) может работать без явной конфигурации, но это зависит от правильной реализации автоконфигурации. Вот почему это возможно и как это устроено:

Механизм автоматической загрузки

Spring Boot использует SPI (Service Provider Interface) для автоматического обнаружения стартеров:

1. META-INF/spring.factories (deprecated в Spring Boot 2.7+) или META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
2. Spring Boot сканирует classpath при старте приложения
3. Все классы, перечисленные в этом файле, автоматически загружаются

// src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
com.mycompany.MyCustomAutoConfiguration

Пример минимального стартера

@Configuration
@AutoConfiguration
@ConditionalOnProperty(name = "my.feature.enabled", havingValue = "true", matchIfMissing = true)
public class MyCustomAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public MyService myService() {
        return new MyService();
    }
}

Здесь:

• @AutoConfiguration - разработчик не должен делать ничего явно
• @ConditionalOnMissingBean - bean создаётся только если его нет
• @ConditionalOnProperty - можно отключить через properties

Почему это работает без настройки?

Стартер включает три компонента:

1. Библиотека зависимостей - pom.xml с maven-metadata
2. spring-boot-starter- артефакт* - конфигурация Maven
3. Автоконфигурация - META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

Процесс загрузки:

1. Разработчик добавляет <dependency>my-custom-starter</dependency>
2. Maven загружает jar с стартером
3. Spring Boot находит META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
4. Автоматически инициализирует все бины из @Configuration класса
5. Условия (@Conditional*) проверяются в runtime

Когда нужна ручная настройка?

Упомянутый стартер "работает" автоматически, но могут потребоваться параметры:

# application.properties
my.feature.enabled=true
my.feature.timeout=5000
my.feature.retry-count=3

Типовые условия автозагрузки:

@ConditionalOnClass(SomeClass.class)        // Если класс в classpath
@ConditionalOnMissingClass("com.Old")       // Если класса нет
@ConditionalOnBean(DataSource.class)        // Если бин существует
@ConditionalOnMissingBean                   // Если бина нет
@ConditionalOnProperty(name="...")          // Если свойство true
@ConditionalOnWebApplication                // В web-приложении
@ConditionalOnNotWebApplication             // Не в web-приложении

Структура spring-boot-starter-X

my-custom-starter/
├── pom.xml (содержит зависимости, не код)
└── my-custom-starter-autoconfigure/
    ├── pom.xml
    ├── src/main/java/com/mycompany/MyCustomAutoConfiguration.java
    └── src/main/resources/META-INF/spring/
        org.springframework.boot.autoconfigure.AutoConfiguration.imports

Пример work-ready стартера

@Configuration
@AutoConfiguration
@EnableConfigurationProperties(MyProperties.class)
public class MyCustomAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public MyService myService(MyProperties props) {
        return new MyService(props.getTimeout(), props.getRetryCount());
    }
}

@ConfigurationProperties(prefix = "my.feature")
@Data
public class MyProperties {
    private boolean enabled = true;
    private int timeout = 1000;
    private int retryCount = 3;
}

Ключевые моменты

• Автоматическая загрузка - происходит без кода в приложении
• Zero-config - работает с дефолтными значениями
• Conditional logic - включается/отключается по условиям
• Overridable - разработчик может переопределить бины
• Properties-driven - настраивается через application.properties

Резюме

Собственный стартер работает без явной настройки благодаря Spring Boot SPI механизму и условным аннотациям. Достаточно добавить зависимость - остальное происходит автоматически. Это основная идея Spring Boot: "convention over configuration".