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

使用 JSR 330 标准注释

Spring 提供对 JSR-330 标准注释（依赖注入）的支持。那些 Comments 的扫描方式与 Spring Comments 相同。要使用它们，您需要 以将相关的 jar 放在 Classpath 中。spring-doc.cadn.net.cn

如果您使用 Maven，则jakarta.injectartifact 在标准 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在字段级别、方法级别 和 constructor-argument 级别。此外，您可以将注入点声明为Provider，允许按需访问范围较短的 bean 或延迟访问 其他 bean 通过Provider.get()叫。以下示例提供了 前面的示例：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(...)
		// ...
	}
}

如果您想为应该注入的依赖项使用限定名称， 您应该使用@Namedannotation 中，如下例所示：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（“单例”）spring-doc.cadn.net.cn

@Singletonspring-doc.cadn.net.cn

JSR-330 的默认范围类似于 Spring 的prototype.但是，为了保持它 与 Spring 的一般默认值一致，在 Spring 中声明的 JSR-330 bean container 是一个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

对象工厂spring-doc.cadn.net.cn

供应商spring-doc.cadn.net.cn

jakarta.inject.Provider是 Spring 的ObjectFactory, 只有较短的get()method name 的它也可以与 Spring的@Autowired或者使用未注释的构造函数和 setter 方法。spring-doc.cadn.net.cn