クラス AbstractResourceBasedMessageSource
- 実装されたすべてのインターフェース:
HierarchicalMessageSource
,MessageSource
ResourceBundleMessageSource
や ReloadableResourceBundleMessageSource
などのリソースバンドル規則に基づく MessageSource
実装の抽象基本クラス。一般的な構成方法と対応するセマンティック定義を提供します。- 導入:
- 4.3
- 作成者:
- Juergen Hoeller
- 関連事項:
フィールドのサマリー
クラス org.springframework.context.support.MessageSourceSupport から継承されたフィールド
logger
コンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明void
addBasenames
(StringSE... basenames) 指定されたベース名を既存のベース名構成に追加します。登録順にエントリを含む、このMessageSource
のベース名セットを返します。protected long
ロードされたプロパティファイルをキャッシュするミリ秒数を返します。プロパティファイルの解析に使用するデフォルトの文字セットを返します(ある場合)。フォールバックするデフォルトのロケールを決定します。ローカルで指定されたデフォルトのロケールまたはシステムのロケール、またはフォールバックロケールがない場合はnull
のいずれかです。protected boolean
使用すべきではありません。void
setBasename
(StringSE basename) ファイル拡張子または言語コードを指定しないという基本的な ResourceBundle 規則に従って、単一のベース名を設定します。void
setBasenames
(StringSE... basenames) ファイル名または言語コードを指定しないという基本的な ResourceBundle 規則に従って、ベース名の配列を設定します。void
setCacheMillis
(long cacheMillis) ロードされたプロパティファイルをキャッシュするミリ秒数を設定します。void
setCacheSeconds
(int cacheSeconds) ロードされたプロパティファイルをキャッシュする秒数を設定します。void
setDefaultEncoding
(@Nullable StringSE defaultEncoding) プロパティファイルの解析に使用するデフォルトの文字セットを設定します。void
setDefaultLocale
(@Nullable LocaleSE defaultLocale) システムのロケールにフォールバックする代わりに、フォールバックするデフォルトのロケールを指定します。void
setFallbackToSystemLocale
(boolean fallbackToSystemLocale) 特定のロケールのファイルが見つからなかった場合にシステムのロケールにフォールバックするかどうかを設定します。クラス org.springframework.context.support.AbstractMessageSource から継承されたメソッド
getCommonMessages, getDefaultMessage, getDefaultMessage, getMessage, getMessage, getMessage, getMessageFromParent, getMessageInternal, getParentMessageSource, isUseCodeAsDefaultMessage, resolveArguments, resolveCode, resolveCodeWithoutArguments, setCommonMessages, setParentMessageSource, setUseCodeAsDefaultMessage
クラス org.springframework.context.support.MessageSourceSupport から継承されたメソッド
createMessageFormat, formatMessage, isAlwaysUseMessageFormat, renderDefaultMessage, setAlwaysUseMessageFormat
コンストラクターの詳細
AbstractResourceBasedMessageSource
public AbstractResourceBasedMessageSource()
メソッドの詳細
setBasename
ファイル拡張子または言語コードを指定しないという基本的な ResourceBundle 規則に従って、単一のベース名を設定します。リソースの場所の形式は、特定のMessageSource
実装までです。通常のプロパティファイルと XML プロパティファイルがサポートされています。たとえば、"messages" では、"messages.properties"、"messages_en.properties" などの配置が検索されるほか、"messages.xml"、"messages_en.xml" なども検索されます。
- パラメーター:
basename
- 単一のベースネーム- 関連事項:
setBasenames
ファイル名または言語コードを指定しないという基本的な ResourceBundle 規則に従って、ベース名の配列を設定します。リソースの場所の形式は、特定のMessageSource
実装までです。通常のプロパティファイルと XML プロパティファイルがサポートされています。たとえば、"messages" では、"messages.properties"、"messages_en.properties" などの配置が検索されるほか、"messages.xml"、"messages_en.xml" なども検索されます。
関連するリソースバンドルは、メッセージコードを解決するときに順次チェックされます。順次ルックアップのため、 前のリソースバンドルのメッセージ定義は、後のバンドルのメッセージ定義をオーバーライドすることに注意してください。
メモ:
addBasenames(java.lang.String...)
とは対照的に、これは既存のエントリを指定された名前に置き換えます。構成をリセットするためにも使用できます。- パラメーター:
basenames
- ベース名の配列- 関連事項:
addBasenames
指定されたベース名を既存のベース名構成に追加します。メモ: 指定されたベース名がすでに存在する場合、そのエントリの位置は元のセットのままです。リストの最後に新しいエントリが追加され、既存のベース名の後に検索されます。
- 導入:
- 4.3
- 関連事項:
getBasenameSet
setDefaultEncoding
プロパティファイルの解析に使用するデフォルトの文字セットを設定します。ファイルにファイル固有の文字セットが指定されていない場合に使用されます。有効なデフォルトは、
java.util.Properties
のデフォルトのエンコーディング: ISO-8859-1 です。null
値は、プラットフォームのデフォルトのエンコーディングを示します。クラシックプロパティファイルにのみ適用され、XML ファイルには適用されません。
- パラメーター:
defaultEncoding
- デフォルトの文字セット
getDefaultEncoding
setFallbackToSystemLocale
public void setFallbackToSystemLocale(boolean fallbackToSystemLocale) 特定のロケールのファイルが見つからない場合に、システムロケールにフォールバックするかどうかを設定します。デフォルトは "true" です。これをオフにすると、フォールバックはデフォルトファイルのみになります (たとえば、ベース名 "messages" の場合は "messages.properties" )。システムロケールにフォールバックするのが
java.util.ResourceBundle
のデフォルトの動作です。ただし、システムロケールがアプリケーションにまったく関係ないアプリケーションサーバー環境では、これは望ましくないことがよくあります。このようなシナリオでは、このフラグを "false" に設定してください。- 関連事項:
isFallbackToSystemLocale
使用すべきではありません。特定のロケールのファイルが見つからなかった場合に、システムロケールにフォールバックするかどうかを返します。- 導入:
- 4.3
setDefaultLocale
システムのロケールにフォールバックする代わりに、フォールバックするデフォルトのロケールを指定します。デフォルトでは、システムのロケールにフォールバックします。ここでローカルに指定されたデフォルトのロケールでこれをオーバーライドするか、
"fallbackToSystemLocale"
を無効にすることでフォールバックロケールを強制しないことができます。- 導入:
- 5.2.2
- 関連事項:
getDefaultLocale
setCacheSeconds
public void setCacheSeconds(int cacheSeconds) ロードされたプロパティファイルをキャッシュする秒数を設定します。- デフォルトは "-1" で、永久にキャッシュすることを示します(
java.util.ResourceBundle
のデフォルトの動作と一致します)。この定数はResourceBundle.Control.getTimeToLive(java.lang.String, java.util.Locale)
SE ではなく Spring の規則に従っていることに注意してください。 - 正の数は、指定された秒数の間、ロードされたプロパティファイルをキャッシュします。これは基本的に、リフレッシュチェックの間隔です。リフレッシュ試行では、実際にファイルを再ロードする前に、ファイルの最終変更タイムスタンプを最初に確認することに注意してください。ファイルが変更されない場合、リフレッシュの試行は実際には再ロードされないため、この間隔はかなり低く設定できます。
- "0" の値は、すべてのメッセージアクセスでファイルの最終変更タイムスタンプをチェックします。 本番環境では使用しないでください。
ClassLoader によっては、ClassLoader がキャッシュされたバージョンのバンドルファイルを保持する可能性があるため、有効期限が確実に機能しない場合があります。このようなシナリオでは、クラスパス以外の場所と組み合わせて、
ResourceBundleMessageSource
よりReloadableResourceBundleMessageSource
を優先します。- デフォルトは "-1" で、永久にキャッシュすることを示します(
setCacheMillis
public void setCacheMillis(long cacheMillis) ロードされたプロパティファイルをキャッシュするミリ秒数を設定します。代わりに秒を設定するのが一般的であることに注意してください:setCacheSeconds(int)
。- デフォルトは "-1" で、永久にキャッシュすることを示します(
java.util.ResourceBundle
のデフォルトの動作と一致します)。この定数はResourceBundle.Control.getTimeToLive(java.lang.String, java.util.Locale)
SE ではなく Spring の規則に従っていることに注意してください。 - 正の数は、指定されたミリ秒数の間、ロードされたプロパティファイルをキャッシュします。これは基本的に、リフレッシュチェックの間隔です。リフレッシュ試行では、実際にファイルを再ロードする前に、ファイルの最終変更タイムスタンプを最初に確認することに注意してください。ファイルが変更されない場合、リフレッシュの試行は実際には再ロードされないため、この間隔はかなり低く設定できます。
- "0" の値は、すべてのメッセージアクセスでファイルの最終変更タイムスタンプをチェックします。 本番環境では使用しないでください。
- 導入:
- 4.3
- 関連事項:
- デフォルトは "-1" で、永久にキャッシュすることを示します(
getCacheMillis
protected long getCacheMillis()ロードされたプロパティファイルをキャッシュするミリ秒数を返します。- 導入:
- 4.3
getDefaultLocale()
を推奨