先生と生徒の会話形式で理解しよう

生徒

「Spring Data JPAでデータを検索する方法って、どんな書き方があるんですか？」

先生

「Spring Data JPAでは、findByで始まるメソッド名を使って簡単に検索処理が書けますよ。命名ルールに従えば、SQLを書かずに検索できます。」

生徒

「メソッド名だけで検索できるなんて便利ですね。どんなルールになっているのか詳しく知りたいです。」

先生

「それでは、Spring Data JPAのCRUD操作とQuery Methodsの基本を一緒に見ていきましょう！」

1. Spring Data JPAでのCRUDとは？

Spring Data JPAは、Javaでデータベースとやり取りする際の手間を大幅に減らしてくれる便利なライブラリです。特にCRUD操作、つまりデータの作成（Create）、取得（Read）、更新（Update）、削除（Delete）を、専用のメソッドや命名ルールを使うだけで簡単に実装できます。

CRUD操作を行うには、JpaRepositoryを継承したインターフェースを作成するだけでOKです。以下がその基本の書き方です。


import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

2. findByとは何か？Query Methodsの基本

Spring Data JPAでは、リポジトリにfindByというプレフィックスを付けたメソッドを定義することで、SQLを一切書かずに検索機能を実装できます。これを「Query Method（クエリメソッド）」と呼びます。

たとえば、ユーザーの名前で検索したいときは、以下のようにfindByNameというメソッドを定義するだけでOKです。


List<User> findByName(String name);

このように、メソッド名から自動的にJPQL（Java Persistence Query Language）を生成してくれるのがQuery Methodsの魅力です。

Spring Data JPAのQuery Methodsでは、findByに続けてエンティティのフィールド名をつけることで、自動的に検索処理を作成してくれます。基本構文は以下の通りです。

例えば、名前とメールアドレスの両方で検索する場合は次のようになります。


List<User> findByNameAndEmail(String name, String email);

Query Methodsでは、さまざまな演算子を使って柔軟な検索が可能です。以下によく使う演算子をまとめます。

たとえば、名前に「山」が含まれているユーザーを検索するには、以下のように書きます。


List<User> findByNameContaining(String keyword);

Query Methodsでは、結果のソート（昇順・降順）もメソッド名に記述できます。OrderByを使い、対象フィールドにAscやDescをつけるだけです。


List<User> findByAgeGreaterThanOrderByNameAsc(int age);

この例では、指定した年齢より大きいユーザーを名前順（昇順）で取得します。

1件だけを取得する場合は、戻り値にOptionalを使うことで、nullチェックを安全に行うことができます。


Optional<User> findByEmail(String email);

取得できなかった場合もOptional.empty()が返るので、nullによるエラーを防げます。

Query Methodsで書けない複雑なクエリが必要なときは、@Queryアノテーションを使ってJPQLを明示的に書くことができます。


@Query("SELECT u FROM User u WHERE u.name LIKE %:keyword%")
List<User> searchByName(@Param("keyword") String keyword);

ただし、単純な検索であればfindBy命名ルールで十分対応可能なので、まずは命名ベースで書くのがおすすめです。

以下は実務でよく使われるfindBy命名例です。

このような命名規則を理解しておくことで、Spring Data JPAで柔軟かつ高速な開発が可能になります。