JSR-330 標準アノテーションの使用

Spring は、jakarta.inject パッケージで利用可能な JSR-330 標準の依存性注入アノテーションをサポートしています。これらのアノテーションは、オプションで Spring アノテーションの代替として使用できます。

これらを使用するには、クラスパスに関連する jar が必要です。例: jakarta.inject アーティファクトは標準の Maven リポジトリ（repo.maven.apache.org/maven2/jakarta/inject/jakarta.inject-api/2.0.0/ (英語) ）で利用可能です。

Maven を使用する場合は、次の依存関係を 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 はフィールドレベル、メソッドレベル、コンストラクター引数レベルで使用できます。

さらに、Spring の ObjectProvider メカニズムの代わりに、インジェクションポイントを jakarta.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
import jakarta.inject.Provider

class SimpleMovieLister {

	@Inject
	lateinit var movieFinder: Provider<MovieFinder>


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

注入する依存関係に修飾名を使用する場合は、次の例に示すように、Spring の @Qualifier サポートの代わりに @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 を Optional、@Nullable、Kotlin の組み込みの null 許容型サポートと組み合わせて使用する方法を示しています。

import jakarta.inject.Inject;
import java.util.Optional;

public class SimpleMovieLister {

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

  • Java

  • Kotlin

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 アノテーションに相当する標準

次の例に示すように、@Component またはその他の Spring ステレオタイプアノテーションの代わりに、オプションで @jakarta.inject.Named を使用することもできます。

  • Java

  • Kotlin

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 ステレオタイプアノテーションを使用することは非常に一般的であり、次の例に示すように、@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 を使用する場合、次の例に示すように、Spring アノテーションを使用する場合とまったく同じ方法でコンポーネントスキャンを使用できます。

  • Java

  • Kotlin

@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 パッケージ名前空間に注意)、次の例に示すように、これらのアノテーション型を含めるようにコンポーネントスキャンを明示的に構成できます。

  • Java

  • Kotlin

@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 を登録する必要があります。

JSR-330 標準アノテーションの制限

JSR-330 標準アノテーションを使用する場合、次の表に示すように、いくつかの重要な機能が使用できないことに注意してください。

表 1: Spring コンポーネントモデルと JSR-330 バリアントの比較
SpringJSR-330JSR-330 の制限事項 / コメント

@Autowired

@Inject

@Inject has no required attribute. Can be used with Java’s Optional instead.

@Component

@Named

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 is just a meta-annotation for building custom qualifiers. Concrete String qualifiers (like Spring’s @Qualifier with a value) can be associated through jakarta.inject.Named.

@Value

-

同等のものはありません

@Lazy

-

同等のものはありません

ObjectFactory

Provider

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