コンストラクターの詳細

• AbstractMessageSource

  public AbstractMessageSource()

メソッドの詳細

• setParentMessageSource

  public void setParentMessageSource(@Nullable
                                     MessageSource parent)

  インターフェースからコピーされた説明: HierarchicalMessageSource
  このオブジェクトが解決できないメッセージを解決しようとするために使用される親を設定します。

  次で指定:

  インターフェース HierarchicalMessageSource の setParentMessageSource 

  パラメーター:

  parent - このオブジェクトが解決できないメッセージを解決するために使用される親 MessageSource null の場合があり、その場合、それ以上の解決は不可能です。

• getParentMessageSource

  @Nullable
  public MessageSource getParentMessageSource()

  インターフェースからコピーされた説明: HierarchicalMessageSource
  この MessageSource の親、または存在しない場合は null を返します。

  次で指定:

  インターフェース HierarchicalMessageSource の getParentMessageSource 

• setCommonMessages

  public void setCommonMessages(@Nullable
                                java.util.Properties commonMessages)

  ロケールに依存しない共通メッセージを指定します。メッセージコードをキーとして、メッセージストリング全体（引数プレースホルダーを含む場合があります）を値として使用します。

  外部で定義された Properties オブジェクト（例: PropertiesFactoryBean によって定義されます。

• getCommonMessages

  @Nullable
  protected java.util.Properties getCommonMessages()

  ロケールに依存しない共通メッセージがあれば、それを定義する Properties オブジェクトを返します。

• setUseCodeAsDefaultMessage

  public void setUseCodeAsDefaultMessage(boolean useCodeAsDefaultMessage)

  NoSuchMessageException をスローする代わりに、メッセージコードをデフォルトメッセージとして使用するかどうかを設定します。開発とデバッグに役立ちます。デフォルトは "false" です。

  メモ: 親 MessageSource を持っている（FieldError のような）複数のコードと MessageSourceResolvable と MessageSource の場合は、 親に "useCodeAsDefaultMessage" を活性化しません : それ以外の場合は、親からメッセージとして返された最初のコードを取得しますが、それ以上のコードをチェックすることはありません。

  親で "useCodeAsDefaultMessage" をオンにして作業できるように、AbstractMessageSource および AbstractApplicationContext には、使用可能な場合は内部 getMessageInternal(java.lang.String, java.lang.Object[], java.util.Locale) メソッドに委譲するための特別なチェックが含まれています。一般的には、開発中に "useCodeAsDefaultMessage" を使用することをお勧めしますが、そもそも本番環境では使用しないでください。

  関連事項:

  getMessage(String, Object[], Locale), FieldError

• isUseCodeAsDefaultMessage

  protected boolean isUseCodeAsDefaultMessage()

  NoSuchMessageException をスローする代わりに、デフォルトメッセージとしてメッセージコードを使用するかどうかを返します。開発とデバッグに役立ちます。デフォルトは "false" です。

  または、getDefaultMessage(org.springframework.context.MessageSourceResolvable, java.util.Locale) メソッドをオーバーライドして、解決できないコードのカスタムフォールバックメッセージを返すことを検討してください。

  関連事項:

  getDefaultMessage(String)

• getMessage

  public final java.lang.String getMessage(java.lang.String code,
                                           @Nullable
                                           java.lang.Object[] args,
                                           @Nullable
                                           java.lang.String defaultMessage,
                                           java.util.Locale locale)

  インターフェースからコピーされた説明: MessageSource
  メッセージの解決を試みます。メッセージが見つからなかった場合、デフォルトのメッセージを返します。

  次で指定:

  インターフェース MessageSource の getMessage 

  パラメーター:

  code - "calculator.noRateSet" などのルックアップするコード。このクラスのユーザーは、関連する完全修飾クラス名に基づいてメッセージ名を作成することをお勧めします。これにより、競合を回避し、最大限の明確性を確保できます。

  args - メッセージ内のパラメーター（パラメーターはメッセージ内の "{0}", "{1,date}", "{2,time}" のように見える）に入力される引数の配列。存在しない場合は null。

  defaultMessage - ルックアップが失敗した場合に返すデフォルトのメッセージ

  locale - ルックアップを行うロケール

  戻り値:

  検索が成功した場合、解決されたメッセージ。それ以外の場合、パラメーターとして渡されるデフォルトメッセージ

  関連事項:

  MessageFormat

• getMessage

  public final java.lang.String getMessage(java.lang.String code,
                                           @Nullable
                                           java.lang.Object[] args,
                                           java.util.Locale locale)
                                    throws NoSuchMessageException

  インターフェースからコピーされた説明: MessageSource
  メッセージの解決を試みます。メッセージが見つからない場合はエラーとして扱います。

  次で指定:

  インターフェース MessageSource の getMessage 

  パラメーター:

  code - "calculator.noRateSet" などのルックアップするコード

  args - メッセージ内のパラメーター（パラメーターはメッセージ内の "{0}", "{1,date}", "{2,time}" のように見える）に入力される引数の配列。存在しない場合は null。

  locale - ルックアップを行うロケール

  戻り値:

  解決されたメッセージ

  例外:

  NoSuchMessageException - メッセージが見つからなかった場合

  関連事項:

  MessageFormat

• getMessage

  public final java.lang.String getMessage(MessageSourceResolvable resolvable,
                                           java.util.Locale locale)
                                    throws NoSuchMessageException

  インターフェースからコピーされた説明: MessageSource
  渡された MessageSourceResolvable 引数内に含まれるすべての属性を使用して、メッセージの解決を試みます。

  NOTE: このメソッドを呼び出す時点で、解決可能なオブジェクトの defaultMessage プロパティが null であるかどうかを判断できないため、このメソッドで NoSuchMessageException をスローする必要があります。

  次で指定:

  インターフェース MessageSource の getMessage 

  パラメーター:

  resolvable - メッセージの解決に必要な属性を格納する値オブジェクト

  locale - ルックアップを行うロケール

  戻り値:

  解決されたメッセージ

  例外:

  NoSuchMessageException - メッセージが見つからなかった場合

  関連事項:

  MessageFormat

• getMessageInternal

  @Nullable
  protected java.lang.String getMessageInternal(@Nullable
                                                          java.lang.String code,
                                                          @Nullable
                                                          java.lang.Object[] args,
                                                          @Nullable
                                                          java.util.Locale locale)

  指定されたロケールでメッセージとして指定されたコードと引数を解決し、見つからない場合は null を返します。デフォルトメッセージとしてコードにフォールバックしません。getMessage メソッドによって呼び出されます。

  パラメーター:

  code - "calculator.noRateSet" などのルックアップするコード

  args - メッセージ内のパラメーター用に入力される引数の配列

  locale - ルックアップを行うロケール

  戻り値:

  解決されたメッセージ、または見つからない場合は null 

  関連事項:

  getMessage(String, Object[], String, Locale), getMessage(String, Object[], Locale), getMessage(MessageSourceResolvable, Locale), setUseCodeAsDefaultMessage(boolean)

• getMessageFromParent

  @Nullable
  protected java.lang.String getMessageFromParent(java.lang.String code,
                                                            @Nullable
                                                            java.lang.Object[] args,
                                                            java.util.Locale locale)

  指定されたメッセージを親 MessageSource から取得しようとします（存在する場合）。

  パラメーター:

  code - "calculator.noRateSet" などのルックアップするコード

  args - メッセージ内のパラメーター用に入力される引数の配列

  locale - ルックアップを行うロケール

  戻り値:

  解決されたメッセージ、または見つからない場合は null 

  関連事項:

  getParentMessageSource()

• getDefaultMessage

  @Nullable
  protected java.lang.String getDefaultMessage(MessageSourceResolvable resolvable,
                                                         java.util.Locale locale)

  指定された MessageSourceResolvable のデフォルトメッセージを取得します。

  この実装は、使用可能な場合はデフォルトメッセージを完全にレンダリングします。プライマリメッセージコードがデフォルトメッセージとして使用されている場合は、プレーンなデフォルトメッセージ String を返します。

  パラメーター:

  resolvable - デフォルトのメッセージを解決する値オブジェクト

  locale - 現在のロケール

  戻り値:

  デフォルトのメッセージ、または存在しない場合は null 

  導入:

  4.3.6

  関連事項:

  MessageSourceSupport.renderDefaultMessage(String, Object[], Locale), getDefaultMessage(String)

• getDefaultMessage

  @Nullable
  protected java.lang.String getDefaultMessage(java.lang.String code)

  指定されたコードのフォールバックデフォルトメッセージがあれば、それを返します。

  デフォルトでは、"useCodeAsDefaultMessage" がアクティブになっている場合はコード自体を返すか、他のフォールバックを返しません。フォールバックがない場合、呼び出し元は通常 getMessage から NoSuchMessageException を受け取ります。

  パラメーター:

  code - 解決できず、明示的なデフォルトメッセージを受信しなかったメッセージコード

  戻り値:

  使用するデフォルトのメッセージ、または存在しない場合は null 

  関連事項:

  setUseCodeAsDefaultMessage(boolean)

• resolveArguments

  protected java.lang.Object[] resolveArguments(@Nullable
                                                java.lang.Object[] args,
                                                java.util.Locale locale)

  指定されたオブジェクトの配列を検索し、MessageSourceResolvable オブジェクトを見つけて解決します。

  メッセージに引数として MessageSourceResolvables を含めることができます。

  オーバーライド:

  クラス MessageSourceSupport の resolveArguments 

  パラメーター:

  args - メッセージの引数の配列

  locale - 解決するロケール

  戻り値:

  MessageSourceResolvables が解決された引数の配列

• resolveCodeWithoutArguments

  @Nullable
  protected java.lang.String resolveCodeWithoutArguments(java.lang.String code,
                                                                   java.util.Locale locale)

  サブクラスはこのメソッドをオーバーライドして、引数なしで最適化された方法でメッセージを解決できます。つまり、MessageFormat を使用せずに解決できます。

  デフォルトの実装では、resolveCode(java.lang.String, java.util.Locale) メソッドに委譲することにより、MessageFormat を使用します。サブクラスでは、これを最適化された解決に置き換えることをお勧めします。

  残念ながら、java.text.MessageFormat は効率的な方法で実装されていません。特に、そもそもメッセージパターンに引数プレースホルダーが含まれていないことを検出しません。引数のないメッセージの場合は MessageFormat を回避することをお勧めします。

  パラメーター:

  code - 解決するメッセージのコード

  locale - コードを解決するロケール (サブクラスは国際化をサポートすることが推奨されます)

  戻り値:

  メッセージ文字列、または見つからない場合は null 

  関連事項:

  resolveCode(java.lang.String, java.util.Locale), MessageFormat

• resolveCode

  @Nullable
  protected abstract java.text.MessageFormat resolveCode(java.lang.String code,
                                                                   java.util.Locale locale)

  サブクラスは、メッセージを解決するためにこのメソッドを実装する必要があります。

  サブクラスで MessageFormats を適切にキャッシュできるように、メッセージ文字列ではなく MessageFormat インスタンスを返します。

  サブクラスは、MessageFormat を含まない、引数のないメッセージの最適化された解決を提供することが推奨されます。詳細については、resolveCodeWithoutArguments(java.lang.String, java.util.Locale) javadoc を参照してください。

  パラメーター:

  code - 解決するメッセージのコード

  locale - コードを解決するロケール (サブクラスは国際化をサポートすることが推奨されます)

  戻り値:

  メッセージの MessageFormat。見つからない場合は null 

  関連事項:

  resolveCodeWithoutArguments(String, java.util.Locale)