使用JSR 330标准注解

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`，如下所示

  • Java

  • Kotlin

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(...);
		// ...
	}
}
import jakarta.inject.Inject

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: MovieFinder


	fun listMovies() {
		movieFinder.findMovies(...)
		// ...
	}
}

与 `@Autowired` 一样，您可以在字段级别、方法级别和构造函数参数级别使用 `@Inject`。此外，您可以将您的注入点声明为 `Provider`，允许按需访问较短范围的 Bean，或通过 `Provider.get()` 调用延迟访问其他 Bean。以下示例提供了前面示例的一个变体

  • Java

  • Kotlin

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(...);
		// ...
	}
}
import jakarta.inject.Inject

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: Provider<MovieFinder>


	fun listMovies() {
		movieFinder.get().findMovies(...)
		// ...
	}
}

如果您想使用应该注入的依赖项的限定名称，则应使用 `@Named` 注解，如下例所示

  • Java

  • Kotlin

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

	// ...
}
import jakarta.inject.Inject
import jakarta.inject.Named

class SimpleMovieLister {

	private lateinit var movieFinder: MovieFinder

	@Inject
	fun 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) {
		// ...
	}
}

  • Java

  • Kotlin

public class SimpleMovieLister {

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

	@Inject
	var movieFinder: MovieFinder? = null
}

@Named 和 @ManagedBean：@Component 注解的标准等效项

您可以使用 `@jakarta.inject.Named` 或 `jakarta.annotation.ManagedBean` 来代替 `@Component`，如下例所示

  • Java

  • Kotlin

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

	// ...
}
import jakarta.inject.Inject
import jakarta.inject.Named

@Named("movieListener")  // @ManagedBean("movieListener") could be used as well
class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: MovieFinder

	// ...
}

通常情况下，使用 `@Component` 而不指定组件名称。`@Named` 可以以类似的方式使用，如下例所示

  • Java

  • Kotlin

import jakarta.inject.Inject;
import jakarta.inject.Named;

@Named
public class SimpleMovieLister {

	private MovieFinder movieFinder;

	@Inject
	public void setMovieFinder(MovieFinder movieFinder) {
		this.movieFinder = movieFinder;
	}

	// ...
}
import jakarta.inject.Inject
import jakarta.inject.Named

@Named
class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: MovieFinder

	// ...
}

当您使用 `@Named` 或 `@ManagedBean` 时，您可以像使用 Spring 注解一样使用组件扫描，如下例所示

  • Java

  • Kotlin

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
	// ...
}
@Configuration
@ComponentScan(basePackages = ["org.example"])
class AppConfig  {
	// ...
}
与 `@Component` 相反，JSR-330 的 `@Named` 和 JSR-250 的 `@ManagedBean` 注解不可组合。您应该使用 Spring 的原型模型来构建自定义组件注解。

JSR-330 标准注解的限制

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

表 1. Spring 组件模型元素与 JSR-330 变体
Spring jakarta.inject.* jakarta.inject 限制/注释

@Autowired

@Inject

@Inject 没有 'required' 属性。可以与 Java 8 的 `Optional` 一起使用。

@Component

@Named / @ManagedBean

JSR-330 没有提供可组合的模型，只是一种标识命名组件的方法。

@Scope("singleton")

@Singleton

JSR-330 的默认范围类似于 Spring 的 `prototype`。但是，为了与 Spring 的通用默认值保持一致，在 Spring 容器中声明的 JSR-330 Bean 默认情况下是 `singleton`。为了使用除 `singleton` 之外的范围，您应该使用 Spring 的 `@Scope` 注解。`jakarta.inject` 也提供了一个 `jakarta.inject.Scope` 注解：但是，这个注解仅用于创建自定义注解。

@Qualifier

@Qualifier / @Named

jakarta.inject.Qualifier 只是一个用于构建自定义限定符的元注解。具体的 `String` 限定符（如带有值的 Spring 的 `@Qualifier`）可以通过 `jakarta.inject.Named` 关联。

@Value

-

无等效项

@Lazy

-

无等效项

ObjectFactory

Provider

jakarta.inject.Provider 是 Spring 的 `ObjectFactory` 的直接替代方案，只是方法名更短，为 `get()`。它也可以与 Spring 的 `@Autowired` 或非注解的构造函数和 setter 方法结合使用。