Что нужно для конфигурации бинов?

Конфигурация бинов в Spring Framework

Что такое бин (Bean)

Bean — это объект, управляемый контейнером Spring. Вместо создания объектов самостоятельно с помощью new, мы описываем их конфигурацию, и Spring инстанцирует и управляет ими.

Способ 1: XML конфигурация (старый способ)

В файле applicationContext.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- Простой бин -->
    <bean id="userRepository" class="com.example.repository.UserRepository" />
    
    <!-- Бин с зависимостями через конструктор -->
    <bean id="userService" class="com.example.service.UserService">
        <constructor-arg ref="userRepository" />
    </bean>
    
    <!-- Бин с зависимостями через setter -->
    <bean id="userController" class="com.example.controller.UserController">
        <property name="userService" ref="userService" />
    </bean>
</beans>

Способ 2: Аннотации (современный способ)

@Component — базовая аннотация для регистрации класса как бина:

import org.springframework.stereotype.Component;

@Component
public class UserRepository {
    public User findById(Long id) {
        // реализация
    }
}

@Service — для бизнес-логики:

import org.springframework.stereotype.Service;

@Service
public class UserService {
    private final UserRepository userRepository;
    
    // Конструктор для внедрения зависимости
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }
    
    public User getUserById(Long id) {
        return userRepository.findById(id);
    }
}

@Repository — для работы с данными:

import org.springframework.stereotype.Repository;

@Repository
public class UserRepository {
    // реализация
}

@Controller — для web слоя:

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/users")
public class UserController {
    private final UserService userService;
    
    public UserController(UserService userService) {
        this.userService = userService;
    }
    
    @GetMapping("/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        return ResponseEntity.ok(userService.getUserById(id));
    }
}

Способ 3: Java конфигурация (@Configuration)

Используется для более сложных конфигураций:

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Bean;

@Configuration
public class AppConfig {
    
    // Методы с @Bean регистрируют результат как бин
    @Bean
    public UserRepository userRepository() {
        return new UserRepository();
    }
    
    @Bean
    public UserService userService(UserRepository userRepository) {
        return new UserService(userRepository);
    }
    
    @Bean
    public UserController userController(UserService userService) {
        return new UserController(userService);
    }
}

При таком подходе параметры методов автоматически разрешаются Spring — это autowiring.

Способ 4: @Autowired для внедрения зависимостей

Прямое внедрение через аннотацию:

import org.springframework.beans.factory.annotation.Autowired;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository; // Не рекомендуется!
    
    public User getUserById(Long id) {
        return userRepository.findById(id);
    }
}

Проблемы: сложнее тестировать, скрытые зависимости.

Лучше: использовать конструктор (constructor injection):

@Service
public class UserService {
    private final UserRepository userRepository; // Final - неизменяемо
    
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository; // Явная зависимость
    }
}

Включение сканирования компонентов

В @SpringBootApplication:

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication // Включает @ComponentScan по умолчанию
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Или явно:

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan(basePackages = "com.example")
public class AppConfig {
}

Области видимости (Scopes) бинов

import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Component;

// Singleton - один экземпляр на всё приложение (по умолчанию)
@Component
public class SingletonService { }

// Prototype - новый экземпляр при каждом запросе
@Component
@Scope("prototype")
public class PrototypeService { }

// Request scope - один экземпляр на HTTP запрос
@Component
@Scope("request")
public class RequestService { }

// Session scope - один экземпляр на сессию пользователя
@Component
@Scope("session")
public class SessionService { }

Условная регистрация бинов

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

@Configuration
public class MailConfig {
    
    @Bean
    @ConditionalOnProperty(name = "mail.enabled", havingValue = "true")
    public MailService mailService() {
        return new MailService();
    }
}

Именованные бины и квалификация

// Регистрация с именем
@Component("primaryUserService")
public class UserService { }

// Или через Bean
@Bean(name = "primaryUserService")
public UserService userService() {
    return new UserService();
}

// Использование
@Service
public class Controller {
    private final UserService userService;
    
    public Controller(@Qualifier("primaryUserService") UserService userService) {
        this.userService = userService;
    }
}

Проверка конфигурации

Для проверки что всё правильно конфигурировано:

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class Main {
    public static void main(String[] args) {
        ApplicationContext context = 
            new AnnotationConfigApplicationContext(AppConfig.class);
        
        String[] beanNames = context.getBeanDefinitionNames();
        for (String name : beanNames) {
            System.out.println(name);
        }
    }
}

Лучшие практики

• Используйте конструктор для внедрения зависимостей
• Предпочитайте аннотации XML конфигурации
• Используйте Java @Configuration для сложной логики
• Избегайте @Autowired на полях — используйте конструктор
• Делайте зависимости final для неизменяемости
• Регистрируйте явно через @Bean, когда нужна гибкость