使用JSR-330标准注解

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

要使用它们，您需要在类路径中拥有相关的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，以便按需访问短作用域的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
import jakarta.inject.Provider

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: Provider<MovieFinder>


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

如果您希望为应注入的依赖项使用限定名称，您可以选择使用@Qualifier注解作为Spring的@Autowired支持的替代方案，如下例所示。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 注解

可以选择性地使用@jakarta.inject.Named，而不是@Component或其他Spring标记注解，如下例所示。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 stereotype注解时，不指定组件的明确名称是非常常见的做法，而@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的原型模型来构建自定义组件注解。

如果您正在维护仍使用@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  {
	// ...
}

此外，如果您希望在@javax.inject.Named和@javax.annotation.ManagedBean中的value属性用作组件名称，您需要在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的单例。但是，为了与Spring的一般默认设置保持一致，在Spring容器中声明的JSR-330 Bean默认为原型。若要使用非单例的作用域，您应该使用Spring的作用域注解。Spring还提供了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