Spring Boot アプリケーション

目次

• 概要
• 使用すべき場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

適切なアノテーションベースの設定、依存性注入、RESTコントローラー、JPAデータ永続化、サービス層、セキュリティ実装を備えた、本番環境対応のSpring Bootアプリケーションをキヨを遵守して開発します。

使用すべき場面

• Spring Boot REST APIの構築
• サービス指向アーキテクチャの実装
• JPAを使用したデータ永続化の設定
• 依存性注入の管理
• Spring Securityの実装
• Spring Bootを使用したマイクロサービスの構築

クイックスタート

最小限の動作例：

<!-- pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>api-service</artifactId>
    <version>1.0.0</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.0</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリにおける詳細な実装：

ベストプラクティス

✅ 推奨

• 疎結合を実現するために依存性注入を使用する
• ビジネスロジックのためにサービス層を実装する
• データアクセスのためにリポジトリを使用する
• 認証のためにSpring Securityを活用する
• トランザクション管理のために@Transactionalを使用する
• コントローラーでのインプット検証
• 適切なHTTPステータスコードを返す
• リクエスト/レスポンスマッピングのためにDTOを使用する
• 適切な例外処理を実装する
• 非同期操作のためにSpringの@Asyncを使用する

❌ 非推奨

• ビジネスロジックをコントローラーに配置する
• コントローラーでデータベースに直接アクセスする
• 設定ファイルにシークレットを保存する
• 大規模なリレーションシップに対してeager loadingを使用する
• トランザクション境界を無視する
• API レスポンスでデータベースエンティティを返す
• コントローラーで認証を実装する
• パラメータ化されていない生のSQLを使用する
• ユーザー入力の検証を忘れる