エラーがある場合は元の入力画面に戻す方法｜Spring MVCでの画面遷移制御を初心者向けに解説

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

新人

「Spring MVCでフォームの入力エラーがあった場合、どうやって元の入力画面に戻すんでしょうか？」

先輩

「エラーがある場合は、入力フォームに戻してユーザーに再入力を促すのが基本的な流れです。Spring MVCではバリデーション結果をBindingResultで受け取り、エラーの有無を判定して画面遷移を制御します。」

新人

「BindingResultを使ってどうやって画面遷移を制御するんですか？」

先輩

「BindingResultのhasErrors()メソッドでエラーの有無をチェックし、エラーがあれば入力画面のビュー名を返すことで画面遷移を元に戻します。エラーがなければ次の処理へ進みます。」

新人

「なるほど、具体的なコード例を見たいです！」

先輩

「もちろんです。PleiadesとGradleで開発する環境で@Controllerを使った例を次で解説しますね。」

1. エラーがある場合に元の入力画面に戻すとはどういうことか？基本的な概要

Webアプリケーションでユーザーがフォームに入力した情報が誤っている場合、そのまま処理を進めると正しく動作しません。そこで、入力内容を検証してエラーがあったら「元の入力画面に戻す」処理を行い、ユーザーに間違いを知らせて修正してもらいます。

この仕組みはユーザーの入力ミスを防ぎ、システムの安定性とユーザー体験を高めるために欠かせません。Spring MVCではこの処理を簡単に実装できるバリデーション機能が提供されています。

2. Spring MVCでエラー判定を行い、画面遷移を制御する仕組み

Spring MVCでは、フォーム入力を受け取るコントローラのメソッドで、@Validatedや@Validアノテーションを使って入力内容の検証を行います。その検証結果はBindingResultに格納され、エラーがあるかどうかをhasErrors()メソッドで判定できます。

エラーがあれば処理を中断し、元の入力画面のビュー名を返すことで画面遷移を制御します。エラーがなければ次の処理（例えばデータ保存や完了画面への遷移）へ進みます。

この流れにより、入力ミスのあるユーザーは適切にエラー画面に戻され、再入力が促されます。これが「エラーがある場合は元の入力画面に戻す」基本の仕組みです。

3. BindingResultを使ったエラー検出の方法と活用例

Spring MVCでフォームの入力エラーを検出するには、BindingResultが重要な役割を果たします。@Validatedや@Validを付けたフォームオブジェクトの直後にBindingResultをメソッドの引数として受け取ることで、入力チェックの結果を取得できます。

BindingResultは、バリデーションの結果、エラーがあるかどうかを判定するhasErrors()メソッドを提供しており、これを使って処理の分岐が可能です。エラーの詳細はgetFieldError()やgetAllErrors()で取得し、ユーザーへのフィードバックに利用します。

例えば、ユーザー登録フォームで名前やメールアドレスに入力ミスがあった場合、BindingResultでそれらのエラーを検知し、再度入力画面に戻してユーザーに修正を促します。

4. コントローラでエラー判定後、入力画面に戻す具体的なコード例

ここでは、Pleiades環境でGradleを使用し、@Controllerを使った具体的なコード例を示します。フォームのバリデーションでエラーがあった場合、元の入力画面に戻る基本的な実装例です。


@Controller
public class UserController {

    @PostMapping("/register")
    public String registerUser(@Validated UserForm userForm, BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            // バリデーションエラーがあれば入力画面に戻す
            return "registerForm";
        }
        // エラーなしなら次の処理へ（例：登録処理）
        return "registerSuccess";
    }
}

このコードでは、bindingResult.hasErrors()がtrueの場合、入力画面であるregisterFormを返しています。これにより、ユーザーはエラーのあった画面に戻り、修正を行えます。

エラーがない場合は、正常処理として成功画面などに遷移します。これがエラーがある場合に元の入力画面に戻す流れの基本です。

5. エラー時に入力値を保持して画面に戻すポイント

エラーがあった場合に入力画面に戻す際、ユーザーが入力済みの値を保持することは非常に重要です。これによりユーザーの負担を減らし、快適な操作性を実現します。

Spring MVCでは、フォームオブジェクト（上記例のUserForm）をモデルに戻すことで、入力値の保持が可能です。Thymeleafのth:objectとth:fieldを使えば、画面に自動的に値がセットされます。

以下は入力値を保持するためのコントローラの例です。


@PostMapping("/register")
public String registerUser(@Validated UserForm userForm, BindingResult bindingResult, Model model) {
    if (bindingResult.hasErrors()) {
        model.addAttribute("userForm", userForm); // 入力値をモデルに戻す
        return "registerForm";
    }
    return "registerSuccess";
}

このように、エラーがある場合でもモデルにフォームオブジェクトを追加し直すことで、ユーザーが入力したデータを画面に保持して再表示できます。これにより、ユーザーは再入力の手間を省けるため、操作性が大幅に向上します。

6. エラー処理でよくあるトラブルと解決方法

Spring MVCでエラーが発生した際に元の入力画面に戻す処理を実装する際、初心者の方が陥りやすいトラブルがいくつかあります。ここでは代表的な問題とその解決方法を紹介します。

まずよくある問題は、BindingResultをメソッド引数の正しい位置に置かないことです。BindingResultはバリデーション対象のオブジェクトの直後に置かなければ、Springが正しくエラー情報を渡せません。これにより、エラー判定が常にfalseになるなどの不具合が起きます。

次に、エラー時にフォームオブジェクトをモデルに戻さないと、画面に入力値が保持されず、ユーザーは再入力を強いられてしまいます。必ずエラー時はフォームオブジェクトをモデルにセットし、Thymeleafのth:fieldで表示できるようにしましょう。

さらに、エラーメッセージの表示方法が適切でない場合、ユーザーにどの入力項目が間違っているか分かりにくくなります。Thymeleafのth:errorsやth:ifを活用して、必要なエラーメッセージだけを表示する工夫が重要です。

7. ユーザーに優しいエラー画面の作り方のポイント

エラー画面はユーザーにとってストレスなく誤りを修正できることが大切です。以下のポイントを意識して設計しましょう。

具体的でわかりやすいメッセージ：エラーメッセージは「必須項目です」や「正しい形式で入力してください」など、ユーザーが何を直せば良いかすぐに理解できる内容にしましょう。
エラー箇所の明示：エラーがあるフィールドの近くにメッセージを表示し、どこが間違っているのか一目で分かるようにします。
入力値の保持：エラー時もユーザーが入力した内容が保持されていることで、修正だけを行いやすくします。
視覚的な区別：エラー表示は色やアイコンで目立たせ、ユーザーがすぐに気付けるように工夫します（ただし今回の要件ではBootStrapを使わないので、CSSクラス名で独自スタイルを設定すると良いでしょう）。
複数エラーの対応：複数のエラーが同時に発生してもすべてのエラーメッセージが表示されるようにしましょう。

これらを踏まえてエラー画面を設計すると、ユーザーがスムーズに誤入力を修正できるため、満足度が向上します。