Spring Boot 依赖注入（Dependency Injection, DI）

Spring Boot 依赖注入注解相关知识详解

1. 概述

依赖注入（Dependency Injection, DI）是 Spring 框架的核心特性之一，它通过将对象的依赖关系从代码中分离出来，使得代码更加模块化、可测试和可维护。Spring Boot 作为 Spring 框架的扩展，提供了更加简化的依赖注入方式。本文将详细讲解 Spring Boot 中常用的依赖注入注解。

2. 常用依赖注入注解

2.1 @Autowired

@Autowired 是 Spring 中最常用的依赖注入注解，它可以用于字段、构造器和方法上。

2.1.1 字段注入

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

2.1.2 构造器注入

@Service
public class UserService {

    private final UserRepository userRepository;

    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

2.1.3 方法注入

@Service
public class UserService {

    private UserRepository userRepository;

    @Autowired
    public void setUserRepository(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

2.2 @Qualifier

当存在多个相同类型的 Bean 时，可以使用 @Qualifier 注解来指定具体的 Bean。

@Service
public class UserService {

    @Autowired
    @Qualifier("userRepositoryImpl")
    private UserRepository userRepository;

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

@Qualifier("userRepositoryImpl") 中的 "userRepositoryImpl" 指定的是 Bean 的名称。在 Spring 中，Bean 的名称默认是类名的首字母小写形式，但也可以通过 @Component、@Service、@Repository、@Controller 等注解的 value 属性来显式指定。

例如：

@Repository("userRepositoryImpl")
public class UserRepositoryImpl implements UserRepository {
    // 实现代码
}

在这个例子中，UserRepositoryImpl 类的 Bean 名称被显式指定为 "userRepositoryImpl"。因此，在使用 @Autowired 和 @Qualifier 进行依赖注入时，可以这样写：

@Service
public class UserService {

    private final UserRepository userRepository;

    @Autowired
    public UserService(@Qualifier("userRepositoryImpl") UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    // 其他方法
}

这样，Spring 容器就会根据 @Qualifier 指定的名称 "userRepositoryImpl" 来找到对应的 Bean 并进行注入。

2.3 @Resource

@Resource 是 Java 标准注解，与 @Autowired 类似，但更灵活。它可以用于字段和方法上。

@Service
public class UserService {

    @Resource(name = "userRepositoryImpl")
    private UserRepository userRepository;

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

2.4 @Inject

@Inject 是 Java EE 标准注解，与 @Autowired 类似，但不需要 Spring 特定的依赖。

@Service
public class UserService {

    @Inject
    private UserRepository userRepository;

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

3. 依赖注入的原理

依赖注入的原理是通过 Spring 容器管理 Bean 的生命周期和依赖关系。Spring 容器在启动时会扫描所有的 Bean，并将它们实例化、组装并注入到需要的对象中。

4. 示例代码

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

@Repository
public class UserRepositoryImpl implements UserRepository {

    @Override
    public Optional<User> findById(Long id) {
        // 模拟数据库查询
        return Optional.of(new User(id, "John Doe"));
    }
}

@Service
public class UserService {

    private final UserRepository userRepository;

    @Autowired
    public UserService(@Qualifier("userRepositoryImpl") UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
}

@RestController
public class UserController {

    private final UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

在这个示例中，UserRepositoryImpl 是一个实现了 UserRepository 接口的 Bean，UserService 通过构造器注入 UserRepository，UserController 通过构造器注入 UserService。Spring Boot 会自动扫描这些 Bean 并进行依赖注入。

5. 总结

依赖注入是 Spring Boot 中非常重要的特性，通过使用 @Autowired、@Qualifier、@Resource 和 @Inject 等注解，可以简化代码并提高可维护性。理解这些注解的使用方法和原理，对于开发 Spring Boot 应用非常有帮助。