从零开始 Spring Boot 43：DI 注解

spring boot

图源：简书 (jianshu.com)

Spring 通过注解实现 DI（依赖注入），本文详细讨论这些注解。

@Autowired

@Autowired是 Spring 定义的注解，属于包org.springframework.beans.factory.annotation。

@Autowired匹配 bean 的顺序是：

按类型（type）匹配
按限定符（qualifier）匹配
按名称（name）匹配

@Autowired是最常用的注解，用它可以通过属性注入、Setter注入、构造器注入来实现DI。在前文中讨论过这些内容，这里不再重复。

筛选备选项

一般来说，用@Autowired注入时必须存在类型匹配的唯一的 bean，没有匹配到和匹配到一个以上的 bean 都会报错：

@ToString
@EqualsAndHashCode
public abstract class Carrier {protected final String maker;protected final String model;protected Carrier(String maker, String model) {this.maker = maker;this.model = model;}
}@ToString(callSuper = true)
@EqualsAndHashCode(callSuper = true)
public class Car extends Carrier {public Car(final String maker, final String model) {super(maker, model);}
}@ToString(callSuper = true)
@EqualsAndHashCode(callSuper = true)
public class Motorcycle extends Carrier {public Motorcycle(final String maker, final String model) {super(maker, model);}
}@Service
public class CarrierService {@Autowiredprivate Carrier defaultCarrier;public Carrier getDefaultCarrier() {return defaultCarrier;}
}@Configuration
public class WebConfig {@Lazy@Autowiredprivate CarrierService carrierService;@BeanCar defaultCar(){return new Car("长安汽车","X5");}@BeanMotorcycle defaultMotorcycle(){return new Motorcycle("哈雷","A7");}@BeanApplicationRunner applicationRunner(){return args -> {Carrier defaultCarrier = carrierService.getDefaultCarrier();System.out.println(defaultCarrier);};}
}

这里定义的两个 bean 都具备Carrier类型，因此用@Autowired注入Carrier defaultCarrier属性时会报错，Spring 不知道要注入的是哪一个。

可以通过@Qualifier缩小筛选范围：

@Service
public class CarrierService {@Autowired@Qualifier("defaultCar")private Carrier defaultCarrier;// ...
}

示例中使用@Qualifier("defaultCar")将注入限定为名称为defaultCar的 bean，因此可以正常注入。

除了使用限定符，还可以使用名称进行筛选，@Autowired使用属性名作为 bean 名称进行匹配：

@Service
public class CarrierService {@Autowiredprivate Carrier defaultCar;// ...
}

在用于名称匹配时，@Autowired并不好用，因为它只能用属性名作为 bean 名称匹配，@Resource则可以用name属性指定 bean 名称，而@inject可以使用@Named注解指定 bean 名称。

@Qualifier还可以更灵活地对 bean 进行筛选，详细内容可以阅读我的另一篇文章。

除了@Qualifier，还可以使用@Primary指定一个主要的 bean 作为有多个备选项时的首选注入，详细情况可以参考我的同一篇文章。

@Resource

@Resource是 Java 扩展包的注解，属于包javax.annotation.Resource。

@Autowired按照类型优先进行匹配，@Resource按照名称优先进行匹配，其匹配顺序是：

按名称（name）匹配
按类型（type）匹配
按限定符（qualifier）匹配

修改之前的示例，使用@Resource进行依赖注入：

@Service
public class CarrierService {@Resourceprivate Carrier defaultCarrier;// ...
}

会报错，因为不能按照defaultCarrier找到 bean，如果按照类型Carrier匹配，能匹配到2个。

可以通过@Resource的name属性指定要匹配的 bean 名称：

@Service
public class CarrierService {@Resource(name = "defaultCar")private Carrier defaultCarrier;// ...
}

或者也可以修改属性名称：

@Service
public class CarrierService {@Resourceprivate Carrier defaultCar;public Carrier getDefaultCarrier() {return defaultCar;}
}

或者按照类型匹配，提供一个唯一 bean 对应的类型：

@Service
public class CarrierService {@Resourceprivate Car defaultCarrier;// ...
}

最后，同样可以使用@Qualifier：

@Service
public class CarrierService {@Resource@Qualifier("defaultCar")private Carrier defaultCarrier;// ...
}

@Resource还可以通过 Setter 注入，用法与属性注入一致，这里不再说明。

@Inject

@Inject同样属于 Java 扩展包，属于包javax.inject.Inject。

@Inject的匹配顺序是：

按类型匹配
按限定符匹配
按名称匹配

要使用@Inject注解要先添加依赖：

<dependency><groupId>jakarta.inject</groupId><artifactId>jakarta.inject-api</artifactId><version>2.0.1</version>
</dependency>

先看按类型匹配的示例：

@Service
public class CarrierService {@Injectprivate Car defaultCarrier;// ...
}

如果按类型匹配出多个候选项，可以通过限定符进一步匹配：

@Service
public class CarrierService {@Inject@Qualifier("defaultCar")private Carrier defaultCarrier;// ...
}

也可以通过名称进一步匹配：

@Service
public class CarrierService {@Inject@Named("defaultMotorcycle")private Carrier defaultCarrier;// ...
}

@Named同样属于 Java 扩展包，属于包jakarta.inject.Named。

如果@Named注解没有起作用，可以检查一下 maven 依赖中的jakarta.inject模块的版本是否正确。

@Inject用于 Setter 注入的方式与属性注入类似，这里不再赘述。

@Inject也可以用于构造器注入：

@Service
public class CarrierService {private Carrier defaultCarrier;@Injectpublic CarrierService(@Named("defaultCar") Carrier defaultCarrier) {this.defaultCarrier = defaultCarrier;}// ...
}