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

生徒

「Springの入力チェックで@Futureというアノテーションを見たんですが、これはどんなときに使うんですか？」

先生

「@Futureは、入力された日付が必ず未来の日付であることを保証するためのアノテーションです。過去や今日の日付が入力されるのを防げますよ。」

生徒

「なるほど！予約日や締め切り日のように必ず未来でないと困る場面で使えるんですね。」

先生

「その通りです。実際のコード例を見ながら理解を深めていきましょう。」

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

@Futureアノテーションは、Jakarta Bean Validationに含まれる日付チェック用の機能で、指定したフィールドの値が未来の日付であることを検証します。Spring BootやSpring MVCの入力フォームやAPIのリクエストで使われ、ユーザーが過去や現在を指定してしまうのを防止できます。

例えば予約システムで「今日より前の日付に予約できてしまう」といった不具合を防げるので、信頼性の高いアプリケーションを作るために非常に重要です。

2. 基本的な使い方

まずはシンプルなサンプルコードを見てみましょう。ここではイベントの開催日が必ず未来であることを保証します。


import jakarta.validation.constraints.Future;
import java.time.LocalDate;

public class EventForm {
    @Future(message = "開催日は未来の日付を指定してください")
    private LocalDate eventDate;

    public EventForm(LocalDate eventDate) {
        this.eventDate = eventDate;
    }

    public LocalDate getEventDate() {
        return eventDate;
    }
}

この例では、今日や過去の日付を入力するとバリデーションエラーになります。未来の日付だけが受け付けられるようになります。

3. Spring MVCでの利用例

Spring MVCでは、@Validや@Validatedを組み合わせることで自動的にバリデーションが実行されます。


import org.springframework.stereotype.Controller;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/event")
public class EventController {

    @PostMapping("/create")
    @ResponseBody
    public String create(@Validated @RequestBody EventForm form) {
        return "登録された開催日: " + form.getEventDate();
    }
}

もしユーザーが過去の日付を送信した場合、自動的にエラーとなり正しい未来日だけを受け付けられるようになります。

4. @Futureと@FutureOrPresentの違い

@Futureは必ず未来の日付のみを許可しますが、@FutureOrPresentは未来または現在の日付を許可します。

例えば「予約日は必ず明日以降」という場合は@Futureを使い、「申請日は今日を含めて未来ならOK」という場合には@FutureOrPresentを使うのが適切です。

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

エラーメッセージはプロパティファイルで共通化すると便利です。以下のように設定すると、全体のアプリで同じメッセージを再利用できます。


Future.eventForm.eventDate=開催日は未来の日付を入力してください

こうすることで、メッセージの変更も一括で管理でき、メンテナンス性が向上します。

6. 他のバリデーションとの組み合わせ

@Futureは@NotNullや@Sizeなどと組み合わせるケースが多いです。必須入力であり、かつ未来の日付のみを許可するという制御ができます。


import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Future;
import java.time.LocalDate;

public class Reservation {
    @NotNull
    @Future(message = "予約日は未来の日付を指定してください")
    private LocalDate reserveDate;
}

これにより「入力必須かつ未来の日付」という条件をシンプルに表現できます。