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 による依存性注入

@Autowired の代わりに、次のように @jakarta.inject.Inject を使用できます。

  • 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 として宣言して、Provider.get() 呼び出しを介して、より短いスコープの Bean へのオンデマンドアクセスまたは他の 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 アノテーションの標準的な同等物

@Component の代わりに、次の例に示すように、@jakarta.inject.Named または jakarta.annotation.ManagedBean を使用できます。

  • 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 バリアント
Springjakarta.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-330Bean はデフォルトで singleton です。singleton 以外のスコープを使用するには、Spring の @Scope アノテーションを使用する必要があります。jakarta.inject は jakarta.inject.Scope アノテーションも提供しますが、これはカスタムアノテーションの作成にのみ使用することを目的としています。

@Qualifier

@Qualifier/@Named

jakarta.inject.Qualifier は、カスタム修飾子を作成するためのメタアノテーションです。具体的な String 修飾子（値を持つ Spring の @Qualifier など）は、jakarta.inject.Named を介して関連付けることができます。

@Value

-

同等のものはありません

@Lazy

-

同等のものはありません

ObjectFactory

プロバイダー

jakarta.inject.Provider は、Spring の ObjectFactory の直接の代替手段ですが、get() メソッド名が短くなっています。また、Spring の @Autowired と組み合わせて使用することも、アノテーションのないコンストラクターおよび setter メソッドと組み合わせて使用することもできます。