JavaのSpringで使う@Sizeアノテーションを完全ガイド！初心者でもわかるバリデーション入門

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

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

@Sizeアノテーションは、JavaのBean Validation仕様で用意されているバリデーションのひとつで、Springフレームワークでもよく使われます。主に文字列やコレクション、配列などに対してサイズの範囲を制限するために利用されます。フォーム入力やAPIのリクエストパラメータに対して「文字数は何文字以上何文字以下」といった条件を簡単に付与できます。

2. 基本的な使い方

2. 基本的な使い方

@Sizeを使うときは、対象のフィールドにアノテーションを付け、最小値と最大値を指定します。指定方法はとてもシンプルです。

import jakarta.validation.constraints.Size;

public class UserForm {

    @Size(min = 2, max = 20)
    private String username;

    @Size(min = 8, max = 100)
    private String password;

    // getter setter 略
}

この例では、ユーザー名は2文字以上20文字以下、パスワードは8文字以上100文字以下に制限されています。

3. 実行例を確認しよう

3. 実行例を確認しよう

Spring BootアプリケーションでこのUserFormを使い、バリデーションを実行すると、条件を満たさない入力に対してエラーメッセージが返されます。

usernameが1文字のとき：
→ エラー：size must be between 2 and 20

passwordが5文字のとき：
→ エラー：size must be between 8 and 100

このように、ユーザーが入力した値が制約条件を満たさない場合、自動的にエラーが検出されます。

4. エラーメッセージをカスタマイズする方法

4. エラーメッセージをカスタマイズする方法

@Sizeアノテーションにはmessage属性を指定できます。これを使えば、より分かりやすいメッセージをユーザーに表示できます。

public class UserForm {

    @Size(min = 2, max = 20, message = "ユーザー名は2文字以上20文字以内で入力してください")
    private String username;

}

これにより、エラーメッセージが日本語で表示され、ユーザーにとって親切なフォームになります。

5. コレクションや配列でも利用可能

5. コレクションや配列でも利用可能

@Sizeは文字列だけでなく、リストや配列などにも適用できます。例えば、複数のタグを受け取る入力で「最低1個以上、最大5個まで」といった制限が可能です。

import java.util.List;
import jakarta.validation.constraints.Size;

public class TagForm {

    @Size(min = 1, max = 5, message = "タグは1つ以上5つ以下で入力してください")
    private List<String> tags;

}

このように、配列やリストに対しても簡単にルールを定義できます。

6. 他のバリデーションアノテーションとの併用

6. 他のバリデーションアノテーションとの併用

@Sizeアノテーションは、@NotNullや@NotBlankなどの他のアノテーションと組み合わせるとさらに効果的です。例えば、必須入力チェックと文字数制限を同時に行うことができます。

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;

public class CommentForm {

    @NotBlank(message = "コメントは必須です")
    @Size(max = 200, message = "コメントは200文字以内で入力してください")
    private String content;

}

この例では、コメントが未入力の場合は必須エラー、200文字を超えた場合は文字数エラーと、状況に応じて複数のチェックを実行できます。

7. Spring Bootでの実践的な使い方

7. Spring Bootでの実践的な使い方

Spring Bootでは、コントローラで@Validや@Validatedアノテーションを使うことで、自動的に@Sizeを含むバリデーションが実行されます。初心者でも簡単に入力チェックを導入できるのが大きな特徴です。

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

@Controller
public class UserController {

    @PostMapping("/register")
    public String register(@Valid UserForm form, BindingResult result) {
        if (result.hasErrors()) {
            return "registerForm";
        }
        return "success";
    }
}

このコードでは、フォーム送信時に自動的に@Sizeを含むチェックが走り、不正な値があればエラー画面に戻ります。

8. よくある注意点

8. よくある注意点

@Sizeを使うときの注意点として、null値には反応しない点があります。nullを禁止したい場合は必ず@NotNullや@NotBlankを併用してください。また、データベース側の制約（VARCHARの長さ制限など）と整合性を取ることも大切です。

さらに、入力フォームのUI側でも文字数制限を設けておくと、ユーザーが入力時点で気づけるので、より親切なアプリケーションになります。

9. @Sizeと正規表現の使い分け

9. @Sizeと正規表現の使い分け

文字数制限は@Sizeで簡単に実装できますが、例えば「半角英数字のみ」といった条件を追加したい場合は@Patternアノテーションを組み合わせます。これにより、形式チェックと文字数制御を両立させることができます。

実際の現場では、ユーザー名やパスワードのように複数の条件が組み合わさるケースが多いため、@Sizeをベースにしつつ必要に応じて他の制約も加えるのが一般的です。

まとめ

まとめ

JavaのSpringで利用される@Sizeアノテーションは、入力値の文字数やコレクションの要素数を柔軟に制御できる、とても実用的なバリデーション機能です。とくにフォーム入力の管理やAPIのリクエスト制御では、ユーザーが自由に入力する値に対して安全で正確なチェックを行うことが求められるため、@Sizeのような入力制約はアプリケーション品質を支える重要な要素となります。@Sizeアノテーションでは、最小文字数と最大文字数をシンプルに指定でき、メッセージのカスタマイズも容易で、ユーザーに対して分かりやすいフィードバックを返せる点が大きな利点です。また、文字列だけでなく、リストや配列などのコレクション型にも適用できるため、複数要素を持つ入力項目にも自然に使える汎用性があります。 さらに、@NotNull、@NotBlank、@Patternなどの他のバリデーションアノテーションと組み合わせることで、より高度な入力チェックを実現できるため、実務の多種多様な入力要件に柔軟に対応できます。たとえば、ユーザー名には「空は不可」「2〜20文字以内」「半角英数字のみ」といった複数の条件を付与することが一般的であり、これらを@Sizeと他のアノテーションで組み合わせることで、簡潔かつ明瞭なコードで強固なバリデーションを実装できます。また、Spring Bootのコントローラで@Validを使うだけで自動的に検証が働くため、開発者が複雑なチェック処理を自前で書く負担も大幅に軽減されます。 バリデーションエラー時にはBindingResultでエラー内容を取得し、フォーム画面に戻してユーザーに分かりやすいメッセージを表示することも容易です。この入力チェックの仕組みは、ユーザビリティ向上とアプリケーションの安全性を保つうえで欠かせない技術です。また、画面側での文字数カウンターやmaxlength属性などを併用することで、入力ミスを事前に防ぐUIを実装でき、サーバー側だけでなく、フロント側でも正しい制限を提供することができます。 以下では、@Sizeアノテーションの応用例として、複数の条件を組み合わせた実践的なフォームクラスを紹介します。

@Sizeアノテーションと他の制約を併用したサンプルコード

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Pattern;
import jakarta.validation.constraints.Size;

public class AccountForm {

    @NotBlank(message = "ユーザー名は必須です")
    @Size(min = 2, max = 20, message = "ユーザー名は2文字以上20文字以内で入力してください")
    @Pattern(regexp = "^[a-zA-Z0-9]+$", message = "ユーザー名は半角英数字のみ利用できます")
    private String username;

    @NotBlank(message = "パスワードは必須です")
    @Size(min = 8, max = 100, message = "パスワードは8文字以上100文字以内で入力してください")
    private String password;

}

このように@Sizeは、入力値の基本的な長さ制限を定義する中心的な役割を果たします。さらに、実務ではエラーメッセージの表示方法や、入力フォームへ戻す処理などとの連携も重要になります。Spring Bootの@Validアノテーションを使うだけで、フォーム送信のタイミングで自動的にチェックが走るため、開発者はコントローラに必要最低限のロジックを書くことで堅牢な入力管理を実現できます。 また、入力値の制限とデータベース側の制約（VARCHARの長さなど）は整合性を保つことが大切であり、データ保存時のエラーを防ぐうえでも非常に重要です。サーバー側とDB側の制約がずれていると、ユーザーが正常に入力したとしてもエラーが発生し、利用者に不親切な挙動となってしまいます。こうした点を意識しながら、アプリケーション全体で統一されたバリデーション設計を行うことが品質の安定へとつながります。 さらに、タグ入力など複数要素を扱う場面では、コレクションに対する@Sizeの適用が役立ちます。最低個数と最大個数を指定するだけで広い用途に対応できるため、入力内容を自然に制御しながら柔軟なフォーム設計が可能です。入力チェックの考え方を体系的に理解しておくことで、より実践的で安定したSpringアプリケーション開発が行えるようになります。