Spring IOC 注解进阶：@Bean 管理第三方 Bean、@Import 拆分配置与@Value 注入

3. 运行类 App：启动 Spring 容器

public class App {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);
    }
}

1.3 最终项目结构

spring_14_annotation_third_bean_manager
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.itheima
│   │   │       ├── config
│   │   │       │   └── SpringConfig.java
│   │   │       ├── dao
│   │   │       │   ├── BookDao.java
│   │   │       │   └── impl
│   │   │       │       └── BookDaoImpl.java
│   │   │       └── App.java
│   │   └── resources
└── pom.xml

二、@Bean 注解：管理第三方 Bean（以 Druid 数据源为例）

2.1 @Bean 的作用与核心特点

@Bean 是 Spring 提供的、用于在配置类中手动定义 Bean的注解，核心作用是：

标记在@Configuration 配置类的方法上，告诉 Spring：「这个方法返回的对象，交给 Spring 容器管理，作为一个 Bean」。

加了@Bean 后，Spring 会调用该方法，将返回的对象存入 IOC 容器，后续其他 Bean 需要该类型的对象时，直接从容器中注入即可。

2.2 @Bean vs @Component 核心区别对比

很多同学会混淆@Bean 和@Component，这里用表格清晰对比两者的差异：

2.3 完整实现步骤

我们以 Druid 数据源为例，演示如何用@Bean 管理第三方 Bean：

步骤 1：导入 Druid 依赖

在 pom.xml 中添加 Druid 的 Maven 依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.16</version>
</dependency>

步骤 2：在配置类中定义@Bean 方法

在 SpringConfig 中添加方法，返回 DruidDataSource 对象，并添加@Bean 注解：

@Configuration
public class SpringConfig {
    @Bean
    public DataSource dataSource(){
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName("com.mysql.jdbc.Driver");
        ds.setUrl("jdbc:mysql://localhost:3306/spring_db");
        ds.setUsername("root");
        ds.setPassword("root");
        return ds;
    }
}

⚠️ 注意：不能直接用 DataSource ds = new DruidDataSource()，因为 DataSource 接口中没有对应的 setter 方法，必须使用具体实现类 DruidDataSource 来设置属性。

步骤 3：从 IOC 容器中获取 Bean 并测试

修改 App 类，从容器中获取 DataSource 对象并打印：

public class App {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);
        DataSource dataSource = ctx.getBean(DataSource.class);
        System.out.println(dataSource);
    }
}

运行程序，控制台会打印 Druid 数据源对象，说明第三方 Bean 已经成功被 Spring 管理。

三、配置类拆分：@ComponentScan vs @Import 两种方案

如果把所有@Bean 都写在 SpringConfig 中，会导致配置类越来越臃肿，不利于代码阅读和分类管理。因此我们可以按业务类别拆分配置类，比如把数据源相关的 Bean 放到 JdbcConfig 中。

3.1 方案一：@ComponentScan 包扫描引入（不推荐）

实现步骤：

1. 创建 JdbcConfig 配置类，添加@Configuration 和@Bean 注解：

@Configuration
public class JdbcConfig {
    @Bean
    public DataSource dataSource(){
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName("com.mysql.jdbc.Driver");
        ds.setUrl("jdbc:mysql://localhost:3306/spring_db");
        ds.setUsername("root");
        ds.setPassword("root");
        return ds;
    }
}

2. 在 SpringConfig 中添加包扫描，扫描 JdbcConfig 所在的包：

@Configuration
@ComponentScan("com.itheima.config")
public class SpringConfig {
}

3. 运行 App 类，依然可以正常获取 DataSource 对象。

缺点：无法直观看到 Spring 加载了哪些配置类、全量扫描增加容器负担，不推荐生产环境使用。

3.2 方案二：@Import 手动指定引入（推荐）

@Import 是 Spring 提供的、用于手动指定需要加载的配置类的注解，完美解决了包扫描的痛点。

实现步骤：

1. 移除 JdbcConfig 的@Configuration 注解：

public class JdbcConfig {
    @Bean
    public DataSource dataSource(){
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName("com.mysql.jdbc.Driver");
        ds.setUrl("jdbc:mysql://localhost:3306/spring_db");
        ds.setUsername("root");
        ds.setPassword("root");
        return ds;
    }
}

2. 在 SpringConfig 中添加@Import 注解，手动导入 JdbcConfig：

@Configuration
@Import({JdbcConfig.class})
public class SpringConfig {
}

3.3 @Import 核心原理与使用场景

**本质：**Spring 默认通过@ComponentScan 扫描带有@Configuration、@Component 的类，纳入容器管理。而@Import 的核心功能是：强制指定类纳入 Spring 容器，无论该类是否有@Configuration 或其他组件注解。

核心使用场景：

• 导入第三方库中的配置类
• 精细化控制配置加载，避免全量扫描
• 结合@Conditional 实现条件化导入配置

3.4 @Import 使用注意事项

• 参数是数组，支持导入多个配置类：@Import({JdbcConfig.class, XxxConfig.class})
• 一个配置类中只能写一次@Import，不能多次添加
• 可以完全替代@ComponentScan，提升容器启动效率

四、@Bean 方法中注入资源：简单数据类型&引用数据类型

在使用@Bean 创建 Bean 时，方法中往往需要依赖其他资源，分为两类：简单数据类型（比如字符串、数字）和引用数据类型（比如其他 Bean）。

4.1 简单数据类型注入：@Value+@PropertySource 读取配置文件

**需求分析：**将数据库连接四要素硬编码提取到 properties 文件，通过注解注入。

1. 在 resources 目录下创建 jdbc.properties 配置文件：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/spring_db
jdbc.username=root
jdbc.password=root

2. 在 JdbcConfig 中添加@PropertySource 注解，加载配置文件：

@PropertySource("classpath:jdbc.properties")
public class JdbcConfig {
    // 注入配置文件中的值
    @Value("${jdbc.driver}")
    private String driver;
    
    @Value("${jdbc.url}")
    private String url;
    
    @Value("${jdbc.username}")
    private String userName;
    
    @Value("${jdbc.password}")
    private String password;
}

4.2 引用数据类型注入：方法参数自动装配

**需求分析：**将 BookDao 对象注入到@Bean 方法中。

1. 在 SpringConfig 中扫描 BookDao 所在的包：

@Configuration
@ComponentScan("com.itheima.dao")
@Import({JdbcConfig.class})
public class SpringConfig {
}

2. 在 JdbcConfig 的 dataSource 方法中添加 BookDao 参数：

@PropertySource("classpath:jdbc.properties")
// 这个注解建议放在主配置类 SpringConfig 上，原因如下：
// 配置聚合：主配置类是整个 Spring 环境的入口，在这里统一管理所有配置（扫描、导入、资源文件），逻辑最完整。
// 避免冗余：如果以后还有其他配置类（如 RedisConfig），只需要在 SpringConfig 里加一个@PropertySource 即可，不需要每个配置类都写一遍。
public class JdbcConfig {
    @Value("${jdbc.driver}")
    private String driver;
    
    @Value("${jdbc.url}")
    private String url;
    
    @Value("${jdbc.username}")
    private String userName;
    
    @Value("${jdbc.password}")
    private String password;

    // 不能在方法里定义 BookDao bookDao，用@Autowired 注解，spring 扫描不到。当 Bean 被初始化时，Spring 会检查该 Bean 类的 类级别成员（字段）或 类级别的方法（构造器、setter 等）上的 @Autowired，并执行注入。
    @Bean
    public DataSource dataSource(BookDao bookDao){
        System.out.println(bookDao);
        DruidDataSource ds = new DruidDataSource();
        ds.setDriverClassName(driver);
        ds.setUrl(url);
        ds.setUsername(userName);
        ds.setPassword(password);
        return ds;
    }
}

运行程序即可验证引用类型注入成功。

五、总结与最佳实践

核心知识点总结

最佳实践

• 第三方 Bean 统一用@Bean 管理
• 配置类按业务拆分，用@Import 手动导入
• 配置统一放到 properties 文件，通过@Value 注入
• @Bean 方法依赖其他 Bean 时，优先用方法参数注入
• 减少@ComponentScan 范围，提升容器启动效率