跳到主要内容

使用 JSR 330 标准注解

ChatGPT-4o-mini 中英对照 Using JSR 330 Standard Annotations

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>
xml

使用 @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(...);
        // ...
    }
}
java

与 @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(...);
        // ...
    }
}
java

如果您想为应该被注入的依赖项使用合格名称，您应该使用 @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;
    }

    // ...
}
java

与 @Autowired 一样，@Inject 也可以与 java.util.Optional 或 @Nullable 一起使用。在这里，这种用法更为适用，因为 @Inject 没有 required 属性。以下一对示例展示了如何使用 @Inject 和 @Nullable：

public class SimpleMovieLister {

    @Inject
    public void setMovieFinder(Optional<MovieFinder> movieFinder) {
        // ...
    }
}
java
public class SimpleMovieLister {

    @Inject
    public void setMovieFinder(@Nullable MovieFinder movieFinder) {
        // ...
    }
}
java

@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;
    }

    // ...
}
java

在不指定组件名称的情况下使用 @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;
    }

    // ...
}
java

当你使用 @Named 或 @ManagedBean 时，你可以像使用 Spring 注解一样使用组件扫描，以下示例展示了这一点：

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
    // ...
}
java
备注

与 @Component 相比，JSR-330 的 @Named 和 JSR-250 的 @ManagedBean 注解是不可组合的。您应该使用 Spring 的刻板模型来构建自定义组件注解。

JSR-330 标准注解的局限性​

当您使用标准注释时，您应该知道一些重要功能不可用，如下表所示：

表 1. Spring 组件模型元素与 JSR-330 变体

Springjakarta.inject.*jakarta.inject 限制 / 注释
@Autowired@Inject@Inject 没有 'required' 属性。可以与 Java 8 的 Optional 一起使用。
@Component@Named / @ManagedBeanJSR-330 不提供可组合模型，仅提供识别命名组件的方式。
@Scope("singleton")@SingletonJSR-330 的默认作用域类似于 Spring 的 prototype。然而，为了与 Spring 的一般默认值保持一致，在 Spring 容器中声明的 JSR-330 bean 默认是 singleton。为了使用其他作用域，您应该使用 Spring 的 @Scope 注解。jakarta.inject 还提供了一个 jakarta.inject.Scope 注解：然而，这个注解仅用于创建自定义注解。
@Qualifier@Qualifier / @Namedjakarta.inject.Qualifier 只是一个用于构建自定义限定符的元注解。具体的 String 限定符（如 Spring 的 @Qualifier 带有值）可以通过 jakarta.inject.Named 关联。
@Value-没有等效项
@Lazy-没有等效项
ObjectFactoryProviderjakarta.inject.Provider 是 Spring 的 ObjectFactory 的直接替代，仅具有更短的 get() 方法名称。它也可以与 Spring 的 @Autowired 或未注解的构造函数和 setter 方法结合使用。