Spring @Configuration 注解详解：用 Java 代码替代 XML 配置

在 Spring 框架中，传统的 Bean 管理依赖于 applicationContext.xml 等 XML 配置文件。随着 Spring 对注解和 Java 配置的支持日益完善，基于 Java 的配置方式已成为主流。其中，@Configuration 注解是实现这一转变的核心。

一、什么是 @Configuration？

被 @Configuration 标注的类，会被 Spring 的 IOC 容器识别为一个配置类（Configuration Class），其作用等同于一个 XML 配置文件。在这个类中，你可以通过 @Bean 方法声明并注册 Spring 容器管理的 Bean。

示例：定义配置类

@Configuration
public class ConfigurationDemo {
    
    @Bean
    public Date currentDate() {
        return new Date();
    }
}

✅ 上述代码等价于以下 XML 配置：

<bean id="currentDate" class="java.util.Date"/>

• 方法名 currentDate 默认作为 Bean 的名称（id）；
• 返回值对象由 Spring 容器管理，具备单例、依赖注入等特性。

二、启动基于 Java 配置的 IOC 容器

使用 AnnotationConfigApplicationContext 加载配置类，即可初始化 Spring 容器：

public class MainApp {
    public static void main(String[] args) {
        // 加载 ConfigurationDemo 配置类
        AnnotationConfigApplicationContext ctx = 
            new AnnotationConfigApplicationContext(ConfigurationDemo.class);
        
        // 打印容器中所有 Bean 的名称
        String[] beanNames = ctx.getBeanDefinitionNames();
        Arrays.stream(beanNames).forEach(System.out::println);
    }
}

输出结果：

org.springframework.context.annotation.internalConfigurationAnnotationProcessor
org.springframework.context.annotation.internalAutowiredAnnotationProcessor
org.springframework.context.annotation.internalCommonAnnotationProcessor
org.springframework.context.event.internalEventListenerProcessor
org.springframework.context.event.internalEventListenerFactory
configurationDemo
currentDate

🔍 关键说明：

• configurationDemo：配置类本身的 Bean（默认首字母小写）；
• currentDate：通过 @Bean 方法注册的自定义 Bean；
• 其余为 Spring 内部自动注册的后处理器（如处理 @Autowired、@EventListener 等）。

三、@Configuration 的核心特性

1. 替代 XML 配置
   无需编写 <beans> 文件，全部配置通过 Java 代码完成，类型安全、易于重构。
   
2. 支持依赖注入与方法调用
   在配置类内部，可通过方法调用实现 Bean 之间的依赖关系（得益于 CGLIB 代理）：

@Configuration
public class AppConfig {
    @Bean
    public UserService userService() {
        return new UserService(userRepository()); // 直接调用另一个 @Bean 方法
    }
    @Bean
    public UserRepository userRepository() {
        return new UserRepository();
    }
}

⚠️ 注意：这种调用会经过 Spring 代理，确保返回的是容器中的单例 Bean，而非新实例。

1. 可组合与导入
   使用 @Import 可将多个配置类组合：

@Configuration
@Import({DatabaseConfig.class, WebConfig.class})
public class RootConfig { }

1. 与组件扫描结合
   配合 @ComponentScan，可同时管理配置类和注解驱动的组件（如 @Service、@Repository）：

@Configuration
@ComponentScan("com.example.service")
public class AppConfig { }

四、最佳实践建议

• 命名规范：配置类建议以 Config 或 Configuration 结尾，如 DataSourceConfig；
• 职责单一：按功能拆分配置类（如数据库、缓存、Web），避免“上帝配置类”；
• 优先使用 Java 配置：相比 XML，Java 配置更安全、可调试、支持 IDE 自动补全；
• 避免在 @Bean 方法中使用 new 外部依赖：应通过参数注入或调用其他 @Bean 方法获取依赖。

总结

@Configuration 是 Spring 实现“无 XML”配置的关键注解。它让开发者能够以类型安全、结构清晰、易于维护的方式构建 Spring 应用上下文。结合 @Bean、@Import、@ComponentScan 等注解，你可以完全告别 XML，拥抱现代化的 Spring 开发体验。