1. Spring 纯注解配置入门指南
作为一名长期使用Spring框架的开发者,我深刻体会到XML配置带来的繁琐。记得2016年接手的一个老项目,光是applicationContext.xml文件就超过2000行,每次修改配置都像是在玩"大家来找茬"。直到全面转向注解配置,开发效率才有了质的提升。
纯注解配置的核心价值在于:用Java代码代替XML文件,让配置变得更加直观、类型安全且易于维护。这种方式特别适合中小型项目,或者需要频繁调整配置的开发场景。对于刚接触Spring注解的开发者来说,掌握这套配置方式可以显著提升开发体验。
技术提示:Spring从3.0版本开始引入Java配置支持,在4.0和5.0版本中不断完善,现在已经成为Spring Boot的默认配置方式。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心配置类详解
2.1 配置类基础结构
传统的applicationContext.xml文件现在可以用一个简单的Java类替代:
java复制@Configuration
@ComponentScan(basePackages = "com.sy")
@Import({DataSourceConfig.class})
public class AppConfig {
// 这里可以定义其他@Bean方法
}
这个配置类做了三件事:
@Configuration注解表明这是一个Spring配置类@ComponentScan指定要扫描的包路径@Import引入其他配置类(实现配置模块化)
实际项目中,我习惯按功能拆分多个配置类。比如:
- AppConfig:主配置类
- DataSourceConfig:数据源相关配置
- WebConfig:Web相关配置
- SecurityConfig:安全相关配置
2.2 组件扫描的进阶用法
@ComponentScan注解远比表面看起来强大。在我的电商项目实践中,这些用法特别实用:
java复制@ComponentScan(
basePackages = "com.sy",
excludeFilters = @Filter(type = FilterType.ANNOTATION,
classes = {Controller.class, RestController.class}),
includeFilters = @Filter(type = FilterType.REGEX,
pattern = ".*Repository")
)
这个配置实现了:
- 排除所有Controller组件(适合在非Web配置类中使用)
- 只包含名称以Repository结尾的组件
避坑指南:组件扫描会显著影响应用启动速度。在大型项目中,精确指定扫描路径比使用通配符更高效。
3. 属性配置最佳实践
3.1 多环境属性加载
实际项目通常需要区分开发、测试、生产环境。这是我的常用配置方式:
java复制@Configuration
@Prop
