使用JSR 330标准注解

Spring支持JSR-330标准注解（依赖注入）。这些注解与Spring注解一样被扫描。要使用它们，您需要在类路径中拥有相关的jar包。

如果您使用Maven，jakarta.inject artifact可以在标准Maven仓库中找到（https://repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/）。您可以将以下依赖项添加到您的pom.xml文件中：

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

使用@Inject和@Named进行依赖注入

您可以像下面这样使用@jakarta.inject.Inject来代替@Autowired：

  • Java

  • Kotlin

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。以下示例提供了前面示例的变体：

  • Java

  • Kotlin

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注解，如下例所示：

  • Java

  • Kotlin

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：

public class SimpleMovieLister {

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

  • Java

  • Kotlin

public class SimpleMovieLister {

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

	@Inject
	var movieFinder: MovieFinder? = null
}

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

您可以使用@jakarta.inject.Named或jakarta.annotation.ManagedBean来替代@Component，如下例所示：

  • Java

  • Kotlin

import jakarta.inject.Inject;
import jakarta.inject.Named;

@Named("movieListener")  // 也可以使用@ManagedBean("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")  // 也可以使用@ManagedBean("movieListener")
class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: MovieFinder

	// ...
}

通常情况下，使用@Component时不会为组件指定名称。@Named可以以类似的方式使用，如下例所示：

  • Java

  • Kotlin

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注解一样使用组件扫描，如下例所示：

  • Java

  • Kotlin

@Configuration
@ComponentScan(basePackages = "org.example")
public class AppConfig  {
	// ...
}
@Configuration
@ComponentScan(basePackages = ["org.example"])
class AppConfig  {
	// ...
}
与@Component不同，JSR-330的@Named和JSR-250的@ManagedBean注解不可组合。您应该使用Spring的构建自定义组件注解的原型模型。

JSR-330标准注解的限制

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

表1. Spring组件模型元素与JSR-330变体的比较
Spring jakarta.inject.* jakarta.inject限制/注释

@Autowired

@Inject

@Inject没有'required'属性。可以与Java 8的Optional一起使用。

@Component

@Named / @ManagedBean

JSR-330不提供可组合的模型，只提供一种识别命名组件的方式。

@Scope("singleton")

@Singleton

JSR-330的默认范围类似于Spring的prototype。但是，为了与Spring的一般默认值保持一致，Spring容器中声明的JSR-330 bean默认为singleton。如果要使用除singleton之外的范围，应该使用Spring的@Scope注解。jakarta.inject还提供了一个jakarta.inject.Scope注解：但是，这个注解只用于创建自定义注解。

@Qualifier

@Qualifier / @Named

jakarta.inject.Qualifier只是用于构建自定义限定符的元注解。具体的String限定符（类似于Spring的带有值的@Qualifier）可以通过jakarta.inject.Named关联。

@Value

-

无等效项

@Lazy

-

无等效项

ObjectFactory

Provider

jakarta.inject.Provider是Spring的ObjectFactory的直接替代品，只是方法名更短为get()。它也可以与Spring的@Autowired或未注释的构造函数和setter方法结合使用。