💡 はじめに
Struts2のバリデーション処理では、エラーメッセージの表示方法を工夫することで「保守性」「再利用性」「多言語対応」の向上が図れます。
本記事では、ActionMessages.propertiesなどのメッセージリソースファイルを使って、バリデーションエラーメッセージを外部化・i18n対応する方法を解説します！
🏗 バリデーション × プロパティファイル の基本構成
Struts2では以下のように、プロパティファイルにエラーメッセージを記述して、Java側またはXML側から呼び出します。
📁 ファイル構成例
src/
└── main/
└── resources/
└── com/company/bulletinboard/action/login/LoginAction.properties
📝 LoginAction.properties
errors.required.username = ユーザー名は必須入力です。
errors.invalid.username = ユーザー名の形式が不正です。
🧩 Java側：validate()での使用
@Override
public void validate() {
if (username == null || username.isEmpty()) {
addFieldError("username", getText("errors.required.username"));
}
}
✅ getText() とは？
-
Struts2が提供する国際化対応のメソッド
-
メッセージプロパティファイルからキーに対応する文言を取得します
-
言語ファイルの切り替えも可能（例：LoginAction_en.properties）
🧩 XML側：バリデーション定義での使用
<field name="username">
<field-validator type="requiredstring">
<message key="errors.required.username"/>
</field-validator>
</field>
-
messageタグのkey属性でメッセージリソースを参照 -
Java側と同様に外部化・i18nが可能！
🌍 多言語対応（i18n）の設定例
# LoginAction.properties（デフォルト＝日本語）
errors.required.username = ユーザー名は必須入力です。
# LoginAction_en.properties（英語）
errors.required.username = Username is required.
Struts2は、リクエストヘッダーの Accept-Language を見て自動的にファイルを切り替えます。
🧑💻 実際のGitHub実装例（Login画面）
🔗 LoginAction.java - L57〜L75
🔗 LoginAction.properties（必須メッセージ）
📝 Tips：BaseActionなど共通クラスでも getText() は使用可能！
共通処理クラス（例：BaseAction）で getText() を使えば、エラー共通処理やログ出力にも柔軟にメッセージを適用できます！
logger.warn(getText("errors.session.timeout"));
✅ まとめ
| 項目 | 内容 |
|---|---|
| 🔑 メリット① | エラーメッセージを一元管理でき、保守性が高まる |
| 🌐 メリット② | 多言語対応（i18n）に自然と対応可能 |
| 🔁 メリット③ | 同じキーを複数のActionで再利用できる |
🧭 次回予告：Vol.9.7
次回は、バリデーションエラー時のフィールド保持・初期値再表示の工夫について紹介予定です！
✨ シリーズまとめ（Vol.9.x バリデーション編）
-
🆕 Vol.9.6：（←今回）