第5章-Spring三种配置方式的混合和迁移

Spring 容器的配置方式有三种，在实际项目中，可能会遇到混合使用的情况，也可能需要从一种方式迁移到另一种方式。

• 《Spring基于 XML 配置的容器》
• 《Spring基于注解配置的容器》
• 《Spring基于Java配置的容器》

一、配置兼容

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

1. 优先 XML 配置

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

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

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 配置中的和标签，等效于 Java 配置中的@Configuration和@Bean配置。

等效于：

@Configuration
public class AppConfig {

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

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

XML配置	注解配置
	@ComponentScan
的 id 属性	@Bean 的 value 或 name 属性
的 scope 属性	@Scope
的 depends-on 属性	@DependsOn
的 lazy-init 属性	@Lazy
的 primary 属性	@Primary
的 init-method 属性	@Bean 的 initMethod 属性
的 destroy-method 属性	@Bean 的 destroyMethod 属性

三、附录

1. 配置属性

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

2. 常用注解

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

3. 示例代码

Gitee 仓库：https://gitee.com/code_artist/spring
项目模块：spring-ioc
示例路径：cn.codeartist.spring.bean.mix

最新文章关注 CodeArtist 码匠公众号。