编辑“︁Spring元数据配置”︁

= Spring元数据配置 =

== 概述 ==
'''Spring元数据配置'''是Spring Framework中定义和管理Bean的核心机制，它描述了如何创建、配置和组装应用程序中的对象。元数据可以通过三种主要方式提供：
* '''XML配置文件'''（传统方式）
* '''注解'''（现代简化方式）
* '''Java配置类'''（类型安全方式）

Spring容器通过读取这些元数据来实例化Bean并管理其生命周期依赖关系。

== 配置方式对比 ==
{| class="wikitable"
|+ 元数据配置方式比较
|-
! 方式 !! 优点 !! 缺点
|-
| XML配置 || 集中管理、与代码解耦 || 冗长、类型不安全
|-
| 注解 || 简洁、贴近代码 || 分散配置、需组件扫描
|-
| Java配置 || 类型安全、IDE支持 || 需要重新编译
|}

== XML配置方式 ==
最传统的配置方式，通过<code><beans></code>根元素和<code><bean></code>子元素定义。

=== 基础示例 ===
<syntaxhighlight lang="xml">
<!-- applicationContext.xml -->
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="userService" class="com.example.UserServiceImpl">
        <property name="userRepository" ref="userRepository"/>
    </bean>

    <bean id="userRepository" class="com.example.UserRepositoryImpl"/>
</beans>
</syntaxhighlight>

=== 依赖注入类型 ===
* '''构造器注入'''：
<syntaxhighlight lang="xml">
<bean id="exampleBean" class="com.example.ExampleBean">
    <constructor-arg ref="anotherBean"/>
    <constructor-arg value="100"/>
</bean>
</syntaxhighlight>

* '''Setter注入'''：
<syntaxhighlight lang="xml">
<bean id="exampleBean" class="com.example.ExampleBean">
    <property name="beanOne" ref="anotherBean"/>
    <property name="value" value="42"/>
</bean>
</syntaxhighlight>

== 注解配置方式 ==
Spring 2.5+引入的基于注解的配置，需启用组件扫描。

=== 核心注解 ===
* <code>@Component</code> - 通用组件标记
* <code>@Service</code> - 服务层组件
* <code>@Repository</code> - 数据访问层
* <code>@Autowired</code> - 自动依赖注入

=== 配置示例 ===
<syntaxhighlight lang="java">
@Configuration
@ComponentScan("com.example")
public class AppConfig {
    // 可定义额外的@Bean方法
}

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserRepository userRepository;
    // ...
}
</syntaxhighlight>

== Java配置类方式 ==
Spring 3.0+引入的纯Java配置方式，完全替代XML。

=== 典型配置 ===
<syntaxhighlight lang="java">
@Configuration
public class AppConfig {
    
    @Bean
    public UserRepository userRepository() {
        return new UserRepositoryImpl();
    }
    
    @Bean
    public UserService userService() {
        return new UserServiceImpl(userRepository());
    }
}
</syntaxhighlight>

== 配置元数据生命周期 ==
<mermaid>
graph TD
    A[元数据源] --> B[BeanDefinition]
    B --> C[实例化]
    C --> D[属性填充]
    D --> E[初始化]
    E --> F[就绪Bean]
</mermaid>

== 高级主题 ==

=== 条件化配置 ===
Spring 4.0引入的条件化Bean注册：
<syntaxhighlight lang="java">
@Configuration
public class ConditionalConfig {
    
    @Bean
    @Conditional(DevEnvironmentCondition.class)
    public DataSource devDataSource() {
        return new EmbeddedDatabaseBuilder().build();
    }
}
</syntaxhighlight>

=== 配置属性外部化 ===
使用<code>@PropertySource</code>和<code>@Value</code>：
<syntaxhighlight lang="java">
@Configuration
@PropertySource("classpath:app.properties")
public class PropertyConfig {
    
    @Value("${db.url}")
    private String dbUrl;
    
    @Bean
    public DataSource dataSource() {
        return DataSourceBuilder.create().url(dbUrl).build();
    }
}
</syntaxhighlight>

== 最佳实践 ==
1. 生产环境推荐'''Java配置'''为主，注解为辅
2. 简单项目可使用'''注解驱动'''开发
3. 大型系统建议采用'''模块化配置'''（按功能分多个<code>@Configuration</code>类）
4. 避免XML与注解混用造成的配置混乱

== 性能考虑 ==
* 注解配置在启动时解析稍快
* 复杂依赖关系下XML更易维护
* Java配置提供最佳的编译时检查

数学表示Bean定义数量与启动时间的关系：
<math>
T = n \times t_b + m \times t_d
</math>
其中：
* <math>T</math> - 总启动时间
* <math>n</math> - Bean数量
* <math>t_b</math> - 单个Bean创建时间
* <math>m</math> - 依赖关系数量
* <math>t_d</math> - 单个依赖解析时间

== 常见问题 ==
'''Q: 三种配置方式能否混合使用？'''
A: 可以，但建议保持一致性。混合使用时优先级：Java配置 > 注解 > XML

'''Q: 如何选择配置方式？'''
A: 考虑项目规模、团队习惯和维护需求。新项目推荐Java配置为主。

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