https://docs.spring.io/spring-framework/reference/core/beans/standard-annotations.html
Spring支持JSR-330标准注解(依赖注入)。这些注解的扫描方式与Spring注解相同。要使用它们,你需要在类路径中包含相关的jar包。
如果你使用Maven,jakarta.inject
工件在标准的Maven仓库中可用(https://repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/)。你可以将以下依赖项添加到你的pom.xml
文件中:
<dependency>
<groupId>jakarta.inject</groupId>
<artifactId>jakarta.inject-api</artifactId>
<version>2.0.0</version>
</dependency>
使用@Inject和@Named进行依赖注入
你可以使用@jakarta.inject.Inject
来替代@Autowired
,如下所示:
import jakarta.inject.Inject;
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Inject
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
public void listMovies() {
this.movieFinder.findMovies(...);
// ...
}
}
与@Autowired
一样,你可以在字段级别、方法级别和构造函数参数级别使用@Inject
。此外,你可以将你的注入点声明为Provider
,允许按需访问短期作用域的bean或者通过Provider.get()
调用延迟访问其它bean。下面的例子提供了前面例子的一个变体:
import jakarta.inject.Inject;
import jakarta.inject.Provider;
public class SimpleMovieLister {
private Provider<MovieFinder> movieFinder;
@Inject
public void setMovieFinder(Provider<MovieFinder> movieFinder) {
this.movieFinder = movieFinder;
}
public void listMovies() {
this.movieFinder.get().findMovies(...);
// ...
}
}
如果你想要使用一个限定名称来指定应该注入的依赖项,你应该使用@Named
注解,如下例所示:
import jakarta.inject.Inject;
import jakarta.inject.Named;
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Inject
public void setMovieFinder(@Named("main") MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}
与@Autowired
一样,@Inject
也可以与java.util.Optional
或@Nullable
一起使用。这在这里甚至更加适用,因为@Inject
没有required
属性。下面的例子对展示了如何使用@Inject
和@Nullable
:
public class SimpleMovieLister {
@Inject
public void setMovieFinder(Optional<MovieFinder> movieFinder) {
// ...
}
}
public class SimpleMovieLister {
@Inject
public void setMovieFinder(@Nullable MovieFinder movieFinder) {
// ...
}
}
@Named和@ManagedBean:与@Component注解的标准等效项
你可以使用@jakarta.inject.Named
或jakarta.annotation.ManagedBean
来替代@Component
,如下例所示:
import jakarta.inject.Inject;
import jakarta.inject.Named;
@Named("movieListener") // @ManagedBean("movieListener") could be used as well
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Inject
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}
不指定组件名称而使用@Component
是非常常见的。@Named
也可以以类似的方式使用,如下例所示:
import jakarta.inject.Inject;
import jakarta.inject.Named;
@Named
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Inject
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}
当你使用@Named
或@ManagedBean
时,你可以像使用Spring注解一样使用组件扫描,如下例所示:
@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig {
// ...
}
与@Component
相比,JSR-330的@Named
和JSR-250的@ManagedBean
注解不可组合。你应该使用Spring的原型模型来构建自定义组件注解。
JSR-330标准注解的局限性
当你使用标准注解时,你应该知道一些重要功能是不可用的,如下表所示: