使用 JSR 330 標準註解

Spring 支援 JSR-330 標準註解（依賴注入）。這些註解的掃描方式與 Spring 註解相同。要使用它們，您需要在 classpath 中包含相關的 jar 包。

如果您使用 Maven，jakarta.inject 工件在標準 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") 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 也可以類似地使用，如下例所示：

  • 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 方法結合使用。
© . This site is unofficial and not affiliated with VMware.