Struts 2入門（3）～バリデーションの仕組みを理解する（後編）～

作りながら学ぶJavaアプリケーションフレームワーク

プロパティファイルへの動的なメッセージ設定

　ここまでは、固定メッセージをプロパティファイルに設定してきました。しかし、Struts 2ではプレースホルダを利用して、動的にメッセージを設定することもできます。

　具体的には、前述のgetTextメソッドの引数に置換する文字列を指定し、動的にメッセージを参照します。例えば、プロパティファイルに次のような記述を行います。

プレースホルダを使用した例

fieldLabel.name=名前
fieldLabel.age=年齢
errors.required={0}を入力してください

　次のようにgetTextメソッドを記述すると、動的に置換されたメッセージを得ることができます。ちなみに、このサンプルは共通メッセージを統一して定義するという使い方の例にもなっています。

getTextの例

getText("errors.required", new String[]{ getText("fieldLabel.name") });
getText("errors.required", new String[]{ getText("fieldLabel.age") });

　また、getTextメソッドは次のようにプロパティファイル内にも記述できます。用途としては、グローバルなプロパティファイルを用いて共通の文字列を定義し、その参照をActionクラスごとのプロパティファイルで行うようなケースが考えられます。

プロパティファイル内のgetTextメソッドの例

errors.sample=${getText("AppName")}では、この機能は使用できません

XML定義ファイルでのgetText

　Struts 2では、設定ファイルにOGNL式が書けるようになっているので、getTextメソッドはバリデーション定義のXMLファイルにも適用できます。下記の例では、動的なパラメータを扱えるようになります。なおOGNL式でのリストは、プログラムでの表記と異なり、要素を{}で囲むように記述しますので注意してください。

XML定義ファイルでのgetText使用例

<validator type="requiredstring">
    <param name="fieldName">name</param>
    <message>${getText("errors.required",{getText("fieldLavel")})}</message>
</validator>

まとめ

　今回は、バリデーションロジックを自前で記述する方法と、メッセージをプロパティファイルを用いて管理する方法を解説しました。いかがでしたでしょうか。

　さて、前回から2回にわたってバリデーション、アクションの遷移、メッセージの変換を紹介しました。これらには共通点があります。それはすべて自動で処理されていること。自動で処理されるというのは、どういう仕組みなのか、次回はそのあたりを解説することにします。

参考資料

1. Apache Struts
2. Struts 2+Spring 2+Tiles+Acegi+iBatis+GWT+JUnit 4+JMockit でフルスタックJAVAフレームワーク
3. 【特集】実践サンプルで学ぶStruts 2 - 生まれ変わった定番フレームワークを徹底解説：マイコミジャーナル
4. (・ω・)Serendipity ::: Light in Moment
5. ぶろぐっぽいなんか
6. 「Practical Apache Struts 2 Web 2.0 Projects」（Ian Roughley 著、Apress、2007年11月）
7. 「StrutsによるWebアプリケーションスーパーサンプル第2版」（高安厚思、西川麗 著、ソフトバンク クリエイティブ、2007年3月）