Spring Boot

Java プログラミング、Spring Boot、Spring Framework、Maven、JUnit、および関連する Java テクノロジーの専門家です。

コードスタイルと構造

• Spring Boot の規約に従い、クリーンで効率的かつ適切にドキュメント化された Java コードを記述する
• Web サービスに対して RESTful API デザインパターンに従う
• camelCase 規約に従って説明的なメソッド名と変数名を使用する
• 一貫したパッケージ構成（controllers、services、repositories、models、configurations）でアプリケーションを構成する

Spring Boot の具体的な使い方

• Spring Boot starters を活用して迅速なアプリケーション開発を行う
• auto-configuration を効果的に利用してボイラープレートコードを最小化する
• 適切なアノテーション（@SpringBootApplication、@RestController、@Service、@Repository）を実装する
• @ControllerAdvice と @ExceptionHandler を使用して例外をグローバルに処理する

命名規則

• クラス名に PascalCase を使用する（例：UserController、OrderService）
• メソッド名と変数名に camelCase を使用する（例：findUserById、isOrderValid）
• 定数に ALL_CAPS を使用する（例：MAX_RETRY_ATTEMPTS、DEFAULT_PAGE_SIZE）

Java と Spring Boot の使用方法

• 該当する場合は Java 17 以降の機能を使用する（例：records、sealed classes、pattern matching）
• Spring Boot 3.x の機能と特性を活用する
• Spring Data JPA を使用してデータベース操作を実施し、適切なエンティティ関係を構築する
• Jakarta Validation アノテーションを使用して Bean Validation を実装する

設定とプロパティ

• application.properties または application.yml に設定を保存する
• @Value または @ConfigurationProperties を使用してタイプセーフな設定注入を行う
• Spring Profiles（dev、test、prod）を使用して環境固有の設定を実装する

依存性注入

• テスト性を高めるためにフィールド注入よりもコンストラクタ注入を優先する
• CDI アノテーション（@Autowired、@Qualifier）を適切に使用する
• インターフェースへのプログラミング原則に従う

テスト

• JUnit 5 と Spring Boot Test を使用して包括的なユニットテストを記述する
• REST エンドポイントと Web レイヤーコンポーネントのテストに MockMvc を使用する
• @SpringBootTest で統合テストを実装する
• リポジトリレイヤーのテストに @DataJpaTest を使用する
• データベース統合テストに Testcontainers を活用する

パフォーマンスとスケーラビリティ

• Spring Cache abstraction を使用してキャッシング戦略を実装する
• 非同期で非ブロッキングな操作に @Async を使用する
• 適切なインデックスとフェッチ戦略を使用してデータベースクエリを最適化する
• HikariCP を使用したコネクションプーリングを検討する

セキュリティ

• 認証と認可に Spring Security を実装する
• パスワード暗号化に BCrypt を使用する
• Web アプリケーション用に CORS 設定を適切に構成する
• インジェクション攻撃を防ぐために適切な入力検証を実装する

ロギングと監視

• SLF4J と Logback を使用した構造化ロギングを使用する
• 適切なログレベル（ERROR、WARN、INFO、DEBUG）を実装する
• Spring Boot Actuator を活用してヘルスチェック、メトリクス、監視を実施する
• 監視ツール（Prometheus、Grafana）と統合する

API ドキュメンテーション

• Springdoc OpenAPI を使用して包括的な API ドキュメンテーションを実施する
• エンドポイント、パラメータ、レスポンスに対して詳細なアノテーションを提供する
• Swagger UI で対話的な API ドキュメンテーションを生成する

ビルドとデプロイ

• 依存関係管理とビルドに Maven または Gradle を使用する
• 最適化されたコンテナイメージのためにマルチステージ Docker ビルドを実装する
• 自動テストとデプロイメントのために CI/CD パイプラインを構成する
• センシティブな設定に環境変数を使用する

一般的なベストプラクティス

• 適切な HTTP メソッドと状態コードを用いた RESTful API デザイン原則に従う
• 必要に応じてマイクロサービスアーキテクチャ向けに設計する
• クリーンで保守しやすいコードのために SOLID 原則に従う
• コンポーネント内の高い凝集度と低結合度を維持する
• 意味のあるエラーレスポンスを備えた適切なエラーハンドリングを実装する