Что такое автоконфигурация?

Автоконфигурация в Spring Boot

Автоконфигурация (Auto Configuration) — это мощная возможность Spring Boot, которая автоматически настраивает приложение на основе зависимостей, присутствующих в classpath и других факторов. Это позволяет разработчикам быстро создавать рабочие приложения с минимальной конфигурацией.

Как работает автоконфигурация

Spring Boot сканирует classpath при запуске и автоматически создает бины (beans) для обнаруженных библиотек. Например, если в pom.xml добавлена зависимость spring-boot-starter-web, то автоматически настраиваются:

• Embedded Tomcat сервер
• DispatcherServlet
• Jackson для JSON сериализации
• Встроенный контейнер сервлетов

Механизм автоконфигурации

1. META-INF/spring.factories (Spring Boot < 2.7)

Spring Boot ищет файл spring.factories в каждом JAR файле на classpath:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.MyDatabaseAutoConfiguration,\
com.example.MyWebAutoConfiguration

2. META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (Spring Boot >= 2.7)

В новых версиях используется более простой и явный формат:

com.example.MyDatabaseAutoConfiguration
com.example.MyWebAutoConfiguration

Создание собственной автоконфигурации

@Configuration
@ConditionalOnClass(DataSource.class) // Активировать только если класс есть в classpath
@EnableConfigurationProperties(DatabaseProperties.class)
public class MyDatabaseAutoConfiguration {
    
    @Bean
    @ConditionalOnMissingBean // Создать бин только если его еще нет
    public DataSource dataSource(DatabaseProperties props) {
        HikariConfig config = new HikariConfig();
        config.setJdbcUrl(props.getUrl());
        config.setUsername(props.getUsername());
        config.setPassword(props.getPassword());
        config.setMaximumPoolSize(props.getMaxPoolSize());
        
        return new HikariDataSource(config);
    }
    
    @Bean
    @ConditionalOnMissingBean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

Свойства конфигурации

Автоконфигурация использует переменные из application.properties или application.yml:

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: password
    hikari:
      maximum-pool-size: 20
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true
  mvc:
    throw-exception-if-no-handler-found: true

Условные аннотации

Для контроля автоконфигурации используются условные аннотации:

@ConditionalOnClass(SomeClass.class)           // Если класс есть
@ConditionalOnMissingClass(SomeClass.class)    // Если класса нет
@ConditionalOnBean(SomeService.class)          // Если бин существует
@ConditionalOnMissingBean(SomeService.class)   // Если бина нет
@ConditionalOnProperty(                        // По свойству
    name = "feature.enabled",
    havingValue = "true",
    matchIfMissing = false
)
@ConditionalOnWebApplication                   // Для веб приложений

Отключение автоконфигурации

Можно исключить конкретные классы автоконфигурации:

@SpringBootApplication(
    exclude = {DataSourceAutoConfiguration.class, 
               HibernateJpaAutoConfiguration.class}
)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

Или через application.properties:

spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

Отладка автоконфигурации

Для просмотра какие конфигурации применены:

java -jar app.jar --debug

Вывод покажет:

• Positive matches (применённые)
• Negative matches (не применённые)
• Unconditional classes (безусловные)

Преимущества и недостатки

Преимущества:

• Минимальная конфигурация
• Работает "из коробки" (convention over configuration)
• Можно переопределить любые настройки
• Совместимость версий

Недостатки:

• Магия — не всегда понятно что происходит
• Сложнее отлаживать проблемы
• Может быть лишняя конфигурация, которая не используется

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