对于最新的稳定版本，请使用 Spring Framework 7.0.6!spring-doc.cadn.net.cn

使用 JSR 330 标准注解

Spring 为 JSR-330 标准注解（依赖注入）提供了支持。这些注解的扫描方式与 Spring 注解相同。要使用它们，你需要在类路径中包含相关的 jar 包。spring-doc.cadn.net.cn

如果您使用 Maven，jakarta.inject工件在标准 Maven 仓库中可用 ( https://repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/)。 您可以在您的 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。此外，您可以将注入点声明为 Provider，从而按需访问作用域较短的 bean 或通过 Provider.get() 调用延迟访问其他 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

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: Provider<MovieFinder>


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

如果您希望为应注入的依赖项使用限定名称， 应使用 @Named 注解，如下例所示：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和 @Nullable：spring-doc.cadn.net.cn

public class SimpleMovieLister {

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

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

	@Inject
	var movieFinder: MovieFinder? = null
}

@Named 和 @ManagedBean：等同于 @Component 注解的标准等效方案

而不是 @Component，你可以使用 @jakarta.inject.Named 或 jakarta.annotation.ManagedBean， 如下面的示例所示：spring-doc.cadn.net.cn

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 可以以类似的方式使用，如下例所示：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 或 @ManagedBean 时，可以以与使用 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 和 JSR-250 @ManagedBean 注解是不可组合的。你应该使用 Spring 的 stereotype 模型来构建自定义组件注解。

JSR-330标准注解的限制

当你使用标准注解时，你应该知道一些重要的功能是不可用的，如下表所示：spring-doc.cadn.net.cn

表 1. Spring 组件模型元素与 JSR-330 变体对比
Spring jakarta.inject.* jakarta.inject 限制/说明

@Autowiredspring-doc.cadn.net.cn

@Injectspring-doc.cadn.net.cn

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

@Componentspring-doc.cadn.net.cn

@Named / @ManagedBeanspring-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

提供者spring-doc.cadn.net.cn

jakarta.inject.Provider 是 Spring 的 ObjectFactory 的直接替代方案， 仅具有更短的 get() 方法名称。它也可以与 Spring 的 @Autowired 一起使用，或者与未注解的构造函数和 setter 方法一起使用。spring-doc.cadn.net.cn