# `@Configuration` 注解详解
08、底层注解-@Configuration详解
`@Configuration` 是 Spring 框架中用于定义配置类的核心注解，它允许开发者以 Java 代码的形式替代传统的 XML 配置，声明和管理 Bean。
## 一、基本作用
### 1. 标识配置类
使用 `@Configuration` 注解标记的类被视为 Spring 的配置类，Spring 容器在启动时会自动扫描并处理这些类。
### 2. 定义 Bean
在配置类中，通过 `@Bean` 注解的方法可以定义 Bean。这些方法返回的对象将被注册到 Spring 容器中，供其他组件依赖注入。
```java
@Configuration
public class AppConfig {
@Bean
public MyService myService() {
return new MyServiceImpl();
}
}
```
### 3. 依赖注入
配置类中的 `@Bean` 方法可以接受其他 Bean 作为参数，实现依赖关系的自动装配。
```java
@Configuration
public class AppConfig {
@Bean
public MyService myService(MyRepository repository) {
return new MyServiceImpl(repository);
}
@Bean
public MyRepository myRepository() {
return new MyRepositoryImpl();
}
}
```
## 二、核心特性
### 1. 单例模式
默认情况下，`@Configuration` 类中的 `@Bean` 方法返回的 Bean 是单例的，即在整个应用程序生命周期中只创建一个实例。
### 2. 代理机制
#### Full 模式（默认）
- **特性**：`proxyBeanMethods = true`，Spring 使用 CGLIB 为配置类生成代理对象。
- **作用**：确保每次调用 `@Bean` 方法都返回容器中的同一个单例 Bean，避免重复创建。
- **适用场景**：配置类之间存在复杂的依赖关系。
#### Lite 模式
- **特性**：`proxyBeanMethods = false`，不生成代理对象。
- **作用**：每次调用 `@Bean` 方法都会创建新的实例，提升性能。
- **适用场景**：配置类之间没有依赖关系，或希望减少启动时间。
```java
@Configuration(proxyBeanMethods = false) // 启用 Lite 模式
public class AppConfig {
// ...
}
```
### 3. 条件化配置
结合 `@Conditional` 注解，根据特定条件决定是否创建 Bean。
```java
@Configuration
public class ConditionalConfig {
@Bean
@ConditionalOnProperty(name = "my.property", havingValue = "true")
public MyBean myBean() {
return new MyBean();
}
}
```
### 4. 模块化配置
使用 `@Import` 注解导入其他配置类，实现配置的模块化和复用。
```java
@Configuration
@Import(AnotherConfig.class)
public class AppConfig {
// ...
}
```
## 三、使用注意事项
### 1. 避免循环依赖
在配置类中尽量避免循环依赖，否则可能导致 Spring 容器启动失败。
### 2. 配置类的可见性
配置类应声明为非 `final`，且不能是局部类，以便 Spring 生成代理类。
### 3. 慎用 `@Bean` 方法调用
在 Full 模式下，不要在 `@Bean` 方法内部直接调用其他 `@Bean` 方法，应使用依赖注入获取 Bean，避免创建多余的实例。
## 四、示例
### 1. 基本配置
```java
@Configuration
public class AppConfig {
@Bean
public MyService myService() {
return new MyServiceImpl();
}
@Bean
public MyRepository myRepository() {
return new MyRepositoryImpl();
}
}
```
### 2. 条件化配置
```java
@Configuration
public class DatabaseConfig {
@Bean
@ConditionalOnProperty(name = "db.type", havingValue = "mysql")
public DataSource mysqlDataSource() {
// 创建 MySQL 数据源
return new MysqlDataSource();
}
@Bean
@ConditionalOnProperty(name = "db.type", havingValue = "postgresql")
public DataSource postgresqlDataSource() {
// 创建 PostgreSQL 数据源
return new PostgresqlDataSource();
}
}
```
---
通过合理使用 `@Configuration` 注解，可以简化 Spring 应用的配置管理，提高代码的可读性和可维护性，实现更加灵活和高效的依赖注入。
