spring-data-jpa について
spring-data-jpa は、Spring Data JPA を使う開発者向けのスキルです。エンティティ、Repository、クエリ、トランザクションの基本から、応用設定や性能上の注意点まで扱います。
主な機能
- 01エンティティとRepositoryの定義
- 02派生クエリとJPQLクエリ
- 03ページネーションとSpecification
- 04エンティティグラフ、監査、複数データソース
- 05トランザクション伝播と性能上の注意点
活用シーン
- 01永続化用エンティティのマッピング
- 02Repositoryのクエリインターフェース構築
- 03データソースとトランザクション境界の設定
- 04N+1クエリやページネーションの問題への対応
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ full-stack-skills/ spring-skills --skill spring-data-jpaインストール後、Claude Code で/spring-data-jpaを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlLICENSE.txt
詳細
このスキルを使用するタイミング
次のことをユーザーが希望する場合は、いつでもこのスキルを使用してください。
- Spring Data JPA を使ってエンティティ、Repository、クエリメソッド、トランザクションを定義する
- データソース、JPQL、仕様、監査を設定する
このスキルの使用方法
- 基本:@Entity、JpaRepository、CrudRepository;メソッド名によるクエリ、@Query、Pageable。
- 応用:@EntityGraph、Specification、監査 @CreatedDate;複数データソースとトランザクション伝播。
- 参考:https://spring.io/projects/spring-data-jpa
ベストプラクティス
- N+1 とフェッチ戦略に注意し、ページネーションと一括操作を活用します。
- エンティティと DTO を分離し、トランザクション境界を明確にします。
キーワード
spring data jpa, JPA, Repository, 永続化
よくある落とし穴(Gotchas)
- バージョンの互換性:フレームワークのバージョンと依存ライブラリの互換性に注意してください。バージョンによって API に違いがある場合があります。
- 設定ファイルの形式:設定ファイルの形式の誤りは、最もよくある問題です。エディターの構文チェックを使用することをおすすめします。
- 環境変数:必要な環境変数がすべて正しく設定されていることを確認してください。機密情報をハードコードしないでください。
- 依存関係の競合:複数のバージョンが共存する場合は依存関係の競合に注意し、lock ファイルを使用してバージョンを固定してください。
- パフォーマンスの落とし穴:大量のデータを扱う場合はパフォーマンスの最適化に注意し、N+1 クエリなどのよくある問題を避けてください。
使用手順
Step 1: 環境の準備
開発環境に必要な依存関係とツールがインストールされていることを確認します。
Step 2: 初期設定
プロジェクトの要件に応じて基本設定を行います。
Step 3: コア機能の使用
サンプルコードに従ってコア機能を実装します。
Step 4: テストと検証
テストを実行して、機能が正常に動作することを確認します。
Step 5: デプロイ
開発が完了したら、デプロイと監視を行います。
コメント
Markdown 対応