0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Spring Data JPA 入門

0
Last updated at Posted at 2025-12-16

はじめに

「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 問題を知っておく

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?