Почему @Bean используется с методом?

Почему @Bean используется с методом?

Краткий ответ

@Bean используется с методом, потому что метод содержит логику создания объекта. Это позволяет контролировать процесс инициализации, конфигурации и управления жизненным циклом объекта, что невозможно сделать через простую аннотацию класса.

Понимание @Bean

Что делает @Bean

@Bean — это аннотация Spring, которая указывает, что метод производит Bean (управляемый объект Spring). Результат метода регистрируется в ApplicationContext (контейнере Spring).

@Configuration
public class AppConfig {
    
    @Bean
    public DataSource dataSource() {
        // Логика создания DataSource
        DataSource ds = new DataSource();
        ds.setUrl("jdbc:mysql://localhost/mydb");
        ds.setUsername("root");
        ds.setPassword("password");
        return ds;  // Этот объект станет Bean
    }
}

Почему не просто аннотировать класс

// ❌ Недостаточно просто аннотировать класс
@Component
public class DataSource {
    // Spring создает это через конструктор
    // Нет возможности сложной конфигурации!
}

// ✅ С @Bean мы контролируем создание
@Bean
public DataSource dataSource() {
    DataSource ds = new DataSource();
    // Сложная логика конфигурации
    ds.setUrl("...");
    ds.setConnectionPoolSize(20);
    // ... много других настроек
    return ds;
}

Причины использования @Bean с методом

1. Контроль процесса инициализации

@Configuration
public class AppConfig {
    
    @Bean
    public RestTemplate restTemplate(RestTemplateBuilder builder) {
        // Полный контроль над созданием
        return builder
            .setConnectTimeout(Duration.ofSeconds(5))
            .setReadTimeout(Duration.ofSeconds(10))
            .interceptors((request, body, execution) -> {
                // Добавляем логику
                request.getHeaders().set("Authorization", "Bearer token");
                return execution.execute(request, body);
            })
            .build();
    }
}

2. Условное создание (Conditional Beans)

@Configuration
public class AppConfig {
    
    @Bean
    @ConditionalOnProperty(name = "app.cache.enabled", havingValue = "true")
    public CacheManager cacheManager() {
        // Создается только если свойство app.cache.enabled = true
        return new RedisCacheManager();
    }
    
    @Bean
    @ConditionalOnMissingBean(CacheManager.class)
    public CacheManager defaultCacheManager() {
        // Резервный вариант, если предыдущий не создался
        return new SimpleCacheManager();
    }
}

3. Внедрение зависимостей в процесс создания

@Configuration
public class AppConfig {
    
    @Bean
    public UserService userService(UserRepository repo, 
                                    PasswordEncoder encoder,
                                    EmailService emailService) {
        // Spring автоматически внедрит зависимости
        UserService service = new UserService(repo, encoder);
        service.setEmailService(emailService);
        return service;
    }
}

4. Создание Beans из внешних библиотек

@Configuration
public class DatabaseConfig {
    
    @Bean
    public DataSource dataSource(DataSourceProperties props) {
        // Не можем аннотировать DataSource из postgresql драйвера
        // Поэтому используем @Bean метод
        return DataSourceBuilder
            .create()
            .url(props.getUrl())
            .username(props.getUsername())
            .password(props.getPassword())
            .driverClassName(props.getDriverClassName())
            .build();
    }
    
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}

5. Конфигурация в зависимости от профиля

@Configuration
public class DataSourceConfig {
    
    @Bean
    @Profile("dev")
    public DataSource devDataSource() {
        return new H2DataSource("jdbc:h2:mem:testdb");
    }
    
    @Bean
    @Profile("prod")
    public DataSource prodDataSource() {
        return new PostgreSQLDataSource("jdbc:postgresql://prod-db:5432/app");
    }
}

Сравнение @Bean vs @Component

// Способ 1: @Component (аннотация на классе)
@Component
public class UserService {
    public UserService() {
        // Spring вызовет конструктор
        // Ограниченная конфигурация
    }
}

// Способ 2: @Bean (метод в @Configuration)
@Configuration
public class Config {
    @Bean
    public UserService userService(UserRepository repo) {
        // Полная конфигурация и логика
        UserService service = new UserService();
        service.initialize();
        return service;
    }
}

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

Пример 1: Сложная конфигурация БД

@Configuration
public class DatabaseConfiguration {
    
    @Bean
    public DataSource dataSource(
            @Value("${db.url}") String url,
            @Value("${db.username}") String username,
            @Value("${db.password}") String password,
            @Value("${db.pool.size:10}") int poolSize) {
        
        HikariConfig config = new HikariConfig();
        config.setJdbcUrl(url);
        config.setUsername(username);
        config.setPassword(password);
        config.setMaximumPoolSize(poolSize);
        config.setMinimumIdle(5);
        config.setIdleTimeout(600000);
        config.setMaxLifetime(1800000);
        
        return new HikariDataSource(config);
    }
    
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
    
    @Bean
    public TransactionManager transactionManager(DataSource dataSource) {
        return new DataSourceTransactionManager(dataSource);
    }
}

Пример 2: Создание Beans с разными реализациями

@Configuration
public class ServiceConfiguration {
    
    @Bean
    @ConditionalOnProperty(
        name = "storage.type",
        havingValue = "s3"
    )
    public StorageService s3StorageService(AmazonS3 s3Client) {
        return new S3StorageService(s3Client);
    }
    
    @Bean
    @ConditionalOnProperty(
        name = "storage.type",
        havingValue = "local"
    )
    public StorageService localStorageService() {
        return new LocalStorageService("/var/app/storage");
    }
}

Пример 3: Bean с инициализацией и очисткой

@Configuration
public class CacheConfiguration {
    
    @Bean(initMethod = "init", destroyMethod = "destroy")
    public RedisConnectionFactory redisConnectionFactory() {
        RedisStandaloneConfiguration config = new RedisStandaloneConfiguration();
        config.setHostName("localhost");
        config.setPort(6379);
        return new LettuceConnectionFactory(config);
    }
}

public class RedisConnectionFactory {
    public void init() {
        // Вызывается после создания Bean
        System.out.println("Redis connection initialized");
    }
    
    public void destroy() {
        // Вызывается при shutdown приложения
        System.out.println("Redis connection closed");
    }
}

Ключевые преимущества @Bean метода

1. Явная логика создания — видно, как именно создается объект
2. Гибкость — можно использовать условия, циклы, вычисления
3. Работа с внешними библиотеками — можем обернуть классы, которые не можем модифицировать
4. Внедрение зависимостей — Spring автоматически передает нужные параметры
5. Множественные реализации — можем создавать разные Beans для разных ситуаций
6. Конфигурация через свойства — @Value и @ConditionalOnProperty

Выводы

• @Bean используется с методом, потому что нам нужна логика создания объекта
• Метод содержит инструкции по инициализации и конфигурации
• @Component аннотирует класс — Spring сам создает через конструктор
• @Bean предоставляет полный контроль над процессом создания Beans
• @Bean нужен для внешних библиотек — классов, которые мы не можем модифицировать
• Используй @Bean для сложной конфигурации, @Component для простых случаев