この記事の要点
Spring Framework / Spring Boot でよく使う主要アノテーションを役割別に整理 レイヤー: Web 層 (@Controller, @RestController) / Service 層 (@Service) / Repository 層 (@Repository) / DI (@Autowired, @Qualifier) / 設定 (@Configuration, @Bean) @Component は汎用、@Service / @Repository / @Controller はそれぞれ意味付きで特殊化 Spring Boot は @SpringBootApplication 一つで @Configuration + @EnableAutoConfiguration + @ComponentScan をまとめて有効化

 

レイヤー別 主要アノテーション一覧

① ステレオタイプ（Bean 登録）

Spring コンテナに Bean として登録されるクラスにつけるアノテーション。

アノテーション	用途	備考
@Component	汎用 Bean 登録	下記 3 つの親、特に意味付けがない時に使う
@Controller	Web MVC コントローラ	HTML / JSP を返す
@RestController	REST API コントローラ	@Controller + @ResponseBody 相当
@Service	ビジネスロジック層	機能的には @Component と同じだが、意味付けで使う
@Repository	データアクセス層	DB 例外を Spring の DataAccessException に変換

② DI（依存性注入）

アノテーション	用途
@Autowired	型による自動注入。フィールド・コンストラクタ・セッターに付与可
@Qualifier("name")	同型 Bean が複数ある時、名前で特定
@Value("${app.host}")	プロパティ値 / 環境変数を注入
@Resource(name="...")	JSR-250、名前優先で注入
@Inject	JSR-330、@Autowired と同等
@Lazy	必要になるまで Bean 初期化を遅延

③ 設定・構成

アノテーション	用途
@Configuration	JavaConfig クラス（XML 設定の代替）
@Bean	@Configuration 内でメソッドを Bean 化
@ComponentScan	指定パッケージ配下の @Component を自動検出
@PropertySource("...")	外部プロパティファイルの読み込み
@Profile("dev")	環境別 Bean（プロファイル）
@Conditional	条件付き Bean 登録

④ Spring MVC（Web 層）

アノテーション	用途
@RequestMapping("/path")	URL とハンドラーメソッドの紐付け（全メソッド対応）
@GetMapping("/path")	GET 専用ショートカット
@PostMapping("/path")	POST 専用
@PutMapping / @DeleteMapping / @PatchMapping	各 HTTP メソッド専用
@PathVariable	URL パスから値を取得（/users/{id}）
@RequestParam	クエリパラメータ / フォームから取得
@RequestBody	リクエストボディ (JSON 等) をオブジェクトに変換
@ResponseBody	戻り値をレスポンスボディに直接書き出し
@ResponseStatus(HttpStatus.OK)	HTTP ステータスコード指定
@ModelAttribute	フォームバインディング・モデル属性
@CrossOrigin	CORS 設定
@ExceptionHandler	コントローラ内例外ハンドラ
@ControllerAdvice	グローバル例外ハンドラ

⑤ Spring Data JPA

アノテーション	用途
@Entity	JPA エンティティクラス
@Table(name="users")	テーブル名指定
@Id	主キー
@GeneratedValue(strategy=...)	主キー自動生成（IDENTITY / SEQUENCE / AUTO）
@Column(name="user_name", nullable=false)	カラム属性
@OneToMany / @ManyToOne / @OneToOne / @ManyToMany	関連
@JoinColumn(name="user_id")	外部キーカラム
@Query("SELECT u FROM User u WHERE ...")	カスタムクエリ
@Modifying	更新クエリ（@Query 付き）
@Transactional	トランザクション境界

⑥ Spring Boot 専用

アノテーション	用途
@SpringBootApplication	メインクラス。@Configuration + @EnableAutoConfiguration + @ComponentScan
@EnableAutoConfiguration	自動設定を有効化
@SpringBootTest	テスト時に Spring コンテキストを起動
@ConfigurationProperties(prefix="app")	プロパティを POJO にバインド
@EnableScheduling	スケジュールタスクを有効化
@Scheduled(cron="0 0 * * * *")	定期実行
@Async	非同期実行

典型的なクラス構成例

@RestController
@RequestMapping("/api/users")
@RequiredArgsConstructor  // Lombok: final フィールドのコンストラクタ自動生成
public class UserController {
    private final UserService userService;

    @GetMapping("/{id}")
    public UserDto get(@PathVariable Long id) {
        return userService.findById(id);
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public UserDto create(@RequestBody @Valid UserCreateRequest req) {
        return userService.create(req);
    }
}

@Service
@RequiredArgsConstructor
public class UserService {
    private final UserRepository userRepository;

    @Transactional(readOnly = true)
    public UserDto findById(Long id) {
        User user = userRepository.findById(id)
            .orElseThrow(() -> new EntityNotFoundException());
        return UserDto.from(user);
    }
}

@Repository
public interface UserRepository extends JpaRepository {
    Optional findByEmail(String email);
}

@Component vs @Service vs @Repository vs @Controller の違い

すべて Bean 登録のためのアノテーションで、機能的にはほぼ同じです。意味付けと AOP の対象として区別します:

• @Component: 汎用、何の役割でもない時
• @Service: ビジネスロジック層であることを明示
• @Repository: DAO 層であることを明示 + DB 例外を DataAccessException に自動変換
• @Controller: Web MVC コントローラ + Spring MVC ハンドラとして認識

機能差があるのは @Repository（例外変換）と @Controller（MVC 認識）のみ。機能と意味の両方で使い分けるのが習慣。

関連記事

• @Autowired
• @Value
• @ResponseBody
• @PathVariable
• @Column