@AutoWired和 @Resource原理分析！

发表于 更新于 分类于 阅读次数： 本文字数： 3.7k 阅读时长 ≈ 3 分钟

嗨，你好呀，我是猿java

@Autowired和@Resource是 Java程序员经常用来实现依赖注入的两个注解，这篇文章，我们将详细分析这两个注解的工作原理、使用示例和它们之间的对比。

依赖注入概述

依赖注入是一种常见的设计模式，用于实现控制反转（Inversion of Control, IoC）。在传统的编程中，类通常负责管理自己的依赖，而在 DI中，这种责任被转移到了外部容器（如 Spring容器）上，通过 DI，可以提高代码的可测试性和可维护性，因为依赖关系是通过配置而不是硬编码的。

@Autowired

@Autowired是 Spring框架提供的注解，用于自动装配 bean。它可以用在构造器、方法、字段或参数上，Spring容器会通过类型匹配（byType）来注入依赖。

@Autowired的工作原理

  • 类型匹配：Spring首先通过类型匹配来查找合适的bean。如果找到一个唯一的bean，则注入该bean。
  • 候选Bean的歧义：如果有多个同类型的bean，Spring会通过字段名或参数名来进一步匹配。
  • @Primary注解：可以使用@Primary注解来标记一个bean为主要候选者。
  • @Qualifier注解：在多个候选bean的情况下，可以使用@Qualifier注解来指定注入的bean。

作用范围

@Autowired的作用范围包括三种：

  • 字段注入：最简单的方式，但不利于单元测试，因为依赖是通过反射注入的。
  • 构造器注入：推荐的方式，因为它可以确保依赖在对象创建时就被注入。
  • 方法注入：通过一个setter方法注入依赖。

在Spring框架中，依赖注入可以通过多种方式来实现，主要包括构造器注入、字段注入和方法注入。每种方式都有其特定的使用场景和优缺点。下面我将为每种注入方式提供示例代码，以帮助理解其实现和适用场景。

字段注入

字段注入是通过直接在类的字段上使用注解来实现的，这种方式最为简单，但也有一些缺点，特别是在单元测试中，因为它依赖于反射来设置字段的值。Spring官方已经不建议这种使用方式。

如下示例展示了字段注入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class CarService {

    @Autowired
    private Engine engine;

    public void start() {
        engine.run();
    }
}

@Component
public class Engine {

    public void run() {
        System.out.println("Engine is running");
    }
}

适用场景

  • 快速原型：在快速开发或原型阶段，字段注入可以减少样板代码。
  • 简单的依赖关系：如果类的依赖关系简单且不需要复杂的初始化逻辑，字段注入可以提供一种直接的方式。

缺点

  • 测试困难：由于字段是私有的，单元测试时需要使用反射来设置字段的值，这增加了复杂性。
  • 不支持final字段：因为字段注入发生在对象实例化之后，无法用于final字段。

构造器注入

构造器注入是通过类的构造函数来实现依赖注入的，这种方式被广泛推荐，因为它可以在对象创建时确保所有依赖都被正确注入，从而避免未初始化的依赖。

如下示例展示了构造器注入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class CarService {

    private final Engine engine;

    @Autowired  // 可以省略，因为只有一个构造函数时，Spring会自动注入
    public CarService(Engine engine) {
        this.engine = engine;
    }

    public void start() {
        engine.run();
    }
}

@Component
public class Engine {

    public void run() {
        System.out.println("Engine is running");
    }
}

适用场景

  • 不可变性：如果你希望你的类是不可变的，构造器注入是最佳选择，因为它可以确保所有依赖在对象创建时都被注入。
  • 必需依赖：如果某个依赖是必需的，构造器注入可以确保在对象创建时注入该依赖。

方法注入

方法注入（通常是 setter方法注入）是通过提供一个公共的 setter方法来实现的。这种方式提供了一种在对象实例化后设置依赖的灵活性。

如下示例展示了方法注入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class CarService {

    private Engine engine;

    @Autowired
    public void setEngine(Engine engine) {
        this.engine = engine;
    }

    public void start() {
        engine.run();
    }
}

@Component
public class Engine {

    public void run() {
        System.out.println("Engine is running");
    }
}

适用场景

  • 可选依赖：如果某个依赖是可选的，方法注入可以让你在必要时设置该依赖。
  • 需要后期配置：如果需要在对象实例化后进行额外的配置或初始化，方法注入提供了一种灵活的方式。

@Resource

@Resource是Java EE（Jakarta EE）提供的注解，用于注入依赖，它可以用在字段或setter方法上，主要通过名称匹配来注入依赖。

@Resource的工作原理

  • 名称匹配：@Resource首先通过名称匹配来查找bean。如果名称匹配失败，则通过类型匹配。
  • 简单配置：@Resource不支持复杂的注入配置，如@Qualifier。

@Resource使用示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import javax.annotation.Resource;
import javax.ejb.Stateless;

@Stateless
public class CarService {

    @Resource
    private Engine engine;

    // 其他方法
}

public class Engine {
    // Engine的实现
}

在这个示例中，CarService使用@Resource注解来注入Engine对象。

@Autowired和@Resource的对比

提供者

  • @Resource是Java EE规范的一部分，适用于任何兼容的Java EE容器。
    • @Autowired是Spring框架提供的注解，需要依赖 Spring框架，同时也支持@Resource。

匹配策略

  • @Autowired主要通过类型匹配，必要时通过@Qualifier进一步指定。
  • @Resource主要通过名称匹配，然后才是类型匹配。

配置复杂度

  • @Autowired支持更多的配置选项，如@Primary和@Qualifier。
  • @Resource配置相对简单，不支持复杂配置。

框架依赖

  • @Autowired是Spring特有的注解，需要依赖Spring框架。
  • @Resource是Java EE规范的一部分，适用于任何兼容的Java EE容器。

使用场景

  • 如果使用 Spring框架，@Autowired是更常用的选择，因为它提供了更多功能。
  • 在Java EE环境中，@Resource是标准的选择。

总结

@Autowired和@Resource是 Java开发中实现依赖注入的两种常用方式。虽然它们都可以用于自动装配 bean，但在匹配策略、配置复杂度和框架依赖上存在显著差异。因此，理解两者的原理和差异，可以帮助我们更好地理解 Java依赖注入的机制，更好的应用这两个注解。

交流学习

最后，把猿哥的座右铭送给你：投资自己才是最大的财富。 如果你觉得文章有帮助，请帮忙转发给更多的好友，或关注公众号：猿java，持续输出硬核文章。

drawing