当前位置：首页 > news >正文

Spring核心：@Configuration注解详解

news 2025/10/18 12:03:43

聊聊 Spring 框架中的 @Configuration 注解。

核心概念

@Configuration是一个核心的 Spring 注解，它表明这个类是一个【配置类】。 它的主要作用是替代传统的 XML 配置文件，允许开发者使用纯 Java 代码来定义和配置 Spring 应用上下文中的 Bean。

你可以把它理解为 <beans>标签的 Java 等价物。

主要作用与特性

1. 定义 Bean

在配置类中，你可以使用 @Bean注解在方法上，该方法返回的对象将被 Spring 容器注册为一个 Bean。

传统 XML 方式：

<beans><bean id="myService" class="com.example.MyServiceImpl"/>
</beans>

现代 @Configuration方式：

@Configuration
public class AppConfig {@Beanpublic MyService myService() {return new MyServiceImpl();}
}

2. 配置 Bean 的依赖关系

你可以在一个 @Bean方法中调用另一个 @Bean方法，Spring 会确保这是对单例 Bean 的引用，而不是普通的方法调用。

@Configuration
public class AppConfig {@Beanpublic DataSource dataSource() {return new DriverManagerDataSource(...);}// userRepository() 依赖于 dataSource()@Beanpublic UserRepository userRepository() {return new JdbcUserRepository(dataSource()); // 这里调用的是被 Spring 拦截的方法，返回的是单例 Bean}// userService() 依赖于 userRepository()@Beanpublic UserService userService() {return new UserServiceImpl(userRepository());}
}

3. 组合配置（模块化）

你可以使用 @Import注解来组合多个配置类，实现模块化配置。

@Configuration
public class DatabaseConfig {@Beanpublic DataSource dataSource() { ... }
}@Configuration
public class ServiceConfig {@Beanpublic UserService userService() { ... }
}// 主配置类导入其他配置
@Configuration
@Import({DatabaseConfig.class, ServiceConfig.class})
public class AppConfig {
}

4. 与组件扫描配合使用

@Configuration经常与 @ComponentScan一起使用，以自动发现并注册使用 @Component, @Service, @Repository等注解的类。

@Configuration
@ComponentScan("com.example") // 扫描 com.example 包及其子包下的所有组件
public class AppConfig {// 也可以在这里用 @Bean 定义一些特殊的、需要复杂配置的 Bean
}

工作原理：底层魔法（CGLIB 代理）

这是 @Configuration类最精妙的地方。Spring 在运行时会对 @Configuration类使用 CGLIB 字节码增强。

这意味着：

Spring 容器会创建你的配置类的一个子类代理。
当调用 @Bean方法时，代理会首先检查容器中是否已经存在该 Bean。
如果存在，则返回已存在的单例实例；如果不存在，才真正执行方法体来创建 Bean，并将其放入容器。

这就是为什么在上面的例子中，userRepository()方法里调用 dataSource()不会创建一个新的 DataSource实例，而是返回 Spring 容器中那个唯一的单例。

对比： 如果在一个普通的 @Component类中使用 @Bean方法，则不会有这个代理行为，每次调用 dataSource()都会执行一次 new，这通常不是你想要的。

`@Configuration`vs `@Component`

虽然 @Configuration本身也被 @Component元注解标记（意味着它也能被组件扫描到），但它们有明确的区别：

特性	`@Configuration`	`@Component`
主要目的	配置和定义 Bean	作为通用组件被扫描
`@Bean`方法调用	通过 CGLIB 代理，确保返回单例 Bean	作为普通 Java 方法调用，可能创建新对象
语义	明确表示这是一个配置类	表示一个通用的 Spring 组件