По какому параметру ориентироваться в inject

Как выбрать правильный параметр для внедрения зависимостей?

Отличный вопрос о внедрении зависимостей (Dependency Injection) — одном из ключевых паттернов в Java. Ответ зависит от того, какие параметры у тебя есть.

Основной принцип

При внедрении зависимостей (в Spring, Google Guice и др.) контейнер должен однозначно определить, какую реализацию внедрить. Для этого он ориентируется на несколько параметров, в порядке приоритета:

1. Тип (Type) — самый важный параметр

// Spring сканирует тип и ищет подходящий бин
@Service
public class UserService {
    // Сколько реализаций UserRepository — Spring выберет по типу
    private final UserRepository repository;
    
    @Autowired
    public UserService(UserRepository repository) {
        this.repository = repository; // Ориентируемся на ТИП
    }
}

// Реализации
@Repository
public class JpaUserRepository implements UserRepository { }

@Repository
public class MongoUserRepository implements UserRepository { }

Проблема: есть две реализации UserRepository! Как Spring выберет?

2. Имя параметра — второй уровень разрешения

Если несколько реализаций интерфейса, Spring ориентируется на имя переменной:

@Service
public class UserService {
    // Spring ищет бин с именем "jpaUserRepository" (по имени переменной)
    @Autowired
    private UserRepository jpaUserRepository;
    
    // или по имени параметра конструктора
    public UserService(UserRepository jpaUserRepository) {
        this.repository = jpaUserRepository; // Имя параметра совпадает с бином!
    }
}

// Конфигурация
@Bean
public UserRepository jpaUserRepository() {
    return new JpaUserRepository(); // Имя метода = имя бина
}

@Bean
public UserRepository mongoUserRepository() {
    return new MongoUserRepository();
}

3. @Qualifier — явное уточнение

Если имя параметра не совпадает с именем бина, используй @Qualifier:

@Service
public class UserService {
    @Autowired
    @Qualifier("jpaUserRepository") // Явно указываем, какую реализацию внедрить
    private UserRepository repository;
    
    // или в конструкторе
    public UserService(
            @Qualifier("jpaUserRepository") UserRepository repository) {
        this.repository = repository;
    }
}

4. @Primary — значение по умолчанию

Отметь одну реализацию как главную:

@Repository
@Primary // Если есть несколько реализаций, внедрять эту
public class JpaUserRepository implements UserRepository { }

@Repository
public class MongoUserRepository implements UserRepository { }

// В контроллере
@Controller
public class UserController {
    @Autowired
    private UserRepository repository; // Внедрится JpaUserRepository
}

Порядок разрешения зависимостей в Spring

Spring ориентируется в этом порядке:

1. Точный тип (Class) + Qualifier
   ↓
2. Точный тип (Interface) + Primary
   ↓
3. Точный тип + имя переменной совпадает с именем бина
   ↓
4. Точный тип + @Qualifier
   ↓
5. Если ничего не подошло → NoUniqueBeanDefinitionException

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

// Конфигурация
@Configuration
public class AppConfig {
    @Bean
    public UserRepository jpaRepository() {
        return new JpaUserRepository();
    }
    
    @Bean
    public UserRepository mongoRepository() {
        return new MongoUserRepository();
    }
    
    @Bean
    public UserRepository cacheRepository() {
        return new CacheUserRepository();
    }
}

// Сервис с явным выбором
@Service
public class UserService {
    private final UserRepository primaryRepository;
    
    // Способ 1: Qualifier по имени
    @Autowired
    public UserService(
            @Qualifier("jpaRepository") UserRepository repository) {
        this.primaryRepository = repository;
    }
}

// Или способ 2: Qualifier по пользовательскому имени
@Configuration
public class AppConfig {
    @Bean
    @Qualifier("main")
    public UserRepository jpaRepository() {
        return new JpaUserRepository();
    }
    
    @Bean
    @Qualifier("backup")
    public UserRepository mongoRepository() {
        return new MongoUserRepository();
    }
}

@Service
public class UserService {
    @Autowired
    @Qualifier("main")
    private UserRepository mainRepository;
    
    @Autowired
    @Qualifier("backup")
    private UserRepository backupRepository;
}

Вкладка: Optional зависимости

Иногда зависимость может быть опциональной:

@Service
public class UserService {
    private final Optional<UserCache> cache;
    
    public UserService(Optional<UserCache> cache) {
        this.cache = cache; // Может быть пусто, если бина нет
    }
    
    public User getUser(Long id) {
        return cache
            .map(c -> c.get(id))
            .orElseGet(() -> loadFromDatabase(id));
    }
}

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

1. Предпочитай конструктор вместо поля

// ✅ Хорошо: явные зависимости, легче тестировать
@Service
public class UserService {
    private final UserRepository repository;
    private final UserValidator validator;
    
    public UserService(
            UserRepository repository,
            UserValidator validator) {
        this.repository = repository;
        this.validator = validator;
    }
}

// ❌ Плохо: скрытые зависимости, сложнее тестировать
@Service
public class UserService {
    @Autowired
    private UserRepository repository;
    
    @Autowired
    private UserValidator validator;
}

2. Используй интерфейсы, не реализации

// ✅ Хорошо: зависимость от интерфейса
public UserService(UserRepository repository) { }

// ❌ Плохо: зависимость от конкретного класса
public UserService(JpaUserRepository repository) { }

3. Одна реализация — не нужен Qualifier

// Если есть только одна реализация UserRepository
@Service
public class JpaUserRepository implements UserRepository { }

// Spring автоматически найдет и внедрит
@Autowired
private UserRepository repository; // Работает без Qualifier

4. Много реализаций — используй Qualifier или Primary

// Выбери один из способов:
// а) Qualifier
@Autowired
@Qualifier("mongo")

// б) Primary
@Repository
@Primary
public class JpaUserRepository { }

// в) Имя параметра совпадает с именем бина
@Autowired
public UserService(UserRepository mongoUserRepository) { }

Итог

Риентируйся в следующем порядке:

1. Тип — основной критерий (Interface/Class)
2. Имя параметра — если совпадает с именем бина
3. @Qualifier — для явного уточнения
4. @Primary — для значения по умолчанию

Это обеспечит правильное внедрение зависимостей и уменьшит количество ошибок на production.