Spring核心——注解自动装载

从配置上扩展

之前的文章介绍了Spring的IoC容器配置管理方面的详细内容,需要了解的可以从IoC容器的设计模式开始阅读。在介绍基于注解配置的配置之前我们再重复一下在之前提到的基本认识:

Spring的基本工作单位是Bean,所有的高级功能都是在Bean的基础上扩展而来的。Bean可以理解成Java类的一个实例。

Bean只是一个个体,Spring用一个名为IoC(Inversion of Control控制反转)的容器来管理所有的Bean。

Spring的核心功能就是管理Bean与Bean之间、IoC容器与Bean之间的依赖、组合关系。这些关系通过XML配置来定义。

基于以上3点,对XML配置有清晰的理解对Spring核心框架的使用至关重要。在Spring没有注解(Annotation)之前,我们都是通过XML配置来实现Spring的功能,而在3.x版本之后,我们可以仅使用注解而无需XML即可运行Spring。注解并没有扩展Spring的核心功能,他仅仅是将原来XML上的配置迁移到Java源码中以“元数据”(bytecode metadata)的方式提供非侵入式(non-invasive)的框架服务。所以无论XML配置还是注解的方式,或者两者混合使用都可以实现Spring提供的所有功能。

在之前IOC功能扩展点一文中介绍了BeanDefinition的适配器模式。了解BeanDefinition的作用之后就能明白无论是注解还是XML配置,最后都会转化为一个BeanDefinition结构让IoC容器来执行初始化。

Spring的注解相关的功能是在2.x版本开始出现然后到3.x才全部完善的,支持JCP制定的JSR-250和JSR-330。所以在使用注解的时候需要注意版本号。

启用Annotation配置功能

在使用注解功能之前要告诉IoC现在需要启用注解相关的功能,通过上下文级别的配置即可开启所有注解相关的功能:


官配后置处理器一文已经介绍了注解的处理都是通过后置处理器实现的,所以添加了这个配置之后在实现层面会向IoC容器增加AutowiredAnnotationBeanPostProcessor,CommonAnnotationBeanPostProcessor,PersistenceAnnotationBeanPostProcessorRequiredAnnotationBeanPostProcessor这几个后设置处理器。每个处理器都针对某一个或者某些注解进行处理。

还有,如果在工程中混合使用注解和XML配置,如果同一个Bean同时在XML和注解都进行了配置,那么最终生效的是XML上的配置,因为Spring容器会先处理注解再处理XML配置。

下面是关于自动装载的注解介绍:

@Autowired

这个注解应该是使用spring最常用的注解,也是IoC容器反向依赖注入的极致体现。基本上容器里有什么实现我们根本不必操心,之需要声明一个接口加一个@Autowired就可以获得对应的接口功能。如果不使用参数的话@Autowired的效果就相当于BeanFactory.getBean(Class<T> )。

多种方法注入数据

@Autowired可以直接写在域(成员变量)上、可以用在一般的方法和构造方法上:



获取同一个接口的多个实现

如果容器中同一个接口有相同的实现,我们可以用数据、列表或Map结构来获取多个Bean:

interfaceA{}

classimplA1implementsA{}

classimplA2implementsA{}

classMyClass{

@Autowired

privateA[] a;

@Autowired

privateSet set;

@Autowired

privateMap map;

}

使用Map时,key必须声明为String,在运行时会key是注入Bean的name/id。

声明非必要数据

当我们使用@Autowired时,如果容器中没有我们所需的Bean会抛出异常。当这个Bean并不是必要数据时可以使用@Autowired的required参数:

interfaceA{}

classMyClass{

@Autowired(required=false)

privateA a;

}

自动空指针处理

在Java8之后专门为空指针处理添加了Optional这个工具类。在4.x之后Spring在注入数据阶段会根据目标对象自动进行包装:

interfaceA{}

classimplimplementsA{}

classMyClass{

@Autowired(required=false)

privateOptional a;

}

这个时候在容器中存放的是接口A的实现类,但是会自定根据注入对象的声明新建一个Optional包装的Bean。

在5.x版本之后还可以使用JSR-305提出的@NullAble告诉IoC这里可以注入一个空指针数据或什么也不需要。

interfaceA{}

classimplimplementsA{}

classMyClass{

privateA a;

publicvoidsetA(@Nullable A a){

this.a = a;

}

}

获取容器中的所有资源

除了我们自己声明的接口、类,@Autowired还可以获取Spring定义的所有Bean,凡是只要在IoC容器中的Bean都可以通过它来获取:

classMyClass{

@Autowired

privateApplicationContext context;

}

不过需要注意的是,这些注解(Annotation)支持的功能都是由后置处理器实现的,所以无法自动注入后置处理器(BeanPostProcessor或BeanFactoryPostProcessor)。

JSR-330支持

JSR-330提出了反向依赖注入的相关内容,主要是关于@Inject、@ManagedBean、@Singleton的作用和实现方式。使用@Inject可以替换@Autowired的绝大部分功能,但是还有些许的差异。使用JSR-330要引入javax.inject包,maven的配置如下:


然后可以用@Inject注解任何使用@Autowired的地方,唯一的区别是@Inject没有required参数,如果要实现对应的功能只能通过注入Optional<Class<T>>的方式实现。

对自动装配的控制

@Autowired虽然好用,但是也会遇到一些问题,比如当容器中有2个类实现同一个接口的时候在运行时注入就会抛出异常,针对这个问题Spring提供了一些针对自动装配更细节的操作——Primary和Qualifiers。

Primary控制自动装配

Primary字面意思就是主要的,意思是告诉容器这个Bean是“主”Bean。实现Primary有两种方式,通过在@Configuration中注解实现或在XML配置中实现。

首先是配置方式。有一个接口A、有2个A的实现类ImplFirst和ImplSecond,然后在功能类MyClass中自动装配了接口A:

interfaceA{}

classImplFirstimplementsA{}

classImplSecondimplementsA{}

classMyClass{

@Autowired

privateA a;

}

 在配置文件中我们可以使用primary属性来控制注入哪一个实现类。

<!-- 自动装配时会使用这个Bean -->

此外,我们还可是使用Java配置功能(@Configuration相关的Java配置内容后续篇幅会介绍)指明“主”Bean。将XML配置文件替换为下面的Java配置形式:

@Configuration

classMyClassConfig{

@Bean

@Primary

publicAfirstImpl(){

returnnewImplFirst();

}

@Bean

publicAsecondImpl(){

returnnewImplSecond();

}

}

Qualifiers控制自动装配

Primary是类的实现者决定使用那个一个类,而Qualifiers是让类的使用者来确定使用哪一个类。先看一个最基本的用法:



这样通过@Qualifiers注解就制定加载了ImplFIrst这个类。不过Spring官方并不建议这样去使用Qualifiers。主要的原因是失去了@Autowired的使用初衷——在使用的时候还需要去了解<bean>的定义结构。官方建议通过别名的形式告知每一个类的作用,然后通过Qualifiers来使用。例如我们还是用组装电脑的例子:



<qualifier value="Intel"/>可以声名当前的Bean对应的Qualifier的名称。这样完全就将Id和Qualifer定义的名称隔离开,我们可以使用规范来约定使用的功能内容。

还可以通过继承@Qualifier来实现我们更细节的控制和管理,我们将上面的代码进行如下修改:



在<qualifier>中type指向的注解类可以是全限定名,也可以用短编码。

我们还可以在继承的注解中使用自定义参数。例如:


配置:


©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,377评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,390评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,967评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,344评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,441评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,492评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,497评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,274评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,732评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,008评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,184评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,837评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,520评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,156评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,407评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,056评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,074评论 2 352

推荐阅读更多精彩内容