はじめに
「Repository を書いて終わり」から抜け出すために、よくある「分かったつもり」状態の整理をします。
よくある状態
・JpaRepository を継承しているだけ
・findById / save を何となく使っている
でも聞かれると、「SQL を書かなくてよくなるやつ…?」となる。
Spring Data JPA
一言で言うと、DBアクセスの定型処理を Spring が肩代わりする仕組みです。
・SQL を“書かなくてよい”のが本質ではない
・責務分離と保守性向上が目的
※書かなくていいコードが非常に多い
1. CRUD メソッドの自動提供
何が便利なのか・・?
public interface UserRepository extends JpaRepository<User, Long> {
}
これだけで、以下が全て使えます。
・findById
・findAll
・save
・deleteById
・count
→ SQL / 実装ゼロ
実務での使い所
・単純なマスタ管理
・管理画面 CRUD
・参照系 API
→ 8 割以上の DB 操作はこれで足りる
2. メソッド名クエリ
メソッド名から SQL を自動生成できる。
Optional<User> findByEmail(String email);
List<User> findByStatusAndDeletedFalse(String status);
内部的に何が起きているか
SELECT * FROM user WHERE email = ?
実務で便利な理由
・SQL を書かずに検索条件を表現できる
・条件がメソッド名に現れるため 意図が分かりやすい
注意点(重要):複雑にしすぎない
3. ページング・ソート(Pageable)
よくある要件
・一覧画面
・検索結果
・APIレスポンス制限
実装例
Page<User> findAll(Pageable pageable);
PageRequest.of(0, 20, Sort.by("createdAt").descending());
何が便利か
・limit / offset を自動処理
・件数取得も一緒にやってくれる
実務ポイント
・無限スクロール
・管理画面一覧
・CSV 出力前処理
4. @Query による柔軟なクエリ
・JOIN
・集計
・複雑条件 に使う
JPQL
@Query("select u from User u where u.status = :status")
List<User> findActive(@Param("status") String status);
Native Query
@Query(value = "SELECT * FROM users WHERE status = ?", nativeQuery = true)
List<User> findNative(String status);
使い分け指針
単純検索 → メソッド名
複雑 → @Query
パフォーマンス → Native
トランザクション管理
commit / rollback を自動管理
例外時は自動 rollback
@Transactional
public void updateUser() {
// 複数更新
}
実務での価値
・手動管理ミス防止
・ロジックに集中できる
よくある勘違い
❌ Repository に @Transactional
⭕ Service に付与
監査機能(Auditing)
こんな項目、ありませんか?
・作成日時
・更新日時
・作成者
実装例
@CreatedDate
private LocalDateTime createdAt;
@LastModifiedDate
private LocalDateTime updatedAt;
実務メリット
・更新漏れ防止
・ログ代替
7. Optional による null 安全
null を返さない設計
Optional<User> findById(Long id);
実務での効果:
・NullPointerException防止
・存在チェックの明確化
8. 注意点
・Entity を API に直接返さない
・Lazy / Eager を理解する
・N+1 問題を知っておく