導入

Springで開発していると、@Service などのアノテーションを付け忘れてエラーになることがあります。

「エラーが出たら付ける」という対応になりがちですが、なぜ必要なのかはあまり意識されません。

本記事では、@Component系アノテーションが必要な理由を整理します。

`@Component系アノテーション`をつけない場合の挙動

@Service などを付けていないクラスは、Springの管理対象（Bean）として登録されません。

public class UserService {}

この状態では、Springはこのクラスを「ただのクラス」として扱い、DI（依存性注入）の対象にはなりません。

そのため、以下のように依存注入しようとすると

@Autowired
private UserService userService;

Beanが存在しないため、NoSuchBeanDefinitionException が発生します。

つまり、クラス自体は存在していても、Springからは「管理されていない存在」として扱われている状態です。

Beanとは、Springが管理しているインスタンスのことです。

Springは、Beanとして登録されたクラスに対して

などを行います。

そのため、Beanとして登録されていないクラスは、Springの機能（特に依存注入）を利用することができません。

Beanとして登録されていない場合、Springはそのクラスのインスタンスを管理しないため、

@Autowired
private UserService userService;

のような依存注入ができず、エラーになります。

すべてのクラスに @Service などが必要なわけではありません。

判断基準はシンプルで、「インスタンスを誰が生成するか」です。

例えば、以下のように自分で生成するクラスはアノテーション不要です。

new User(...)

一方で、@Autowired などで依存注入したい場合は、Springがインスタンスを管理する必要があるため、@Service などのアノテーションが必要になります。

Spring Bootでは、起動時にクラスを自動で探し、必要なものをBeanとして登録しています。

このとき使われているのが、@ComponentScan という仕組みです。

@SpringBootApplication には内部的に @ComponentScan が含まれており、指定されたパッケージ配下のクラスがスキャンされます。

ただし、見つかったクラスがすべて登録されるわけではありません。

Springは、以下のようなアノテーションが付いているクラスだけを対象にBeanとして登録します。

これらはまとめて「@Component系アノテーション」と呼ばれます。

つまり、Springは

という流れでBeanを管理しています。

つまり、Springはアノテーションを目印にしてBean登録の対象を判断しているため、付いていないクラスは登録されません。

@Component系アノテーションは、Springにクラスを管理させるための目印です。
依存注入するクラスにはこれを付けてBeanとして登録しないと、Springの機能を利用することができません。