依赖注入(DI)
DI(Dependency Injection),Spring IoC 不是一种技术,而是一种思想,通过这种思想,能够指导我们设计出松耦合的程序代码。而Spring IoC这个思想的作用体现在两个方面,一是如何将Bean装配到容器中去以及如何从容器中获取Bean,二是如何解决Bean之间的依赖关系,换句话说,就是如果由IoC容器来管理依赖关系,当一个Bean需要依赖另外一个Bean时,IoC容器如何实现这样的依赖关系。
解决Spring中Bean之间的依赖的实现方式,在Spring的概念中就被称之为依赖注入(Dependency Injection,DI)。普遍认为的Spring依赖注入的实现方式有三种:构造方法注入、setter方法注入、注解注入。但,就我而言,我认为应该划分为两种形式——基于XML注入和基于注解注入,然后再细分为下面的形式:
基于XML的注入方式是我们最先学习和使用的方式,也是最熟悉的方式,就简单的做个介绍,举个例子。
- 通过构造方法注入
public class UserServiceImpl implements UserService {
private UserDao userDao;
public UserServiceImpl(UserDao userDao) {
this.userDao = userDao;
}
/**继承自UserService的方法**/
}
首先定义一个服务层UserServiceImpl
,然后在其内部增加对dao层的引用userDao
。
接下来就是添加一个构造方法public UserServiceImpl(UserDao userDao)
以待Spring通过这个方法为userDao
注入实例。
<!--注册userDao-->
<bean id="userDao" class="com.klasdq.sb.c1.di.dao.impl.UserDaoImpl"></bean>
<!--注册userService 并注入userDao-->
<bean id="userService" class="com.klasdq.sb.c1.di.service.impl.UserServiceImpl">
<constructor-arg name="userDao" ref="userDao"></constructor-arg>
</bean>
最后在Spring XML配置文件中注入相应的bean实例。
通过构造方法的注入,必须要注入类中具有对应的构造方法,若没有对应的构造方法,会出现报错。
- 通过setter方法注入
修改UserServiceImpl.java
为:
public class UserServiceImpl implements UserService {
private UserDao userDao;
public void setUserDao(UserDao userDao) {
this.userDao = userDao;
}
/**继承自UserService的方法**/
}
再修改XML文件内容为:
<!--注册userDao-->
<bean id="userDao" class="com.klasdq.sb.c1.di.dao.impl.UserDaoImpl"></bean>
<!--注册userService 并注入userDao-->
<bean id="userService" class="com.klasdq.sb.c1.di.service.impl.UserServiceImpl">
<property name="userDao" ref="userDao"></property>
</bean>
这两种方式的区别在于,一、UserServiceImpl.java
可以不用添加构造方法,但是必须存在一个无参构造方法(如public UserServiceImpl()
,示例里面没写,是因为java默认会提供一个无参构造方法)以供Spring 容器注册生成Bean(如userService
)。二、XML文件中,采用构造方法注入时,需要使用<constructor-arg ></constructor-arg>
这对标签;而在setter方法注入时,使用<property ></property>
标签。
在XML注入过程中,除了使用ref=""
引用之外,还可以使用value=""
设定具体的值,其效果和使用注解@Value
差不多。
基于注解的依赖注入
@Autowired
- 源码
@Target({ElementType.CONSTRUCTOR,
ElementType.METHOD,
ElementType.PARAMETER,
ElementType.FIELD,
ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Autowired {
boolean required() default true;
}
@Autowired
是基于注解的依赖注入的关键点,它的源码非常简单,只有一个参数request()
,这个参数的作用是标识注入Bean是否一定要注入,也就是说,在Spring容器没有找到相应Bean时,如果其值为true
,就会报出异常;如果其值为false
,就不会出现异常,但在使用过程中,如果容器一直不对Bean进行注入,那么有可能出现空指针异常。
另外一点就是,源码当中的@Target
所包含的参数正好就是基于注解的依赖注入的注入方式种类,@Target
决定了@Autowired
能够标注在哪些类型上面。
- 通过构造方法注入
@Service("userService")
public class UserServiceImpl implements UserService {
private UserDao userDao;
@Autowired
public UserServiceImpl(UserDao userDao) {
this.userDao = userDao;
}
/**继承自UserService的方法**/
}
根据开发文档的说法,这种只有一个构造方法的情况,自Spring4.3以后,就不再需要添加 @Autowired
标注,也可以。但是,如果有多个构造方法时,是必须要对其中一个方法标注 @Autowired
,不然Spring会报出异常。
- 通过setter方法注入
@Service("userService")
public class UserServiceImpl implements UserService {
private UserDao userDao;
@Autowired
public void setUserDao(UserDao userDao) {
this.userDao = userDao;
}
/**继承自UserService的方法**/
}
- 通过字段注入
@Service("userService")
public class UserServiceImpl implements UserService {
@Autowired
private UserDao userDao;
/**继承自UserService的方法**/
}
- 通过方法入参注入
上面三种注入方式,都是比较熟悉的就不再多做阐述了。重点说一下参数注入,其实方法入参注入方式感觉上是和构造方法、setter方法注入形式差不多,相当于将构造方法、setter方法上的注解@Autowired
放到入参的位置。说起来可能有些抽象,直接看例子:
@Component
public class UserDaoImpl implements UserDao {
//简单返回一个User,模拟数据库查找过程
@Override
public User getUser(Long id, String name){
User user = new User();
user.setId(id);
user.setName(name);
user.setAccount("12345678911");
user.setPassword("******");
user.setOtherInfo("this is a test account");
return user;
}
}
//UserService类
@Service("userService")
public class UserServiceImpl implements UserService {
private UserDao userDao;
public UserServiceImpl(@Autowired UserDao userDao,
@Autowired User user) {
System.out.println("UserServiceImpl: "+user);
this.userDao = userDao;
}
@Override
public User getUser(Long id, String name){
return userDao.getUser(id,name);
}
}
//简单的配置类
//作用就是为标有@Componet(@Service也算)注解的类 生成Bean
//同时 为@Autowired标识下的Bean(对象) 注入实例
@Configuration
@ComponentScan
public class DIConfig {
//用于Service类中入参user的注入
@Bean
public User getUser(){
User u = new User();
u.setName("user inject into service");
return u;
}
}
//测试类
//注意:使用JUnit4测试时,如果需要使用@Autowired注入那么必须添加
//@RunWith 标注使用Spring方式启动(或者SpringBootRunner)
//@ContextConfiguration 扫描配置类
@RunWith(SpringRunner.class)
@ContextConfiguration(classes = DIConfig.class)
public class DITest {
//如果不添加测试类上两个注解,会注入失败
@Autowired
private UserService userService;
@Test
public void testAutowired(){ System.out.println(userService.getUser(1L,"name"));
}
}
运行测试方法之后就得到以下结果:
public UserServiceImpl(@Autowired UserDao userDao,@Autowired User user)
中的输出结果:
public void testAutowired()
测试方法中的输出结果:
注意这里public UserServiceImpl(@Autowired UserDao userDao,@Autowired User user)
的入参:
userDao
是UserServiceImpl
的字段,但user
不是。也就是说,我们可以在构造方法中添加任意参数,只要是我们需要的,不一定要求该参数是类中属性字段。
此外还有需要注意的是,这里所说的方法,不是任意的方法,而是构造方法或setter方法,这种public void initService(@Autowired UserDao userDao)
自定义的方法是无法完成注入的。
@Primary 和 @Qualifier
在上面的例子中,我们注入使用到的bean,都只是容器中只有一个Bean实例的情况。那么当容器当中出现多个同类型的Bean
时,如何处理呢?
修改配置类代码如下:
@Configuration
@ComponentScan
public class DIConfig {
@Bean
public User getUser(){
User u = new User();
u.setName("this is user");
return u;
}
@Bean
public User getUser2(){
User u = new User();
u.setName("this is user2");
return u;
}
}
修改测试类:
@RunWith(SpringRunner.class)
@ContextConfiguration(classes = DIConfig.class)
public class DITest {
@Autowired
private User user;
@Test
public void testAutowiredPriamry(){
System.out.println(user);
}
}
当不做其他处理时,结果为:
因为有两个User Bean(getUser , getUser2
,@Bean未注明的情况下,默认方法名为Bean Name)的存在,所以Spring无法确定使用那个进行注入。
修改方式:
- 在
@Bean
中设置name,如@Bean(name="user")
,当名字能够匹配上private User user;
时,也能完成注入。 - 将
private User user
改写成getUser
或getUser2
任意一个,也能完成注入。道理和上面一样,Spring首先会按照type进行匹配,如果无法匹配,再按照名字匹配,都匹配不上时,自然抛出异常。
除此之外呢,Spring为我们提供了两个注解来消除依赖注入时的歧义问题。
@Primary
@Target({ElementType.TYPE, // 类、接口、枚举类型
ElementType.METHOD})// 方法
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Primary {
}
@Primary
是一个设定相同类型Bean优先级的注解,也就是说,一旦在某个类型上添加@Priamry
,当注入时,没有明确指定Bean时,就会注入被@Priamry
标识的Bean。
@Configuration
@ComponentScan
public class DIConfig {
@Primary
@Bean
public User getUser(){
User u = new User();
u.setName("this is user");
return u;
}
@Bean
public User getUser2(){
User u = new User();
u.setName("this is user2");
return u;
}
}
比如上面这样,在getUser()
上添加相应注解,测试方法也能正常运行。
但是这种方法的问题就在于@Priamry
可以用在很多类上,如果同一类型有多个Bean被标注了@Primary
,那么@Priamry
就失去了应有的效果。
@Qualifier
因此,Spring又提供了@Qualifier
这个注解,直接标注在@Autowired
注入的Bean上,为其明确指定注入某个Bean。
@Target({ElementType.FIELD,
ElementType.METHOD,
ElementType.PARAMETER,
ElementType.TYPE,
ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Qualifier {
String value() default "";
}
@Qualifier
可以出现任何@Autowired
能够出现的地方,与之配套使用。比如下面这样:
@RunWith(SpringRunner.class)
@ContextConfiguration(classes = DIConfig.class)
public class DITest {
//直接指定使用getUser2进行注入
@Autowired
@Qualifier("getUser2")
private User user;
@Test
public void testAutowiredPriamry(){
System.out.println(user);
}
}
这两种注解都可以消除歧义,推荐使用@Bean(name="xxx")和@Qualifier(value="xxx")
组合使用的方式`。但是如果开发环境中没有歧义的存在,自然也就不需要使用这些了。
当然,上面只是对于@Autowired
一些常用介绍,如果想要了解更多,可以查看Annotation-based Container Configuration。这个参考文档当中有着更加详细、丰富的介绍。
总结
总得来说,Spring是如何实现IoC的呢?首先,Spring提供了一个获取和管理Bean的IoC容器。然后,再提供了一套依赖注入的机制去帮助IoC容器更好地管理各个Bean之间的依赖关系,从而更好地实现IoC的思想。一个Bean不可能完全脱离其他Bean的依赖关系而独立存在,当一个Bean需要其他Bean的引入才能初始化时,就需要依赖注入这个机制。
举例来说,假如存在一个A类想要去调用B接口的方法或者说需要B接口的一个实例。
传统的程序流程是,使用一个C类实现B接口,然后A类创建一个C类的实例,从而调用其方法。
在Spring的依赖注入过程中就变成了,A类只需要在自己的内部添加一个注入接口(广义上的接口,不是interface
这个接口),这个接口可以是构造方法,也可以是setter方法或者说其他形式;同时添加一个对B接口的引用(private B b;
)。
当真正需要生成A类的实例时,Spring IoC容器根据A类提供的接口,为其注入相应的Bean,而这个Bean可以是C类(class C implements B
{}),也可以D类(class D implements B
{})等等;具体是谁,根据Bean的装配策略和IoC容器中的Bean来确定,不再由开发人员管理。
公众号:良许Linux