一、配置兼容
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 { }
注解配置中使用 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配置。
<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 配置文件 |
3. 示例代码
Gitee 仓库:
https://gitee.com/code_artist/spring
项目模块:
spring-ioc
示例路径:
cn.codeartist.spring.bean.mix