org.apache.struts.util
クラス PropertyMessageResources

java.lang.Object
  |
  +--org.apache.struts.util.MessageResources
        |
        +--org.apache.struts.util.PropertyMessageResources

すべての実装インタフェース:

java.io.Serializable

public class PropertyMessageResources

extends MessageResources

java.util.PropertyResourceBundle の規則に従った名称のプロパティリソースから メッセージキーと一致する文字列を読み込む MessageResources の具象サブクラスです。 base プロパティは、ベースとなるプロパティリソース名で、 必ず設定しなくてはなりません。

実装に関する注 - このクラスは全てのメッセージを 元のロケールも含む Locale 毎にキャッシュすることにより、 メモリを使用する代わりにスピードを得ています。 結果、固定のメッセージはメッセージキャッシュに1度以上ストアされてしまいますが、 同じ locale + key のアクセスに対する応答時間が向上します。

バージョン:

$Revision: 1.3 $ $Date: 2001/02/12 00:32:14 $

作成者:

Craig R. McClanahan

関連項目:

直列化された形式

フィールドの概要

protected java.util.HashMap	locales 既にロードされたメッセージに対するロケールキーの集合。
protected java.util.HashMap	messages 今までに蓄積したメッセージのキャッシュ。

クラス org.apache.struts.util.MessageResources から継承したフィールド

config, defaultFactory, defaultLocale, factory, formats, returnNull

コンストラクタの概要

PropertyMessageResources(MessageResourcesFactory factory, java.lang.String config)
指定されたパラメータに従って、新しい PropertyMessageResources を生成します。

PropertyMessageResources(MessageResourcesFactory factory, java.lang.String config, boolean returnNull)
指定されたパラメータに従って、新しい PropertyMessageResources を生成します。

メソッドの概要

java.lang.String	getMessage(java.util.Locale locale, java.lang.String key) キーで指定されたデフォルト Locale のテキストメッセージを返します。
protected void	loadLocale(java.lang.String localeKey) 指定された Locale キーに対応するメッセージをロードします。

クラス org.apache.struts.util.MessageResources から継承したメソッド

escape, getConfig, getFactory, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessage, getMessageResources, getReturnNull, isPresent, isPresent, localeKey, log, log, messageKey, messageKey, setReturnNull

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

locales

protected java.util.HashMap locales

既にロードされたメッセージに対するロケールキーの集合。 localeKey() により計算された値をキーとします。

messages

protected java.util.HashMap messages

今までに蓄積したメッセージのキャッシュ。messageKey() により計算された値を 関連付けられたメッセージのキャッシュ。

コンストラクタの詳細

PropertyMessageResources

public PropertyMessageResources(MessageResourcesFactory factory,
                                java.lang.String config)

指定されたパラメータに従って、新しい PropertyMessageResources を生成します。

パラメータ:

factory - 自身を生成する MessageResourcesFactory

config - MessageResources の設定パラメータ

PropertyMessageResources

public PropertyMessageResources(MessageResourcesFactory factory,
                                java.lang.String config,
                                boolean returnNull)

指定されたパラメータに従って、新しい PropertyMessageResources を生成します。

パラメータ:

factory - 自身を生成する MessageResourcesFactory

config - MessageResources の設定パラメータ

returnNull - returnNull プロパティの初期化条件

メソッドの詳細

getMessage

public java.lang.String getMessage(java.util.Locale locale,
                                   java.lang.String key)

キーで指定されたデフォルト Locale のテキストメッセージを返します。 指定されたキーまたは Locale に対して適切なメッセージが見つからない場合、 returnNull プロパティがセットされている場合には null の文字列が返され、それ以外の場合には適当なエラーメッセージが返されます。

このメソッドは具象サブクラスで実装されなくてはなりません。

定義:

クラス MessageResources 内の getMessage

パラメータ:

locale - リクエストされたメッセージのLocale、 システムのデフォルト Locale を使用する場合には null

key - 参照するメッセージのキー

loadLocale

protected void loadLocale(java.lang.String localeKey)

指定された Locale キーに対応するメッセージをロードします。 この実装では、 config プロパティは一連のプロパティリソース （このPropertyMessageResourcesを生成したクラスローダによってロードされる）のパッケージやリソースの （ピリオドで区切られた）完全修飾名を含まなければなりません。 これは java.util.PropertyResourceBundle クラスを利用するときに使用する名称のフォーマットと 全く同じです。

パラメータ:

localeKey - メッセージを取得する際の Locale キー