Elim的博客

用来记录一些原创性的总结


Elim

17 对JSR330标准注解的支持

除了使用Spring标准的注解来定义bean、定义bean之间的依赖关系外,Spring还支持使用JSR330标准的注解来进行相关的定义,主要是对@Inject和@Named两个注解的支持。

要使用JSR330标准的注解进行对应的bean定义,我们首先需要将JSR330标准对应的jar包加入我们的classpath。笔者习惯使用Maven来管理相应的依赖,所以笔者只需要在项目的pom.xml文件中加入如下依赖项即可。

<dependency>
	<groupId>javax.inject</groupId>
	<artifactId>javax.inject</artifactId>
	<version>1</version>
</dependency>

17.1 @Inject

@Inject注解的功能相当于Spring标准中的@Autowired注解的功能。其是用来定义自动注入的,而且与@Autowired一样,@Inject可以标注在field、method或constructor上。

1、标注在field上

public class Hello {
	
	@Inject
	private World world;
	
}

2、标注在method上

public class Hello {
	
	private World world;
	
	@Inject
	public void doSomething(World world) {
		this.world = world;
	}

}

对于方法注入的情况也可以通过一个方法同时注入多个bean,具体如下所示。

public class Hello {
	
	private World world;
	private BeanA beanA;
	
	@Inject
	public void doSomething(World world, BeanA beanA) {
		this.world = world;
		this.beanA = beanA;
	}

}

3、标注在constructor上

public class Hello {
	
	private World world;
	private BeanA beanA;
	
	@Inject
	public Hello(World world, BeanA beanA) {
		this.world = world;
		this.beanA = beanA;
	}

}

@Inject在进行自动注入时默认会根据field的名称、method参数的名称寻找对应的bean进行注入,当然这种机制也可以通过@Named或@Qualifier来进行改变。如在上述示例中@Inject标注在field上的情况,我们看到对应的field的名称为“world”,那么当我们的bean容器中有如下两个bean时,将默认注入beanName为world的那个bean。

<bean id="world" class="com.elim.learn.spring.bean.World" p:id="1"/>
<bean id="world2" class="com.elim.learn.spring.bean.World" p:id="2"/>

同样的机制对于方法注入和构造方法注入也是适用的。就这一点而言,我觉得@Inject比@Autowired好用。当容器中不存在对应名称的bean时,将根据类型进行注入,当容器中不存在对应类型时Spring将抛出异常,@Inject没有像@Autowired那样可以指定是否required的属性,所以一旦我们配置了某个field或method等为@Inject,那么bean容器中就一定需要存在对应类型的bean,否则Spring就将抛出异常。另外,当容器中不存在@Inject所标注的field对应名称或method对应参数名称的bean存在时,Spring将根据类型进行注入,如果此时bean容器中存在相同类型的多个bean时,Spring也会抛出异常。这个时候我们就可以通过@Named来指定具体需要注入哪个bean,当然使用@Autowired支持的@Qualifier也是可以的。

17.2 @Named

@Named的功能就相当于Spring标准注解中的@Qualifier。与@Qualifier一样,@Named注解也可以标注在任何@Inject或@Autowired出现的地方,如field、方法参数等。同时@Named也可以标注在类上,当使用@Named标注在类上时其功能就相当于在类上使用@Component进行标注,通过其value属性也可以指定Spring扫描后添加bean定义时对应bean的beanName。而@Qualifier标注在类上时只是定义对应bean的qualifier。

public class Hello {
	
	@Inject
	@Named("world1")
	private World world;

}

上述示例我们使用@Named明确的表示将注入beanName为“world1”的那个bean。需要注意的是使用@Named进行标注时将寻找对应beanName的bean,且一定是beanName,这一点与@Qualifier是不一样的,@Qualifier还可以对应对应bean的qualifier。如上述@Named(“world1”)对应如下这样的配置是行不通的,但如果将@Named(“world1”)替换成@Qualifier(“world1”)它又是可以的。

<bean id="world" class="com.elim.learn.spring.bean.World" p:id="1">
	<qualifier value="world1"/>
</bean>

如下是一个使用@Named标注在通过方法进行注入的方法参数上的示例。

public class Hello {
	
	private World world;
	private BeanA beanA;
	
	@Inject
	public void doSomething(@Named("world2") World world, BeanA beanA) {
		this.world = world;
		this.beanA = beanA;
	}

}

当使用@Named标注在类上时,其功能和用法都与@Component是一样的。如果我们启用了Spring扫描类路径的功能,那么Spring默认也会扫描标注了@Named的类,并将它们作为一个bean定义到对应的bean容器中。如下就是一个使用@Named标注在类上的示例。

@Named
public class Hello {
	
	private World world;
	private BeanA beanA;
	
	@Inject
	public void doSomething(@Named("world2") World world, BeanA beanA) {
		this.world = world;
		this.beanA = beanA;
	}

}

使用@Named标注在类上时,如果没有通过value属性指定对应的beanName,则默认会取类名将首字母小写作为对应的beanName。如上述示例,默认就将使用“hello”作为beanName。

(注:本文是基于Spring4.1.0所写)