🧭 今回のテーマ
Struts2では validate() メソッド以外にも、XMLファイルに定義する形式でも入力チェックを実装できます。
本記事では、以下の内容を体系的に整理します。
- XMLによるバリデーションの定義方法
- メリット／デメリットと使い分け
-
input遷移との連携 - 実務で使う標準バリデータ（requiredstring / int / regex など）
-
short-circuit属性による最適化
📦 ファイル構成と命名ルール
Struts2のXMLバリデーションファイルは、対象Actionクラスと連動した命名規則に従います。
[Actionクラス名]-validation.xml
たとえば、LoginAction.java に対応するファイルは：
/src/.../login/Login-validation.xml
と配置される必要があります。
🛠️ 基本構文：requiredstring バリデータの例
<validators>
<field name="userId">
<field-validator type="requiredstring">
<message>ユーザーIDを入力してください</message>
</field-validator>
</field>
</validators>
この設定により、userId フィールドが未入力の場合、エラーメッセージが自動的に <s:fielderror /> タグ経由でJSPに表示されます。
🧰 よく使うバリデーター一覧
| バリデーター名 | 内容 |
|---|---|
requiredstring |
空文字・未入力のチェック |
int |
整数であるかの検証 |
date |
日付形式であるか（パターン指定可） |
regex |
正規表現で形式を検証 |
email |
Email形式の検証 |
⚡ short-circuit="true" で複数バリデーターの最適化
<field-validator type="requiredstring" short-circuit="true">
<message>ユーザーIDを入力してください</message>
</field-validator>
short-circuit="true" を指定することで、このバリデーションがNGなら以降のチェックをスキップ できます。
例えば「空文字の時点で正規表現チェックは不要」といった場合に使うと処理効率が上がります。
📥 input 遷移と連携する流れ
XMLバリデーションがエラーを返すと、Struts2は自動的に input 結果に遷移します。
<action name="login" class="LoginAction">
<result name="success">/userPortal.jsp</result>
<result name="input">/login.jsp</result>
</action>
JSP側で <s:fielderror /> を設置していれば、XMLで定義されたエラーメッセージが表示されるという仕組みです。
📦 実際のプロジェクト実装例（GitHub）
🔗 Login-validation.xml（GitHub）
👉 Login-validation.xml
🔗 login.jsp におけるエラーメッセージ表示
👉 login.jsp
<s:fielderror />
📘 今回のまとめ
| 項目 | 内容 |
|---|---|
| 記述場所 |
[Action名]-validation.xml に配置 |
| 遷移制御 | バリデーション失敗時は input 結果に遷移 |
| JSP |
<s:fielderror /> を設置してエラー表示 |
| 実務Tips |
short-circuit="true" で不要なチェックを回避 |
| validate()との違い | Javaコードに書かずに、宣言的にチェック可能 |
📝 補足Tips：正規表現など XML で困ったら？
実務では、XMLバリデータが期待通り動作しないケースも存在します（例：regexバリデーションで一部パターンが効かない）。
その場合は、Java側の validate() メソッドで柔軟に対応するのがオススメです。
🔽 実際の実装例（GitHub）
👉 LoginAction.java - L57〜L75：validate()による複雑なチェック
🧭 次回予告：Vol.9.4
次回は、複数フィールドにまたがるバリデーションや条件付きチェックなど、実務でよく出くわす「一工夫が必要なケース」 を深掘りします。
📗 前回記事
📘 Vol.9.2：【Struts2】入力チェックの実装編 〜 validate() / input遷移 / fielderrorタグを使いこなす 〜
📙 次回記事
【Vol.9.4】条件付きバリデーションと複数フィールド連動チェック編（仮）
🔎 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＆保守性を両立するハイブリッド構成 |