此版本仍在开发中，尚未被视为稳定版。如需最新稳定版本，请使用 Spring Framework 7.0.6！spring-doc.cadn.net.cn

使用 JSR-330 标准注解

Spring 提供对 JSR-330 标准依赖注入注解的支持，这些注解位于 jakarta.inject 包中。这些注解可选地用作 Spring 注解的替代方案。spring-doc.cadn.net.cn

要使用它们，您需要在类路径（classpath）中包含相关的 JAR 文件。例如，jakarta.inject 工件可在标准的 Maven 仓库中获取 （repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/），spring-doc.cadn.net.cn

如果你使用 Maven，可以将以下依赖项添加到你的 pom.xml 文件中。spring-doc.cadn.net.cn

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

使用依赖注入的@Inject和@Named

您可以选择不使用 @Autowired 进行依赖注入，而是改用 @jakarta.inject.Inject，如下所示。spring-doc.cadn.net.cn

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。spring-doc.cadn.net.cn

此外，作为 Spring 的 ObjectProvider 机制的替代方案，您可以选择将注入点声明为 jakarta.inject.Provider，从而通过 Provider.get() 调用按需访问作用域较短的 Bean，或延迟访问其他 Bean。以下示例提供了前述示例的一个变体。spring-doc.cadn.net.cn

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
import jakarta.inject.Provider

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: Provider<MovieFinder>


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

如果你想为应被注入的依赖项使用一个限定名称，可以选择使用 @Named 注解作为 Spring 的 @Qualifier 功能的替代方案，如下例所示。spring-doc.cadn.net.cn

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 与 Optional、@Nullable 以及 Kotlin 对可空类型的内置支持结合使用。spring-doc.cadn.net.cn

import jakarta.inject.Inject;
import java.util.Optional;

public class SimpleMovieLister {

	@Inject
	public void setMovieFinder(Optional<MovieFinder> movieFinder) {
		// ...
	}
}
import jakarta.inject.Inject;
import org.jspecify.annotations.Nullable;

public class SimpleMovieLister {

	@Inject
	public void setMovieFinder(@Nullable MovieFinder movieFinder) {
		// ...
	}
}
import jakarta.inject.Inject

class SimpleMovieLister {

	@Inject
	var movieFinder: MovieFinder? = null
}

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

你可以选择使用 @Component，而不是 @jakarta.inject.Named 或其他 Spring 刻板注解（stereotype annotations），如下例所示。spring-doc.cadn.net.cn

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

@Named("movieListener")
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")
class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: MovieFinder

	// ...
}

通常情况下，使用 @Component 或其他 Spring 刻板注解时不会显式指定组件的名称，@Named 也可以以类似的方式使用，如下例所示。spring-doc.cadn.net.cn

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 时，可以像使用 Spring 注解一样以完全相同的方式进行组件扫描，如下例所示。spring-doc.cadn.net.cn

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
	// ...
}
@Configuration
@ComponentScan(basePackages = ["org.example"])
class AppConfig  {
	// ...
}
与 @Component 不同，JSR-330 的 @Named 注解不可组合。您应使用 Spring 的构造型（stereotype）模型来构建自定义的组件注解。

如果你使用的遗留系统仍然使用 @javax.inject.Named 或 @javax.annotation.ManagedBean 来标注组件（注意 javax 包命名空间）， 你可以显式配置组件扫描以包含这些注解类型，如下例所示。spring-doc.cadn.net.cn

@Configuration
@ComponentScan(
	basePackages = "org.example",
	includeFilters = @Filter({
		javax.inject.Named.class,
		javax.annotation.ManagedBean.class
	})
)
public class AppConfig  {
	// ...
}
@Configuration
@ComponentScan(
	basePackages = ["org.example"],
	includeFilters = [Filter([
		javax.inject.Named::class,
		javax.annotation.ManagedBean::class
	])]
)
class AppConfig  {
	// ...
}

此外，如果您希望将 value 属性在 @javax.inject.Named 和 @javax.annotation.ManagedBean 中用作组件名称，则需要重写 AnnotationBeanNameGenerator 中的 isStereotypeWithNameValue(…​) 方法，以显式支持 javax.annotation.ManagedBean 和 javax.inject.Named，并通过 @ComponentScan 中的 nameGenerator 属性注册您的自定义 AnnotationBeanNameGenerator。spring-doc.cadn.net.cn

JSR-330 标准注解的局限性

使用 JSR-330 标准注解时，您应当了解某些重要功能不可用，如下表所示。spring-doc.cadn.net.cn

表1. Spring组件模型与JSR-330变体的对比
Spring JSR-330 JSR-330 限制／注解

@Autowiredspring-doc.cadn.net.cn

@Injectspring-doc.cadn.net.cn

@Inject 没有 required 属性。可以改用 Java 的 Optional。spring-doc.cadn.net.cn

@Componentspring-doc.cadn.net.cn

@Namedspring-doc.cadn.net.cn

JSR-330 并未提供一种可组合的模型，仅提供了一种标识命名组件的方式。spring-doc.cadn.net.cn

@Scope("singleton")spring-doc.cadn.net.cn

@Singletonspring-doc.cadn.net.cn

JSR-330 的默认作用域类似于 Spring 的 prototype。然而，为了与 Spring 的通用默认行为保持一致，在 Spring 容器中声明的 JSR-330 Bean 默认是 singleton。若要使用除 singleton 之外的其他作用域，应使用 Spring 的 @Scope 注解。jakarta.inject 也提供了一个 jakarta.inject.Scope 注解；但该注解仅用于创建自定义注解。spring-doc.cadn.net.cn

@Qualifierspring-doc.cadn.net.cn

@Qualifier / @Namedspring-doc.cadn.net.cn

jakarta.inject.Qualifier 仅是一个用于构建自定义限定符的元注解。 具体的 String 限定符（例如 Spring 带有值的 @Qualifier）可以通过 jakarta.inject.Named 进行关联。spring-doc.cadn.net.cn

@Valuespring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

无等效项spring-doc.cadn.net.cn

@Lazyspring-doc.cadn.net.cn

-spring-doc.cadn.net.cn

无等效项spring-doc.cadn.net.cn

ObjectFactoryspring-doc.cadn.net.cn

Providerspring-doc.cadn.net.cn

jakarta.inject.Provider 是 Spring 的 ObjectFactory 的直接替代方案， 只是其 get() 方法名更短。它也可以与 Spring 的 @Autowired 注解结合使用， 或用于未加注解的构造函数和 setter 方法中。spring-doc.cadn.net.cn