一、配置兼容

Spring 的三种配置方式混合使用，需要兼容 XML 配置和注解配置。

1. 优先 XML 配置

在老的 Spring 项目中，常常会存在大量的 XML 配置，但并不影响我们使用注解配置的新特性。

XML 配置中使用注解配置
配置文件中使用 context:component-scan 来配置扫描的包路径。
该路径下的类就支持 @Configuration、@Component 和 @Autowired 等注解。

<beans>

    <context:component-scan base-package="cn.codeartist.spring.bean.mix"/>

</beans>

XML 配置中使用 Java 配置

扫描的包路径下使用 @Configuration 定义配置类，在配置类中使用 @Bean 注册 Bean。

2. 优先注解配置

老的 Spring 项目在迁移的过程中，可能需要在使用注解和 Java 的配置中，使用 XML 配置。

注解配置中使用 XML 配置

在配置类上使用 @ImportResource 来导入 XML 配置文件。

@Configuration
@ImportResource("classpath:bean.xml")
public class AppConfig {

}

classpath:bean.xml 表示基于 classpath 路径的资源文件。

注解配置中使用 Java 配置
直接在配置类中使用 @Bean 注册 Bean。

@Configuration
@ComponentScan("cn.codeartist.spring.bean.mix")
public class AppConfig {

    @Bean
    public BeanExample beanExample() {
        return new BeanExample();
    }
}

或者在扫描的包路径下使用 @Configuration 注解定义配置类。

二、迁移方案

基于 XML 配置的容器使用 ClassPathXmlApplicationContext 或 FileSystemXmlApplicationContext 实例化。
基于注解配置的容器使用 AnnotationConfigApplicationContext 实例化。

// XML
public static void main(String[] args) {
    ApplicationContext applicationContext =
        new ClassPathXmlApplicationContext("bean.xml");
    BeanExample beanExample = (BeanExample) applicationContext.getBean("beanExample");
}

// 注解
public static void main(String[] args) {
    ApplicationContext applicationContext =
        new AnnotationConfigApplicationContext(AppConfig.class);
    BeanExample beanExample = (BeanExample) applicationContext.getBean("beanExample");
}

1. XML 配置至注解配置

配置文件中添加 context:component-scan 指定扫描的包路径。

2. XML 配置至 Java 配置

XML 配置中的<beans>和<bean>标签，等效于 Java 配置中的@Configuration和@Bean配置。

<beans>

    <bean id="beanExample" class="cn.codeartist.spring.bean.mix.BeanExample"/>

</beans>

等效于：

@Configuration
public class AppConfig {

    @Bean
    public BeanExample beanExample() {
        return new BeanExample();
    }
}

属性对照
XML 配置和注解配置对应属性迁移。

XML配置	注解配置
`<context:component-scan>`	`@ComponentScan`
`<bean>` 的 `id` 属性	`@Bean` 的 `value` 或 `name` 属性
`<bean>` 的 `scope` 属性	`@Scope`
`<bean>` 的 `depends-on` 属性	`@DependsOn`
`<bean>` 的 `lazy-init` 属性	`@Lazy`
`<bean>` 的 `primary` 属性	`@Primary`
`<bean>` 的 `init-method` 属性	`@Bean` 的 `initMethod` 属性
`<bean>` 的 `destroy-method` 属性	`@Bean` 的 `destroyMethod` 属性

三、附录

1. 配置属性

属性	描述
`context:component-scan`	在基于 XML 配置容器中，指定扫描包路径

2. 常用注解

注解	描述
`@Configuration`	指定 Bean 的配置类
`@ComponentScan`	（默认为类所在的包）指定包路径，该包下的类由容器管理
`@Component`	指定该类由 Spring 容器管理
`@ImportResource`	注解配置中导入 XML 配置文件