对于最新稳定版本,请使用Spring Framework 7.0.1spring-doc.cadn.net.cn

使用 JSR 330 标准注释

Spring 支持 JSR-330 标准注释(依赖注入)。那些 注释的扫描方式与春季注释相同。要使用它们,你需要 在你的职业路径中拥有相关的罐子。spring-doc.cadn.net.cn

如果你用Maven,那雅加达.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.注入。注入如下: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.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(...)
		// ...
	}
}

如果你想用一个限定名称来表示应注入的依赖, 你应该使用@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不具备 一个必填属性。以下两组示例展示了如何使用@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.namedjakarta.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  {
	// ...
}
@ComponentJSR-330@Named以及JSR-250@ManagedBean注释不可组合。你应该用Spring的刻板印象模型来建造 自定义组件注释。

JSR-330标准注释的局限性

当你使用标准注释时,你应该知道有些重要内容 功能不可用,如下表所示:spring-doc.cadn.net.cn

表1。Spring组件模型元件与JSR-330变体的比较
Spring 雅加达.inject.* Jakarta.inject 限制 / 评论

@Autowiredspring-doc.cadn.net.cn

@Injectspring-doc.cadn.net.cn

@Inject没有“必需”属性。可以与 Java 8 一起使用自选相反。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的类似原型.然而,为了保持它 与春季普遍违约情况一致,春季宣布了一颗JSR-330豆 容器是单身 人士默认。为了使用除单身 人士, 你应该用Spring的@Scope注解。雅加达.inject还提供雅加达.inject.scope。注释:不过,这个只打算用来 用于创建自定义注释。spring-doc.cadn.net.cn

@Qualifierspring-doc.cadn.net.cn

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

雅加达。注入。预选赛只是构建自定义限定符的元注释。 混凝土字符串资格赛(如斯普林的@Qualifier与一个值)可以关联 通过雅加达。注射。命名.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

雅加达。注射。提供者是Spring的直接替代ObjectFactory, 只是用更短的get()方法名称。它也可以与 斯普林斯@Autowired或者使用非注释构造器和设定器方法。spring-doc.cadn.net.cn