使用 JSR 330 标准注释 (Using JSR 330 Standard Annotations) _ Spring Framework 6.1.10 中文文档(官方文档中文翻译) —

Spring 提供了对 JSR-330 标准注解（依赖注入）的支持。那些批注的扫描方式与 Spring 批注的扫描方式相同。要使用它们，您需要在类路径中包含相关的 jar。Spring中文文档

如果使用 Maven，则该工件在标准 Maven 中可用存储库（ https://repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/）. 您可以将以下依赖项添加到文件pom.xml：jakarta.injectSpring中文文档

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

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

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

可以按如下方式使用，而不是：@Autowired@jakarta.inject.InjectSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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(...)
		// ...
	}
}

与一样，您可以在字段级别、方法级别使用和构造函数参数级别。此外，您可以将注入点声明为，允许按需访问范围较短的 Bean 或延迟访问其他 Bean 通过呼叫。以下示例提供了前面的例子：@Autowired@InjectProviderProvider.get()Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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(...)
		// ...
	}
}

如果要对应注入的依赖项使用限定名称，您应该使用注释，如以下示例所示：@NamedSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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@Injectjava.util.Optional@Nullable@Injectrequired@Inject@NullableSpring中文文档

public class SimpleMovieLister {

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

JavaSpring中文文档
KotlinSpring中文文档

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.ManagedBeanSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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@NamedSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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

	// ...
}

当您使用或时，可以在中使用组件扫描与使用 Spring 注解时完全相同，如以下示例所示：@Named@ManagedBeanSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
	// ...
}

@Configuration
@ComponentScan(basePackages = ["org.example"])
class AppConfig  {
	// ...
}

与相反，JSR-330 和 JSR-250 注释是不可组合的。你应该使用 Spring 的构造模型来构建自定义组件注释。@Component@Named@ManagedBean

JSR-330 标准注释的局限性

当您使用标准注释时，您应该知道一些重要的功能不可用，如下表所示：Spring中文文档

表 1.Spring 组件模型元素与 JSR-330 变体
Spring	jakarta.inject.*	jakarta.inject 限制/评论
@AutowiredSpring中文文档	@InjectSpring中文文档	`@Inject`没有“required”属性。可以与 Java 8 一起使用。`Optional`Spring中文文档
@ComponentSpring中文文档	@Named / @ManagedBeanSpring中文文档	JSR-330 不提供可组合模型，仅提供一种识别命名组件的方法。Spring中文文档
@Scope（“单例”）Spring中文文档	@SingletonSpring中文文档	JSR-330 的默认范围类似于 Spring 的 .但是，为了保留它与 Spring 的一般默认值一致，在 Spring 中声明了一个 JSR-330 bean 默认情况下，container 是一个。为了使用除之外的范围你应该使用 Spring 的注解。还提供了一个注释：但是，这个仅供使用用于创建自定义注释。`prototypesingletonsingleton@Scopejakarta.injectjakarta.inject.Scope`Spring中文文档
@QualifierSpring中文文档	@Qualifier / @NamedSpring中文文档	`jakarta.inject.Qualifier`只是用于构建自定义限定符的元注释。可以关联具体的限定符（如具有值的 Spring 限定符）通过。`String@Qualifierjakarta.inject.Named`Spring中文文档
@ValueSpring中文文档	-Spring中文文档	无等价物Spring中文文档
@LazySpring中文文档	-Spring中文文档	无等价物Spring中文文档
对象工厂Spring中文文档	供应商Spring中文文档	`jakarta.inject.Provider`是 Spring 的直接替代品，仅使用较短的方法名称。它也可以与 Spring 或带有非注释的构造函数和 setter 方法。`ObjectFactoryget()@Autowired`Spring中文文档

表 1.Spring 组件模型元素与 JSR-330 变体
Spring	jakarta.inject.*	jakarta.inject 限制/评论
@AutowiredSpring中文文档	@InjectSpring中文文档	`@Inject`没有“required”属性。可以与 Java 8 一起使用。`Optional`Spring中文文档
@ComponentSpring中文文档	@Named / @ManagedBeanSpring中文文档	JSR-330 不提供可组合模型，仅提供一种识别命名组件的方法。Spring中文文档
@Scope（“单例”）Spring中文文档	@SingletonSpring中文文档	JSR-330 的默认范围类似于 Spring 的 .但是，为了保留它与 Spring 的一般默认值一致，在 Spring 中声明了一个 JSR-330 bean 默认情况下，container 是一个。为了使用除之外的范围你应该使用 Spring 的注解。还提供了一个注释：但是，这个仅供使用用于创建自定义注释。`prototypesingletonsingleton@Scopejakarta.injectjakarta.inject.Scope`Spring中文文档
@QualifierSpring中文文档	@Qualifier / @NamedSpring中文文档	`jakarta.inject.Qualifier`只是用于构建自定义限定符的元注释。可以关联具体的限定符（如具有值的 Spring 限定符）通过。`String@Qualifierjakarta.inject.Named`Spring中文文档
@ValueSpring中文文档	-Spring中文文档	无等价物Spring中文文档
@LazySpring中文文档	-Spring中文文档	无等价物Spring中文文档
对象工厂Spring中文文档	供应商Spring中文文档	`jakarta.inject.Provider`是 Spring 的直接替代品，仅使用较短的方法名称。它也可以与 Spring 或带有非注释的构造函数和 setter 方法。`ObjectFactoryget()@Autowired`Spring中文文档

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

@Named和 ： 标注的标准等效物@ManagedBean@Component

JSR-330 标准注释的局限性

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

`@Named`和：标注的标准等效物`@ManagedBean@Component`