java-springboot

使用する場面

• Spring Boot アプリケーションを開発するとき
• Spring Boot のベストプラクティスが必要なとき
• Spring Boot プロジェクトを設定するとき
• Spring フレームワークのコンポーネントを扱うとき

基本原則

1. コンストラクターインジェクション — テストしやすくするために、必ず使用してください。フィールドに @Autowired を付ける方法は使用しないでください。
2. DTO — JPA エンティティを API レイヤーに公開しないでください。レコードまたはプロジェクションインターフェースを使用してください。
3. 機能別のパッケージ構成 — レイヤー別（controller/、service/）ではなく、ドメイン別（order/、user/）にまとめてください。
4. バリデーション — リクエスト DTO に Bean Validation（@Valid、@NotBlank）を使用してください。
5. トランザクション — @Transactional を使用し、サービスレイヤーで短時間に保ってください。
6. ロギング — パラメーター化ロギング（{}）を使用し、文字列連結は使用しないでください。
7. セキュリティ — シークレットをハードコードしないでください。環境変数と @ConfigurationProperties を使用してください。
8. テスト — 十分な信頼性が得られる範囲で、最も対象を絞ったテストスライスを使用してください。
9. 設定 — application.yml と @ConfigurationProperties を使用して、すべての設定を外部化してください。
10. モニタリング — すべてのサービスに Actuator とヘルスチェックを追加してください。

リファレンス一覧

トピック	リファレンス
ビルドツール、スターター、パッケージ構成	references/project-setup.md
コンストラクターインジェクション、Lombok、ステレオタイプ	references/dependency-injection.md
application.yml、@ConfigurationProperties、プロファイル、シークレット	references/configuration.md
REST コントローラー、DTO、バリデーション、例外ハンドラー	references/web-layer.md
ビジネスロジック、@Transactional	references/service-layer.md
リポジトリ、クエリ、プロジェクション	references/data-layer.md
SLF4J ロギングのパターン	references/logging.md
Spring Security、JWT、パスワードエンコーディング	references/security.md
非同期処理、キャッシュ、API バージョニング、ページネーション	references/advanced.md
Actuator、ヘルスインジケーター	references/monitoring.md
テストスライスのクイックリファレンス	references/testing.md

コマンド

# Run Spring Boot application
mvn spring-boot:run

# Run with specific profile
mvn spring-boot:run -Dspring-boot.run.profiles=dev

# Build project
mvn clean package

# Run tests
mvn test

# Run specific test
mvn test -Dtest=OrderServiceTest

テスト

テストに関する包括的なガイダンス（テストスライス、MockMvcTester、Testcontainers、AssertJ）については、java-springboot-testing スキルを参照してください。

クイックリファレンス

テストの種類	アノテーション	用途
単体	@ExtendWith(MockitoExtension.class)	サービスロジック
Web	@WebMvcTest	コントローラー
データ	@DataJpaTest	リポジトリ
統合	@SpringBootTest	一連の処理全体
スライス	@RestClientTest	REST クライアント

Context7 との連携

Spring Boot の最新情報が必要な場合：

1. libraryId を解決する — context7_resolve-library-id を次の値で使用します：

   • libraryName: "spring boot" または "spring framework"
   • query: 実行する内容（例：「設定プロパティ」、「カスタムヘルスチェック」）

2. ドキュメントを照会する — context7_query-docs を次の値で使用します：

   • libraryId: 前の手順で取得した ID（例："/spring/spring-boot"）
   • query: 具体的な質問

Spring Boot の API、設定、ベストプラクティスについて回答する前に、Context7 を参照して最新情報を確認してください。

リソース

• Spring Boot ドキュメント
• Spring Framework ドキュメント
• Spring Security ドキュメント