Spring 核心注解速查：@Autowired vs @Resource、@Component vs @Bean

@Service
public class OrderService {

    // ① @Autowired：按类型匹配，多个实现时用 @Qualifier 指定
    @Autowired
    @Qualifier("mysqlUserDao")
    private UserDao userDao;

    // ② @Resource：默认按字段名匹配，可指定 name
    @Resource(name = "mysqlUserDao")
    private UserDao userDao2;

    // ③ @Inject：按类型匹配，无 required 属性
    @Inject
    @Named("mysqlUserDao")
    private UserDao userDao3;
}

// 假设 UserDao 有两个实现：MysqlUserDao 和 RedisUserDao

// 方式 1：@Qualifier 指定 Bean 名称
@Autowired
@Qualifier("mysqlUserDao")
private UserDao userDao;

// 方式 2：@Primary 标记优先（在配置类或实现类上）
@Primary
@Component
public class MysqlUserDao implements UserDao { ... }

// 方式 3：变量名自动匹配（最后兜底）
@Autowired
private UserDao mysqlUserDao; // 变量名 = Bean 名 → 匹配

// 方式一：@Component 自动扫描
@Service  // 等价于 @Component + "业务层"语义
public class UserService {
    @Autowired
    private UserDao userDao;
}

// 方式二：@Bean 显式声明（在 @Configuration 类中）
@Configuration
public class AppConfig {

    @Bean
    public DataSource dataSource() {
        // 可以写复杂的初始化逻辑
        HikariDataSource ds = new HikariDataSource();
        ds.setJdbcUrl("jdbc:mysql://localhost/mydb");
        ds.setMaximumPoolSize(20);
        return ds;
    }

    @Bean
    public UserDao userDao(DataSource dataSource) {
        return new UserDaoImpl(dataSource); // 方法参数 = 其他 Bean
    }
}

@Component
public class AppConfig {

    // 基本用法：注入单个属性
    @Value("${app.name}")
    private String appName;

    // 默认值：找不到时使用默认
    @Value("${app.port:8080}")
    private int port;

    // SpEL 表达式
    @Value("#{systemProperties['user.name']}")
    private String systemUser;
}

// application.yml
// app:
//   name: my-service
//   port: 8080
//   features:
//     - logging
//     - metrics

@Component
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private String name;
    private int port;
    private List<String> features;

    // 必须有 getter / setter（Spring 通过 setter 绑定）
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    // ... 其他 getter/setter
}

@Configuration
@PropertySource("classpath:custom.properties")
public class CustomConfig {
    @Value("${custom.key}")
    private String customValue;
}

@Component
@Scope("prototype")  // 每次注入都创建新实例
public class OrderProcessor {
    // 有状态的处理器，不能用单例
    private List<OrderItem> items = new ArrayList<>();
}

@Component
@Lazy  // 启动时不创建，第一次使用时才初始化
public class HeavyReportService {
    // 初始化耗时，延迟加载优化启动速度
}

@Component
@DependsOn("cacheManager")  // 确保 cacheManager 先初始化
public class DataService {
    // 启动时需要预热缓存
}

@Service
public class CacheService {

    @PostConstruct
    public void init() {
        // Bean 创建完成后自动调用：预热缓存
        loadInitialData();
    }

    @PreDestroy
    public void cleanup() {
        // 容器关闭时调用：释放资源
        clearCache();
    }
}

@RestController
@RequestMapping("/api/users")
public class UserController {

    // GET /api/users?page=1&size=10
    @GetMapping
    public Page<User> list(
            @RequestParam(defaultValue = "1") int page,
            @RequestParam(defaultValue = "10") int size) {
        return userService.findByPage(page, size);
    }

    // GET /api/users/42
    @GetMapping("/{id}")
    public User getById(
            @PathVariable Long id,
            @RequestHeader("Accept") String accept) {
        return userService.findById(id);
    }

    // POST /api/users  body: {"name":"Alice","email":"..."} 
    @PostMapping
    public User create(@RequestBody @Valid CreateUserRequest req) {
        return userService.create(req);
    }

    // DELETE /api/users/42
    @DeleteMapping("/{id}")
    public void delete(@PathVariable Long id) {
        userService.delete(id);
    }
}