Spring学习Bean配置的三种方式(XML、注解、Java类)介绍与对比

本文将详细介绍Spring Bean配置的三种不同方式的特点与使用条件。

主要包括:


  • 基于XML的配置方式
  • 基于注解的配置方式
  • 基于Java类的配置方式

一.基于XML的配置

请看Spring学习(十二)Spring 的配置文件概述

二.基于注解的配置

Spring2.0​开始引入基于​注解​的配置方式,即Bean的定义信息可以通过在Bean的实现类上标注注解实现。

具体关于注解的知识请看Java注解(Annotation)介绍

@Component​是Spring容器中的基本注解,表示容器中的一个组件(​bean​),可以作用在任何层次,下面的示例介绍该注解的使用方法。

注解配置示例:



  1. @Component("userDao")
  2. public class userDao{......}

他等效于XML配置

<bean id="userDao" class="cn.lovepi.***.userDao"/>

此外,还有一些其他的可以被用来注解bean的注解,这些可以让注解类本身的用途更加清晰,此外,特定的注解也具备特定的功能。

Spring在2.5后提供了一个​context​的命名空间,它提供了通过扫描​类包​来加载利用注解定义的Bean的方式。

在context中可以使用​resource-pattern​来过滤出特定的类。

<context:component-scan base-package="cn.lovepi.spring" resource-pattern="anno/*.class"/>

默认情况下加载的是package下的*.class即扫描全部类,在使用了resource-pattern之后,则只扫描package下的anno子包下的所有类。

不过使用resource-pattern并不能提供给我们完善的功能,所有我们得使用​过滤子元素​的方法。



  1. <context:component-scan base-package="cn.lovepi.spring">
  2. <context:include-filter type="regex" expression="cn.lovepi.spring.*"/>
  3. <context:exclude-filter type="aspectj" expression="cn.lovepi..*Controller+"/>
  4. </context:component-scan>

其中:

include-filter​表示要包含的目标类,

exclude-filter​表示要排除在外的目标类

一个​component-scan​标签下可以有​多个​include-filter和exclude-filter,

过滤表达式所支持的​类型​如下表所示:

在这些类型当中,除了​Custom​外,​aspectj​的过滤功能最强大,他能轻易的实现其他类别的过滤规则。

Spring3.0提供了一系列的针对依赖注入的注解,这使得Spring IoC在XML文件之外多了一种可行的选择,主要包含如下注解类型:


  • Bean的定义注解
  • Bean的生命周期注解
  • Bean的依赖检查注解
  • Bean的自动装配注解

1.Bean的定义注解

Spring自2.0开始,陆续引入了一些注解用于简化Spring的开发。

@Repository​注解便属于最先引入的一批,用于将​数据访问层​(DAO层)的类标识为Spring Bean。具体使用如下:

①首先使用​@Repository​将DAO类声明为Bean



  1. @Repository
  2. public class UserDaoImpl implements UserDao{......}

②在XML配置文件中启动Spring的自动扫描功能



  1. <beans ...>
  2. <context:component-scan base-package="cn.lovepi.dao"/>
  3. ......
  4. <beans/>

如此的话,我们便不在需要在XML当中显式使用bean来进行bean的配置。Spring容器在初始化的时候便会自动扫描base-package所指定的包以及子包下面的所有class文件。所有标注为Repository的类将被自动注册为bean。

为什么Repository只能标注在DAO类上面呢?

因为该注解的作用不只是将类识别为bean,同时他还能将所标注的类中所抛出的​数据访问异常​封装为​Spring的数据访问异常类型​。Spring本身提供了一个丰富的,并且是与具体的访问技术无关的数据访问异常结构,用于封装不同的持久层框架所抛出的异常,使得​异常独立与底层的框架。

Spring2.5在@Repository的基础上增加了功能类似的额外三个注解,总共有如下四种注解:


  • @Component:​一个泛化的概念,表示一个组件(​Bean​),可作用在任何层次
  • @Controller:​用于对​Controller​实现类进行标注,目前该功能与Component相同
  • @Repository:​用于对​DAO​实现类进行标注
  • @Service:​用于对​Service​实现类进行标注,目前该功能与Component相同

这三个注解除了作用于不同软件层次的类,其使用方式与Repository是完全相同的。

2.Bean的生命周期注解

在某些情况下,可能需要我们手工做一些额外的初始化或者销毁操作,例如资源的获取和是否操作,​Spring1.x​为此提供了两种方式供用户​指定执行生命周期回调​的方法:


  1. 实现Spring提供的两个接口:​initializingBean​ 和 ​DisposableBean​,这种方法是要求bean类实现Spring的接口,但增加了bean和Spring容器的耦合度,因此不推荐使用。
  2. 在XML文件中使用<bean>的​init-method​ 和 ​destory-method​ 属性,指定初始化之后和回调之前的回调方法。这两个属性的取值是bean中相应的初始化和销毁方法的名称。​方法名称任意,但是方法不能有参数。

示例如下:



  1. <bean id="userService" class="cn.lovepi.***.UserService"
  2. init-method="init" destory-method="destory">
  3. </bean>

在这里,我们指定了userService 这个bean的初始化方法为:init 销毁方法为:destory

Spring2.5​在保留以上两种方式的基础上,提供了对​JSR-250​的支持。

JSR-250​规范定义了两个用于指定声明周期方法的注解:


  • @PostConstruct​:初始化之后的执行的回调方法
  • @PreDestroy​:销毁之前的回调方法

注解示例说明:



  1. public class PersonService{
  2. @PostConstruct
  3. public void init(){......}
  4. @PreDestory
  5. public void destory(){......}
  6. }

在这里init方法是初始化之后执行的方法,而destory方法为销毁之前执行的方法

由于使用了注解,所以得​激活Bean的后处理器​,所以得在XML配置文件当中增加

<context:annotation-config/>

3.Bean的依赖检查注解

Spring2.0​之前使用​dependency-check​在配置文件中设置属性用于​依赖检查​(只会检查Setter方法是否被调用),缺点是​粒度较粗​,该属性的取值包括以下几种:


  • none​: 默认不执行依赖检查
  • simple​ :对原始基本类型和集合类型进行检查
  • objects​ :对复杂类型进行检查
  • all​ :对所有类型进行检查

使用​Spring2.0​提供的​@Required​注解,提供了​更细粒度​的控制,​@Required​注解只能标注在Setter方法之上,(标注在其他方法之上会被忽略 )用于检查其是否被调用,当Setter方法未被调用的话会​抛出异常​。

由于使用了注解,所以得​激活Bean的后处理器​,所以得在XML配置文件当中增加

<context:annotation-config/>

4.Bean的自动装配注解

@Autowired​可以对成员变量、方法和构造函数进行标注,来完成自动装配的工作,他根据​类型​进行自动装配,如果需要按​名称​进行装配,则需要配合​@Qualifier​使用。

当标注了@Autowired的方法所需的​类型​在Spring容器中不存在的话会​抛出异常



  1. @Service
  2. public class LoginService{
  3. @Autowired
  4. private LogDao logDao;
  5. }

如上面的例子所示,假如Spring容器中没有LogDao这个bean的话便会抛出异常。

解决的办法便是使用​required=false​属性来标注



  1. public class LoginService{
  2. @Autowired(required=false)
  3. private LogDao LogDao;
  4. }

但是假如Spring当中存在多个所需类型的bean,那么便要使用​@Qualifier​注解来指定名称。



  1. public class LoginService{
  2. @Autowired
  3. @Qualifier("userDao")
  4. private UserDao userDao;
  5. }

@Autowired​ 可以对类中​集合类​的变量或方法入参进行标注,此时会将容器中​类型匹配的所有Bean​都注入进来,如下所示:



  1. public class loginService{
  2. @Autowired(required=false)
  3. public List<Plugin> pligins;
  4. public List<Plugin> getPlugins(){
  5. return plugins;
  6. }
  7. }

Spring会将容器中所有类型为Plugin的bean都注入到集合中去。

三.基于Java类的配置

基于Java类定义Bean配置元数据,其实就是通过Java类定义Spring配置元数据,且直接消除XML配置文件。

首先让我们看一下基于Java类如何定义Bean配置元数据,具体步骤如下:


  1. 使用@Configuration注解需要作为配置的类,表示该类将定义Bean的元数据
  2. 使用@Bean注解相应的方法,该方法名默认就是Bean的名称,该方法返回值就是Bean的对象。
  3. AnnotationConfigApplicationContext或子类进行加载基于java类的配置

接下来通过示例来演示下如何基于Java类来配置Spring

首先创建一个配置类



  1. @Configuration
  2. public class ApplicationContextConfig {
  3. @Bean
  4. public String message() {
  5. return "hello";
  6. }
  7. }<strong>
  8. </strong>

然后还需要一个测试类,来查看配置是否成功



  1. public class ConfigurationTest {
  2. public static void main(String[] args) {
  3. AnnotationConfigApplicationContext ctx =
  4. new AnnotationConfigApplicationContext(ApplicationContextConfig.class);
  5. System.out.println(ctx.getBean("message"));
  6. }
  7. }

通过​@Configuration​注解的类将被作为配置类使用,表示在该类中将定义Bean配置元数据,且使用@Configuration注解的类本身也是一个Bean,使用方式如下所示:



  1. @Configuration("ctxConfig")
  2. public class ApplicationContextConfig {
  3. ……
  4. }

其中Configuration中的​参数值​即为该bean的​名称​。

通过​@Bean​注解配置类中的相应方法,则该方法名默认就是Bean名,该方法返回值就是Bean对象,并定义了Spring IoC容器如何实例化、自动装配、初始化Bean逻辑,具体使用方法如下:



  1. @Bean(name={},
  2. autowire=Autowire.NO,
  3. initMethod="",
  4. destroyMethod="")

其中name为bean的名称,可以有多个,autowire为是否自动装配,默认值为NO,initMethod为bean的初始化方法,destoryMethod为bean的销毁方法。

bean的注解具体使用如下:



  1. @Bean
  2. public String message() {
  3. return new String("hello");
  4. }

如上的代码等价与XML配置:



  1. <bean id="message" class="java.lang.String">
  2. <constructor-arg index="0" value="hello"/>
  3. </bean>

注意​:​使用bean注解的方法不能是private、final、static的。

基于Java方式的配置方式不是为了完全替代基于XML方式的配置,两者可以结合使用,因此可以有两种结合使用方式:


  • 在基于Java方式的配置类中引入基于XML方式的配置文件
  • 在基于XML方式的配置文件中中引入基于Java方式的配置

引入基于XML配置文件:



  1. <bean id="message" class="java.lang.String">
  2. <constructor-arg index="0" value="test"></constructor-arg>
  3. </bean>


  4. @Configuration("ctxConfig")
  5. @ImportResource("classpath:com/jike/***/appCtx.xml")
  6. public class ApplicationContextConfig {
  7. ……
  8. }

可以看到在java程序中使用​@ImportResource​导入了XML的配置文件

引入基于Java的配置文件:



  1. <context:annotation-config/>
  2. <bean id="ctxConfig" class=“com.jike.***..ApplicationContextConfig"/>

  3. //测试类
  4. public void testXmlConfig() {
  5. String configLocations[] = {" classpath:com/jike/***/appCtx.xml"};
  6. ApplicationContext ctx = new ClassPathXmlApplicationContext(configLocations);
  7. ……
  8. }

可以看到在​XML​的配置文件当中将java的配置类当中Bean来声明,第一行的是开启注解驱动支持。

值得注意的是必须得配置​<context:annotation-config/>​在XML配置文件中。

Spring提供了一个​AnnotationConfigApplicanContext​类,能够​直接​通过标注​@Configuration​的Java类启动Spring容器:

通过构造函数加载配置类:

ApplicationContext ctx = new AnnotationConfigApplicationContext(AppConf.class);

通过编码方式注册配置类:



  1. AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
  2. ctx.register(DaoConfig.class);
  3. ctx.register(ServiceConfig.class);
  4. ctx.refresh();

可以看到ctx注册了多个configuration类,然后通过refresh类来刷新容器以应用这些配置文件。

可以通过代码一个个的引入配置类,当然也可以使用​@Import​注解来引入配置类

引入多个配置类:



  1. @Configuration
  2. @Import(DaoConfig.class)
  3. public class ServiceConfig {……}

总结:不同配置方式比较

我们来看一下不同配置方式在不同方面的使用

其实Spring支持这么多的配置方式,那么这些配置方式必然有其自己独特的舞台

基于XML的配置主要使用场景:


  • 第三方类库,如DataSource、JdbcTemplate等;
  • 命名空间,如aop、context等;

基于注解的配置主要使用场景:

  • Bean的实现类是当前项目开发的,可直接在Java类中使用注解配置

基于Java类的配置主要使用场景​:

  • 对于实例化Bean的逻辑比较复杂,则比较适合用基于Java类配置的方式

在日常的开发中我们主要是使用​XML配置​和​注解配置​方式向结合的开发方式,一般不推荐使用基于Java类的配置方式。


作者:​​小a玖拾柒​​​ ​

-------------------------------------------

个性签名: 所有的事情到最後都是好的,如果不好,那說明事情還沒有到最後~

本文版权归作者【​​小a玖拾柒​​​】,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利!