Как уточнить какой именно Bean заинжектить

Как уточнить какой Bean заинжектить в Spring

В Spring часто возникает ситуация, когда есть несколько реализаций одного интерфейса, и нужно указать, какой именно Bean инжектировать. Есть несколько способов решить эту проблему.

1. Аннотация @Qualifier

Самый распространённый способ — использовать @Qualifier для указания имени Bean.

// Интерфейс
public interface PaymentService {
    void processPayment(double amount);
}

// Первая реализация
@Service("creditCardPayment")
public class CreditCardPaymentService implements PaymentService {
    @Override
    public void processPayment(double amount) {
        System.out.println("Обработка платежа кредитной картой: " + amount);
    }
}

// Вторая реализация
@Service("paypalPayment")
public class PayPalPaymentService implements PaymentService {
    @Override
    public void processPayment(double amount) {
        System.out.println("Обработка платежа через PayPal: " + amount);
    }
}

// Использование @Qualifier для указания конкретного Bean
@Service
public class OrderService {
    private final PaymentService creditCardPaymentService;
    private final PaymentService paypalPaymentService;
    
    // Способ 1: через конструктор
    public OrderService(
        @Qualifier("creditCardPayment") PaymentService creditCardPaymentService,
        @Qualifier("paypalPayment") PaymentService paypalPaymentService
    ) {
        this.creditCardPaymentService = creditCardPaymentService;
        this.paypalPaymentService = paypalPaymentService;
    }
    
    public void processOrder(String paymentMethod, double amount) {
        if ("credit_card".equals(paymentMethod)) {
            creditCardPaymentService.processPayment(amount);
        } else if ("paypal".equals(paymentMethod)) {
            paypalPaymentService.processPayment(amount);
        }
    }
}

2. Аннотация @Primary

Используется для указания Bean по умолчанию, если не указан @Qualifier.

public interface DatabaseService {
    String getConnection();
}

// Основная реализация
@Service
@Primary
public class PostgreSQLService implements DatabaseService {
    @Override
    public String getConnection() {
        return "PostgreSQL Connection";
    }
}

// Альтернативная реализация
@Service
public class MongoDBService implements DatabaseService {
    @Override
    public String getConnection() {
        return "MongoDB Connection";
    }
}

// Использование
@Service
public class DataRepository {
    private final DatabaseService databaseService;
    
    // Будет инжектирован PostgreSQLService по умолчанию
    public DataRepository(DatabaseService databaseService) {
        this.databaseService = databaseService;
    }
}

3. Использование имени переменной

Spring может автоматически сопоставлять имя переменной с именем Bean.

@Service("emailNotification")
public class EmailNotificationService implements NotificationService {
    @Override
    public void notify(String message) {
        System.out.println("Email: " + message);
    }
}

@Service("smsNotification")
public class SMSNotificationService implements NotificationService {
    @Override
    public void notify(String message) {
        System.out.println("SMS: " + message);
    }
}

@Service
public class NotificationManager {
    private final NotificationService emailNotification;
    private final NotificationService smsNotification;
    
    // Имена переменных совпадают с именами Bean
    public NotificationManager(
        NotificationService emailNotification,
        NotificationService smsNotification
    ) {
        this.emailNotification = emailNotification;
        this.smsNotification = smsNotification;
    }
}

4. @Resource аннотация

JavaEE аннотация, которая также может использоваться в Spring.

@Service
public class ReportService {
    @Resource(name = "pdfReportGenerator")
    private ReportGenerator reportGenerator;
    
    public void generateReport() {
        reportGenerator.generate();
    }
}

5. Кастомные @Qualifier аннотации

Можно создать свои аннотации для более удобного использования.

// Создание кастомного Qualifier
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface CreditCard {}

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Qualifier
public @interface PayPal {}

// Использование
@Service
@CreditCard
public class CreditCardPaymentService implements PaymentService {
    @Override
    public void processPayment(double amount) {
        System.out.println("Credit Card: " + amount);
    }
}

@Service
@PayPal
public class PayPalPaymentService implements PaymentService {
    @Override
    public void processPayment(double amount) {
        System.out.println("PayPal: " + amount);
    }
}

// Инжекция с использованием кастомного Qualifier
@Service
public class PaymentProcessor {
    private final PaymentService creditCardService;
    private final PaymentService paypalService;
    
    public PaymentProcessor(
        @CreditCard PaymentService creditCardService,
        @PayPal PaymentService paypalService
    ) {
        this.creditCardService = creditCardService;
        this.paypalService = paypalService;
    }
}

6. ObjectProvider для гибкой инжекции

Obtain Bean в runtime.

@Service
public class PaymentService {
    private final ObjectProvider<CreditCardPayment> creditCardProvider;
    private final ObjectProvider<PayPalPayment> paypalProvider;
    
    public PaymentService(
        ObjectProvider<CreditCardPayment> creditCardProvider,
        ObjectProvider<PayPalPayment> paypalProvider
    ) {
        this.creditCardProvider = creditCardProvider;
        this.paypalProvider = paypalProvider;
    }
    
    public void process(String method) {
        if ("credit_card".equals(method)) {
            creditCardProvider.ifAvailable(payment -> payment.pay());
        } else if ("paypal".equals(method)) {
            paypalProvider.ifAvailable(payment -> payment.pay());
        }
    }
}

7. Конфигурационный класс с явной регистрацией Bean

@Configuration
public class PaymentConfig {
    
    @Bean(name = "creditCardPayment")
    public PaymentService creditCardPaymentService() {
        return new CreditCardPaymentService();
    }
    
    @Bean(name = "paypalPayment")
    public PaymentService paypalPaymentService() {
        return new PayPalPaymentService();
    }
    
    @Bean
    public OrderService orderService(
        @Qualifier("creditCardPayment") PaymentService creditCardPayment,
        @Qualifier("paypalPayment") PaymentService paypalPayment
    ) {
        return new OrderService(creditCardPayment, paypalPayment);
    }
}

Рекомендации

1. Используй @Qualifier — самый явный и понятный способ
2. Используй @Primary — когда один Bean явно по умолчанию
3. Избегай полагаться на имена переменных — менее явно
4. Используй кастомные Qualifiers — для сложных сценариев
5. Документируй выбор — объясни почему используется конкретный Bean

Правильное управление Bean инжекцией критично для создания чистого, понятного и maintainable Spring приложения.