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>

Dependency Injection with `@Inject` and `@Named`

代替 @Autowired，你可以使用 @jakarta.inject.Inject，如下所示：

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` and `@ManagedBean`: Standard Equivalents to the `@Component` Annotation

可以使用 @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 的模式模型来构建自定义组件注解。

Limitations of JSR-330 Standard Annotations

使用标准注解时，应知道一些重要特性不可用，如下表所示：

Table 1. Spring component model elements versus JSR-330 variants
Spring	jakarta.inject.*	jakarta.inject restrictions / comments
@Autowired	@Inject	`@Inject`没有“所需”属性。能够与 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	-	no equivalent
@Lazy	-	no equivalent
ObjectFactory	Provider	`jakarta.inject.Provider` 是 Spring 的 `ObjectFactory` 的一个直接替代方法，但只是方法名称 `get()` 较短。它还可以与 Spring 的 `@Autowired` 结合使用，或与非注解构造函数和设置器方法结合使用。

Using JSR 330 Standard Annotations

Dependency Injection with @Inject and @Named

@Named and @ManagedBean: Standard Equivalents to the @Component Annotation

Limitations of JSR-330 Standard Annotations

Dependency Injection with `@Inject` and `@Named`

`@Named` and `@ManagedBean`: Standard Equivalents to the `@Component` Annotation