1. @Emailアノテーションとは？

Springの@Emailアノテーションは、ユーザーが入力した文字列が正しいメールアドレス形式かどうかをチェックするためのバリデーション機能です。フォーム入力のバリデーションでは必須のチェック項目のひとつで、例えば「example@test.com」のような形式でなければエラーとなります。これにより、誤ったメールアドレスの登録を未然に防ぐことができます。

2. @Emailアノテーションの基本的な使い方

実際のSpringアプリケーションでは、エンティティクラスやDTOにアノテーションを付与して利用します。以下のように使うのが基本です。


import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;

public class UserForm {

    @NotBlank(message = "メールアドレスは必須です")
    @Email(message = "有効なメールアドレスを入力してください")
    private String email;

    // getterとsetter
    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

この例では、@NotBlankで空文字を禁止し、@Emailでメール形式をチェックしています。初心者でも簡単に導入でき、入力チェックの品質を向上できます。

3. バリデーションエラーの確認方法

Spring MVCでは、コントローラで@Validを利用することでバリデーションが自動で実行されます。もし入力が不正であれば、エラーメッセージを取得して画面に表示することが可能です。


import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import jakarta.validation.Valid;

@Controller
public class UserController {

    @GetMapping("/register")
    public String showForm(UserForm userForm) {
        return "register";
    }

    @PostMapping("/register")
    public String submitForm(@Valid UserForm userForm, BindingResult bindingResult, Model model) {
        if (bindingResult.hasErrors()) {
            return "register";
        }
        model.addAttribute("message", "登録が完了しました");
        return "success";
    }
}

このように、入力が正しくない場合はフォーム画面に戻り、ユーザーにエラーを知らせることができます。

4. @Emailアノテーションの注意点

@Emailはあくまで「形式チェック」を行うだけで、存在するメールアドレスかどうかまでは検証できません。例えば「test@test」と入力した場合は無効と判定されますが、「aaa@bbb.com」のような存在しないアドレスも形式としては有効と見なされます。そのため、必要に応じて追加の検証や、メール送信による確認が必要です。

5. エラーメッセージのカスタマイズ

@Emailアノテーションでは、message属性を利用して独自のメッセージを設定できます。これにより、ユーザーにわかりやすい日本語の案内を行うことができます。


@Email(message = "メールアドレスの形式が正しくありません")
private String email;

このようにすれば、初心者にも理解しやすいエラーメッセージを表示できます。

6. 他のアノテーションと組み合わせる使い方

@Emailは、単独で使うよりも@NotBlankや@Sizeと組み合わせて使うのがおすすめです。例えば、最大文字数を制限することで、不必要に長いメールアドレスの入力を防ぐことができます。


@NotBlank(message = "メールアドレスは必須です")
@Email(message = "メールアドレスの形式が正しくありません")
@Size(max = 100, message = "メールアドレスは100文字以内で入力してください")
private String email;

7. フロントエンドと組み合わせたバリデーション

Springの@Emailアノテーションはサーバーサイドでの検証ですが、フロントエンドのHTML5にもtype="email"を指定することで、入力チェックが可能です。サーバーとフロントの両方でチェックすることで、ユーザー体験が向上します。


<form action="/register" method="post">
    <label for="email">メールアドレス</label>
    <input type="email" id="email" name="email" required />
    <button type="submit">送信</button>
</form>

このように、Springの@EmailアノテーションとHTML5のemail入力タイプを組み合わせると、安全かつ便利なフォーム入力チェックが実現できます。