使用 JSR 330 標準註解

Spring 提供對 JSR-330 標準註解（依賴注入）的支援。這些註解的掃描方式與 Spring 註解相同。若要使用它們，您需要在類別路徑中包含相關的 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，允許隨需存取範圍較短的 beans，或透過 Provider.get() 呼叫延遲存取其他 beans。以下範例提供先前範例的變體

  • 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 只是用於建構自訂限定詞的 meta-annotation。具體的 String 限定詞（例如 Spring 的具有值的 @Qualifier）可以透過 jakarta.inject.Named 關聯。

@Value

-

沒有等效項

@Lazy

-

沒有等效項

ObjectFactory

Provider

jakarta.inject.Provider 是 Spring ObjectFactory 的直接替代方案，只是 get() 方法名稱較短。它也可以與 Spring 的 @Autowired 或非註解建構子和 setter 方法結合使用。