🧭 はじめに
Struts2では required や regex などの標準バリデータを使って
XMLやJavaでバリデーションを簡単に定義できます。
しかし、以下のような 複雑なチェックや複数画面での使い回し をしたい場合、
「独自バリデータ（Custom FieldValidator）」 を作成するのがベストです。
✅ 独自バリデータが必要になる場面
| パターン | 解説 |
|---|---|
| 特定形式の文字列チェック（例：社員番号、電話番号など） | 他の画面でも使い回したい |
| 条件付きチェック（ある値のときだけ制限をかけたい） |
validate() だけだと画面ごとに書く必要がある |
| 画面ごとに同じルールを書いていて保守がつらい | バリデーション処理を共通化したい |
🛠 カスタムバリデータ作成の流れ
-
1.
FieldValidatorSupportを継承したJavaクラスを作る -
2.
validate()メソッド内でロジックを記述 -
3.
validators.xmlまたは -validation.xmlで定義して使う
✍ 実装例：AlphanumericValidator.java（英数字チェック）
① Javaクラスの作成
public class AlphanumericValidator extends FieldValidatorSupport {
@Override
public void validate(Object object) throws ValidationException {
String fieldName = getFieldName();
String value = (String) getFieldValue(fieldName, object);
if (value != null && !value.matches("^[a-zA-Z0-9]+$")) {
addFieldError(fieldName, object);
}
}
}
② validators.xml に登録
src/validators.xml（共通で使えるように設定）
<!DOCTYPE validators PUBLIC
"-//OpenSymphony Group//XWork Validator Config 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-validator-config-1.0.dtd">
<validators>
<validator name="alphanumeric" class="com.company.bulletinboard.validator.AlphanumericValidator"/>
</validators>
③ 使用側の validation.xml にて呼び出し
<field name="userId">
<field-validator type="alphanumeric">
<message>ユーザーIDは英数字のみで入力してください。</message>
</field-validator>
</field>
💡 使い回しのTips
| ポイント | 解説 |
|---|---|
validators.xml に登録すれば全体で利用可能 |
どのActionでもtype="xxx" で呼び出せる |
| 複数のバリデータに共通ロジックがあるなら基底クラス化もあり | DRY原則を意識して構成可能 |
| テストしやすい構造にしておくと将来メンテしやすい | 単体テスト or Validator単体のJUnit化も視野に |
🎯 まとめ
-
カスタムバリデータを使えば、複雑なチェックや再利用性の高いルールも1つに集約できる
-
XMLベースで呼び出せるため、従来の
validate()との併用もOK -
validators.xmlで一元管理することで、プロジェクト全体で使える資産に
🧭 次回予告：Vol.9.9
次回は、バリデーション処理の「単体テスト」 について解説します！
-
validate()のテスト -
独自バリデータの
JUnitテスト -
エラー発生時の挙動確認（input 遷移、メッセージ表示）
Struts2におけるバリデーションの品質を保つためのヒントをお届けします！
✨ シリーズまとめ（Vol.9.x バリデーション編）
🔎 Vol.9系で扱うトピック
| 回 | テーマ | 内容の一部紹介 |
|---|---|---|
| 9.1 |
validate()メソッドの基本 |
Struts2標準の入力チェック基礎 |
| 9.2 |
@Validations アノテーション活用 |
宣言的バリデーション設計 |
| 9.3 |
validation.xml 外部定義でのバリデーション |
大規模PJでのメンテナンス性 |
| 9.4 |
conversion.properties と型変換 |
日付/数値/Enum変換の実務対応 |
| 9.5 | 入力エラー時のメッセージ制御 |
addFieldError() / メッセージキー運用 |
| 9.6 | バリデーション共通化 | 共通部品によるDRY設計 |
| 9.7 | サーバサイドとクライアントサイドの協調 | jQueryやHTML5との併用戦略 |
| 9.8 | 実務シナリオでのバリデーション総仕上げ | 会員登録/投稿処理などの実例適用 |
| 9.9 | バリデーション処理の単体テスト編 | validate()／独自バリデータ／input遷移の検証を網羅的に |
| 9.10 | エラー表示のUIデザイン編 | 視認性・操作性を高める実践テクニック |
| 9.11 | Ajax×バリデーション連携編 | クライアント×サーバーで UX＆保守性を両立するハイブリッド構成 |
--