SpringBoot实战之 为什么Spring官方不推荐使用@AutoWired 属性注入?

作者:gaoqiang 时间:23-03-12 阅读数:126人阅读

SpringBoot实战之 为什么Spring官方不推荐使用@AutoWired 属性注入?

在实际开发中,很多码友,都喜欢使用@Autowired 注解进行依赖注入,这个时候 IDEA 就会报黄色警告,代码一片warning,强迫症的我看着就很不爽,所以必须搞清楚,为什么会有这样的警告? 首先我们先搞清楚JAVA类对象创建的过程以及@Autowired 执行的时机,有助于彻底明白为什么会出现 Field injection is not recommended 的警告!

JAVA类对象创建的过程

20230215105946.png@Autowired执行时机

@Autowired本质 是通过反射类进行的属性注入,因此,它是在 对象完成初始化后 才会执行

明白如上问题,我们接着看@Autowired警告的问题!

@Autowired警告

如下图,当字段上增加@Autowired注解时,会出现一个波浪线的警告”Field injection is not recommended”,意思就是说不建议直接在字段上进行依赖注入。Spring开发团队建议:在Java Bean中永远使用构造方法进行依赖注入。

20230215103436.png

那么为什么会有如上所示的警告呢?其实从spring4.0 开始,官方就不推荐@Autowire的使用在字段上。想弄清楚这个问题,我们必须知道Spring的3种注入方式

spring注入方式

  1. Constructor-based dependency injection 基于构造器注入

  2. Setter-based dependency injection 基于set方法注入

  3. Field-based dependency injection 基于属性注入

基于属性(filed)注入

这种注入方式就是在 bean 的变量上使用注解进行依赖注入。本质上是通过反射的方式直接注入到 field 。这是我平常开发中看的最多也是最熟悉的一种方式。比如:

@Autowired
private UserService userService;

基于set方法注入

通过对应变量的setXXX()方法以及在方法上面使用注解,来完成依赖注入。比如:

private UserService userService;
@Autowired   //在 Spring 4.5 及更高的版本中,setXXX 上面的 @Autowired 注解是可以不写的。
public void setUserService(UserService userService) {
    this.userService = userService;
}

基于构造器注入

将各个必需的依赖全部放在带有注解构造方法的参数中,并在构造方法中完成对应变量的初始化,这种方式,就是基于构造方法的注入。比如:

private final UserService userService;

@Autowired
public UserController(UserService userService) {
    this.userService = userService;
}

如上所示:我们看到基于属性(filed)注入代码简洁,但实际上也有一些问题。比如:

基于属性(filed)注入案例:

@Autowired
private UserService userService;

private String company;

public UserServiceImpl() {
    this.company = userService.getCompany();
}

以上代码编译不会报错,但当运行时就报:NullPointerException错误

Instantiation of bean failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [...]: Constructor threw exception; nested exception is java.lang.NullPointerException

问题一

Java 在初始化一个类时,是按照静态变量或静态语句块 –> 实例变量或初始化语句块 –> 构造方法 -> @Autowired 的顺序。所以在执行这个类的构造方法时,user对象尚未被注入,它的值还是 null。

问题二

不能有效的指明依赖。相信很多人都遇见过一个 bug,依赖注入的对象为 null,在启动依赖容器时遇到这个问题都是配置的依赖注入少了一个注解什么的。这种方式就过于依赖注入容器了,当没有启动整个依赖容器时,这个类就不能运转,在反射时无法提供这个类需要的依赖。

问题三

依赖注入的核心思想之一就是被容器管理的类不应该依赖被容器管理的依赖,换成白话来说就是如果这个类使用了依赖注入的类,那么这个类摆脱了这几个依赖必须也能正常运行。然而使用变量注入的方式是不能保证这点的。

解决办法

我们一般开发需要注入属性的时候都会使用到@Autowired@Inject@Resource 这三个注解,这三个注解在 Spring 中也是支持使用的,我们先看看他们有什么区别?

20230215112425.png

@Autowired 和 @Inject

Bean的匹配过程

  • 按照type在上下文中查找匹配,查找typexxService的 bean。

  • 如果有多个 bean,则按照name进行匹配

    • 如果有@Qualifier注解,则按照@Qualifier指定的name进行匹配,查找namexxServiceImpl的 bean。

    • 如果没有,则按照变量名进行匹配。查找namexxService的 bean 。

  • 匹配不到,则报错。@Autowired(required=false),如果设置required为 false (默认为 true ),则注入失败时不会抛出异常。

在 Spring 的环境下,@Inject 和 @Autowired 注入方式是相同的,因为它们的依赖注入都是使用AutowiredAnnotationBeanPostProcessor这个后置处理器来处理的。这两个的区别,首先 @Inject 是 Java EE 包里的,在SE环境需要单独引入。另一个区别在于 @Autowired 可以设置 required=false 而 @Inject 并没有这个属性。也有的说 @Autowired是Spring亲生的,@Inject 是 spring 的领养的。

20230215111206.png

@Resource

@Resource 是JSR-250定义的注解。Spring 在 CommonAnnotationBeanPostProcessor 实现了对JSR-250的注解的处理,其中就包括 @Resource

这个@Resource有 2 个属性nametype。在 spring 中name属性定义为 bean 的名字,type这是 bean 的类型。如果属性上加 @Resource 注解那么他的注入流程是:

  1. 如果同时指定了nametype,则从 Spring 上下文中找到唯一匹配的 bean 进行装配,找不到则抛出异常。

  2. 如果指定了name,则从上下文中查找名称匹配的 bean 进行装配,找不到则抛出异常。

  3. 如果指定了type,则从上下文中找到类型匹配的唯一 bean 进行装配,找不到或是找到多个,都会抛出异常。

  4. 如果既没有指定name,又没有指定type,则默认按照byName方式进行装配;如果没有匹配,按照byType进行装配。

所以我们可以使用@Resource替代@Autowired,虽然注解警告不见了,但还是有点取巧的意思。我们推荐使用如下方法注入

使用Lombok注解实现构造器注入

此种方式是lombok包下的注解,如果使用此种方式,需要项目中引入lombok

@RequiredArgsConstructor构造器方式注入,这种形式就是Spring推荐使用的构造器方式注入

如下所示:

@RequiredArgsConstructor
public class UserServiceImpl {
	private final UserService userService;
}

本文链接:https://www.518wz.top/post/26.html 转载需授权!

分享到:

发表评论