编辑“︁Spring Bean定义详解”︁

{{DISPLAYTITLE:Spring Bean定义详解}}

'''Spring Bean定义'''是Spring框架中用于描述如何创建和管理应用程序中对象的核心配置单元。它定义了Bean的类名、作用域、生命周期回调方法、依赖关系等元数据，是IoC（控制反转）容器实例化对象的基础依据。

== 基本概念 ==
在Spring中，'''Bean'''指由Spring IoC容器管理的对象。Bean定义可以通过以下方式配置：
* XML配置文件（传统方式）
* Java注解（现代主流方式）
* Java配置类（基于@Configuration）

=== 关键属性 ===
一个完整的Bean定义通常包含以下属性：
{| class="wikitable"
|-
! 属性 !! 描述 !! 示例
|-
| class | Bean的全限定类名 | <code>com.example.MyService</code>
|-
| id/name | Bean的唯一标识符 | <code>userService</code>
|-
| scope | Bean的作用域（singleton/prototype等） | <code>scope="prototype"</code>
|-
| constructor-arg | 构造器参数 | <code><constructor-arg ref="dataSource"/></code>
|-
| property | 设置属性值 | <code><property name="username" value="admin"/></code>
|}

== 配置方式详解 ==
=== XML配置示例 ===
<syntaxhighlight lang="xml">
<!-- beans.xml -->
<bean id="userRepository" class="com.example.UserRepositoryImpl"/>

<bean id="userService" class="com.example.UserService">
    <property name="repository" ref="userRepository"/>
    <property name="maxUsers" value="1000"/>
</bean>
</syntaxhighlight>

=== 注解配置示例 ===
<syntaxhighlight lang="java">
@Component("userService")
public class UserService {
    @Autowired
    private UserRepository repository;
    
    @Value("${users.max:100}")
    private int maxUsers;
}
</syntaxhighlight>

=== Java配置类示例 ===
<syntaxhighlight lang="java">
@Configuration
public class AppConfig {
    @Bean
    public UserRepository userRepository() {
        return new UserRepositoryImpl();
    }
    
    @Bean
    public UserService userService() {
        UserService service = new UserService();
        service.setRepository(userRepository());
        return service;
    }
}
</syntaxhighlight>

== Bean作用域 ==
Spring支持多种作用域，通过<code>@Scope</code>注解或XML中的<code>scope</code>属性指定：

<mermaid>
pie
    title Bean作用域分布
    "Singleton" : 75
    "Prototype" : 15
    "Request" : 5
    "Session" : 3
    "Application" : 2
</mermaid>

数学表达：Singleton作用域的Bean在整个容器中只存在一个实例，可以用公式表示为：
<math>
\forall b \in Beans, scope(b) = singleton \Rightarrow \exists! instance(b)
</math>

== 生命周期回调 ==
Bean生命周期中的重要回调方法：
1. 初始化回调：<code>@PostConstruct</code>或<code>init-method</code>
2. 销毁回调：<code>@PreDestroy</code>或<code>destroy-method</code>

<syntaxhighlight lang="java">
public class DatabaseConnection {
    @PostConstruct
    public void connect() {
        System.out.println("建立数据库连接");
    }
    
    @PreDestroy
    public void disconnect() {
        System.out.println("关闭数据库连接");
    }
}
</syntaxhighlight>

== 高级特性 ==
=== 延迟初始化 ===
通过<code>@Lazy</code>或XML中的<code>lazy-init="true"</code>实现：

<syntaxhighlight lang="java">
@Configuration
public class LazyConfig {
    @Bean
    @Lazy
    public ExpensiveService expensiveService() {
        return new ExpensiveService(); // 只有被请求时才初始化
    }
}
</syntaxhighlight>

=== 条件化Bean ===
使用<code>@Conditional</code>实现条件化注册：

<syntaxhighlight lang="java">
@Bean
@Conditional(DevEnvironmentCondition.class)
public DevTools devTools() {
    return new DevTools(); // 仅在开发环境注册
}
</syntaxhighlight>

== 实际应用案例 ==
=== 电商系统库存服务 ===
<syntaxhighlight lang="java">
@Repository
public class InventoryRepository {
    // 数据库访问实现
}

@Service
@Scope("singleton")
public class InventoryService {
    private final InventoryRepository repository;
    
    @Autowired
    public InventoryService(InventoryRepository repository) {
        this.repository = repository;
    }
    
    @Scheduled(fixedRate = 3600000)
    public void refreshInventoryCache() {
        // 每小时刷新缓存
    }
}

@Configuration
@EnableScheduling
public class InventoryConfig {
    @Bean
    public InventoryService inventoryService(InventoryRepository repo) {
        return new InventoryService(repo);
    }
}
</syntaxhighlight>

== 常见问题 ==
=== Bean覆盖问题 ===
当多个同名的Bean定义存在时，Spring的默认行为是：
* XML配置中：最后定义的Bean会覆盖之前的
* Java配置中：需要显式使用<code>@Primary</code>标记首选Bean

=== 循环依赖 ===
Spring能自动解决setter注入的循环依赖，但构造器注入的循环依赖会导致异常：

<mermaid>
graph LR
    A[ServiceA] -->|依赖| B[ServiceB]
    B -->|依赖| A
</mermaid>

解决方案：
1. 改为setter注入
2. 使用<code>@Lazy</code>延迟加载
3. 重构代码消除循环依赖

== 最佳实践 ==
* 优先使用构造器注入（不可变依赖）
* 对可选依赖使用setter注入
* 为常用Bean使用<code>@Primary</code>
* 测试环境使用<code>@Profile("test")</code>
* 避免字段注入（不利于测试）

通过全面理解Spring Bean定义，开发者可以更高效地利用Spring框架的依赖注入能力，构建松耦合、易测试的应用程序。

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring Bean管理]]