SpringのfindAll()とfindById()の使い方を丁寧に解説！初心者向けSpring Data JPA入門

新人と先輩の会話形式で理解しよう

新人

「Springでデータベースからデータを取得するには、どんな方法があるんですか？」

先輩

「Springでは、Spring Data JPAを使って、簡単にデータベース操作ができます。特に、findAll()やfindById()といった基本メソッドがよく使われます。」

新人

「なんだか便利そうですね！でも、どうやって使うのかよく分かりません…」

先輩

「それなら、まずはSpring Data JPAの基本から順番に見ていこうか！」

1. Spring Data JPAとは？

Spring Data JPAとは、Spring Frameworkの中でも特に人気の高いモジュールで、データベース操作を簡単にしてくれる仕組みです。SQLを書かなくても、インターフェースを定義するだけで、データの検索・登録・更新・削除などの基本的な操作ができるようになります。

特に初心者にとっては、複雑な設定やSQLを書く必要がないため、学習コストを大幅に下げることができます。

たとえば、データベースにあるすべてのレコードを取得したい場合は、findAll()メソッドを使うだけで済みます。

2. Repositoryとは？なぜ使うのか

Repositoryは、Spring Data JPAでデータベース操作を行うための重要なインターフェースです。これを使うことで、Javaコードから直接データベースにアクセスすることができます。

たとえば、JpaRepositoryを継承するインターフェースを作成するだけで、以下のような基本操作が自動で提供されます：

全件取得：findAll()
ID検索：findById()
新規登録・更新：save()
削除：delete()

下記のように記述することで、独自のRepositoryインターフェースを作成できます。


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

public interface BookRepository extends JpaRepository<Book, Long> {
}

このBookRepositoryを使えば、SQLを1行も書かずに、本の一覧取得や個別検索ができるようになります。

3. 開発環境の前提：Pleiades + Gradle + Controller構成

ここからのサンプルは、以下の前提環境で実行されることを想定しています。

開発環境： Pleiades All in Oneを使用（Eclipseベース）
ビルドツール： Mavenではなく、Gradleを使用
プロジェクト作成： PleiadesからSpringプロジェクトを新規作成
依存関係追加： Pleiadesのウィザード画面で「Spring Web」「Spring Data JPA」「H2 Database」などをチェックして追加
コントローラー構成： @Controllerを使用し、画面遷移やビュー出力を前提とする
補足： @RestControllerは使用せず、Bootstrap等の外部UIライブラリも使用しない

開発時には、まず「Spring Starter Project」を作成し、ビルドツールとしてGradleを選択します。その後、Pleiadesの画面で必要な依存関係をチェックすることで、Spring Data JPA関連のライブラリが自動で組み込まれます。

また、ビューにはThymeleafを使う構成が一般的ですが、本記事ではHTML表示の詳細までは触れません。主にfindAll()やfindById()のJava側の使い方にフォーカスして解説していきます。

新人と先輩の会話（おさらい）

新人

「Repositoryってインターフェースだけ書けば、もう使えるんですね！」

先輩

「その通り。JpaRepositoryを継承するだけで、基本的なデータ操作がすぐに使えるのがSpring Data JPAの魅力だよ。」

新人

「便利すぎる…でも、実際にfindAll()やfindById()をどうやって使うのか見てみたいです！」

先輩

「よし、次はそれらのメソッドの使い方を具体的に見ていこう！」

4. findAll()の使い方とその意味

それではまず、Spring Data JPAにおける基本操作のひとつであるfindAll()の使い方を見ていきましょう。このメソッドは、エンティティクラスに対応するテーブルから、すべてのレコードを取得するためのものです。

たとえば、Bookエンティティに対応するBookRepositoryがある場合、以下のようなコードで全件取得を行います。


@Controller
public class BookController {

    @Autowired
    private BookRepository bookRepository;

    @GetMapping("/books")
    public String getAllBooks(Model model) {
        List<Book> bookList = bookRepository.findAll();
        model.addAttribute("books", bookList);
        return "book-list";
    }
}

この例では、Spring MVCの@ControllerとModelを使って、ビューにデータを渡しています。findAll()はデータベースのテーブルから全レコードを取得し、リスト形式で返してくれるため、そのままModelに詰めて、ビューで一覧表示に使うことができます。

取得したデータをThymeleafなどのテンプレートエンジンでループ表示すれば、簡単に一覧画面を作成することが可能です。

新人と先輩の会話（findAll編）

新人

「なるほど、findAll()で全部のデータを一括で取得できるんですね！」

先輩

「そうだね。リスト形式で戻ってくるから、あとはループで表示すればOKだよ。」

新人

「ビューに渡すときは、Modelに詰めるだけでいいんですか？」

先輩

「うん、addAttribute()を使えばビュー側で受け取れるよ。」

5. findById()の使い方とOptionalの扱い方

続いて、findById()メソッドの使い方を紹介します。これは、特定のIDを指定して1件のデータを検索するためのメソッドです。findById()は、戻り値としてOptionalを返すのが特徴です。

Optionalとは、値があるかもしれないし、ないかもしれないという状態を扱うためのクラスで、Java8から導入されたものです。

使用例を見てみましょう。


@Controller
public class BookController {

    @Autowired
    private BookRepository bookRepository;

    @GetMapping("/books/{id}")
    public String getBookDetail(@PathVariable("id") Long id, Model model) {
        Optional<Book> optionalBook = bookRepository.findById(id);
        if (optionalBook.isPresent()) {
            Book book = optionalBook.get();
            model.addAttribute("book", book);
            return "book-detail";
        } else {
            return "book-not-found";
        }
    }
}

ここでは、URLのパスからIDを取得し、findById()でデータベースを検索しています。重要なのは、Optionalで戻ってくるため、isPresent()で存在確認をしないとNoSuchElementExceptionが発生する可能性があるという点です。

初心者がつまずきやすいポイントは、Optionalのget()を無条件で呼び出してしまうケースです。データが存在しない場合に例外となるため、必ずisPresent()で確認するか、orElse()やorElseThrow()などのメソッドを活用すると安全です。

新人と先輩の会話（findById編）

新人

「findById()って、Optionalで戻ってくるんですね。なんで普通にBookじゃないんですか？」

先輩

「それは、指定したIDが存在しない可能性があるからだよ。Optionalを使えば、そういうときに例外を防げるんだ。」

新人

「なるほど！じゃあ、必ずisPresent()で確認してから使うようにすればいいんですね！」

先輩

「その通り。Optionalをうまく使いこなせれば、エラーの少ないコードが書けるようになるよ。」

6. 実行結果の見方と画面表示の流れ

Spring MVCでは、@Controllerで定義したメソッドが返す文字列が、テンプレートファイル（Thymeleafなど）の名前に対応しています。たとえば、return "book-list";とした場合、src/main/resources/templates/book-list.htmlがレンダリングされる仕組みです。

そのため、画面表示を確認するには、まず該当するテンプレートファイルを作成し、受け取ったデータを表示する構文を書きます。


<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>書籍一覧</title>
</head>
<body>
    <h1>書籍一覧</h1>
    <ul>
        <li th:each="book : ${books}">
            <a th:href="@{'/books/' + ${book.id}}" th:text="${book.title}"></a>
        </li>
    </ul>
</body>
</html>

このように記述すれば、一覧ページではfindAll()で取得したデータがすべて表示され、それぞれのリンクをクリックすることでfindById()を使った詳細ページに遷移する構成が作れます。

このような構成は、Spring MVCの基本であり、シンプルながら強力なデータ表示ロジックです。初心者にとっては、ControllerとHTMLテンプレートとの連携をしっかり理解することで、Webアプリ開発の基礎が身につきます。

新人と先輩の会話（画面表示編）

新人

「ビューのファイル名って、Controllerの戻り値に対応してるんですね！」

先輩

「そうそう、Spring MVCではそれが基本の考え方だよ。テンプレートファイルと連携させれば、データ表示も簡単になるよ。」

新人

「なんだか全体の流れが見えてきた気がします！」

先輩

「それなら次は、エラー処理やデータの登録・更新の仕組みも学んでいこう！」

7. よくあるエラーとその解決法

Spring Data JPAでfindAll()やfindById()を使用する際、初心者がつまずきやすいエラーにはいくつかのパターンがあります。ここでは代表的なものを紹介し、それぞれの原因と対処法を解説します。

① Repositoryが正しく登録されていない

エラーメッセージ：


Consider defining a bean of type 'com.example.repository.BookRepository' in your configuration.

このエラーは、SpringがBookRepositoryをコンポーネントとして認識できていないことを意味します。原因は以下のようなものです：

リポジトリのパッケージが@ComponentScanの対象外
@EnableJpaRepositoriesが指定されていない（通常はSpring Bootで不要）

対策として、@SpringBootApplicationがあるクラスと同じパッケージまたはサブパッケージにリポジトリを置くようにしましょう。

② `findById()`でデータが存在しない場合のNullPointerException

Optionalを適切に扱わない場合、以下のような例外が発生することがあります。


java.util.NoSuchElementException: No value present

これはOptional.get()を無条件に呼び出したことが原因です。下記のように、isPresent()で存在を確認してから取り出すようにしましょう。


Optional<Book> optionalBook = bookRepository.findById(id);
if (optionalBook.isPresent()) {
    Book book = optionalBook.get();
    // 処理
} else {
    // 存在しない場合の処理
}

③ `findAll()`の結果が空で画面に何も表示されない

エラーではなく仕様ですが、データが存在しない場合はfindAll()が空のリストを返します。そのためビュー側で何も表示されず、「データが取得できていないのでは？」と誤解されがちです。

テンプレート側では、空リストであることを考慮し、下記のようにメッセージを表示することでユーザーに優しい画面が作れます。


<ul th:if="${#lists.isEmpty(books)}">
    <li>表示するデータがありません。</li>
</ul>
<ul th:if="${!#lists.isEmpty(books)}">
    <li th:each="book : ${books}">
        <span th:text="${book.title}"></span>
    </li>
</ul>

8. findAll()とfindById()を使った実用例

ここまで学んだ知識を活かして、書籍一覧画面と詳細画面を連携させたミニアプリを作ってみましょう。

① 書籍エンティティ


@Entity
public class Book {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;

    private String author;

    // getter・setter省略
}

② Repository


public interface BookRepository extends JpaRepository<Book, Long> {
}

③ Controller


@Controller
public class BookController {

    @Autowired
    private BookRepository bookRepository;

    @GetMapping("/books")
    public String showBookList(Model model) {
        List<Book> list = bookRepository.findAll();
        model.addAttribute("books", list);
        return "book-list";
    }

    @GetMapping("/books/{id}")
    public String showBookDetail(@PathVariable Long id, Model model) {
        Optional<Book> bookOpt = bookRepository.findById(id);
        if (bookOpt.isPresent()) {
            model.addAttribute("book", bookOpt.get());
            return "book-detail";
        } else {
            return "book-not-found";
        }
    }
}

④ 一覧テンプレート


<ul>
    <li th:each="book : ${books}">
        <a th:href="@{'/books/' + ${book.id}}" th:text="${book.title}"></a>
    </li>
</ul>

⑤ 詳細テンプレート


<div>
    <h2 th:text="${book.title}"></h2>
    <p th:text="${book.author}"></p>
</div>

このように、findAll()とfindById()を組み合わせることで、非常に簡単に一覧→詳細のWebアプリケーションを構築できます。Spring MVCの構造になれていない方でも、Controllerとテンプレートをしっかり対応させれば、実用的な画面が作れます。

9. 今後学ぶべき内容とまとめ

この記事では、Spring Data JPAを使った基本的なデータ取得方法として、findAll()とfindById()の使い方を中心に解説しました。開発環境としてPleiadesを使い、Gradleで構築したプロジェクト内で、@Controllerを使ってデータの取得からビューへの表示までを流れに沿って説明してきました。

初心者が特につまずきやすい「Optionalの扱い方」や「リポジトリの登録忘れ」「findByIdでのnull対応」などについても丁寧に触れました。こうしたトラブルへの対処方法を理解することで、今後より実践的なアプリケーション開発に進む土台ができあがります。

次のステップとしては、データの登録や更新を行うためのsave()メソッド、データの削除を行うdelete()メソッドの活用方法を学ぶとよいでしょう。また、複雑な条件検索を行いたい場合は、@Queryアノテーションを用いたカスタムクエリの作成にも挑戦すると、より自由なデータ操作ができるようになります。

引き続き、Spring FrameworkやSpring Data JPAの公式ドキュメント、そして実践的なサンプルコードを通じて知識を深めていきましょう。