インターフェース LocaleResolver

すべての既知のサブインターフェース:
LocaleContextResolver
すべての既知の実装クラス:
AbstractLocaleContextResolver, AbstractLocaleResolver, AcceptHeaderLocaleResolver, CookieLocaleResolver, FixedLocaleResolver, SessionLocaleResolver
public interface LocaleResolver
リクエストを介したロケール解決と、リクエストとレスポンスを介したロケール変更の両方を可能にする Web ベースのロケール解決戦略のインターフェース。

このインターフェースでは、リクエスト、セッション、Cookie などに基づく実装が可能です。デフォルトの実装は AcceptHeaderLocaleResolver で、それぞれの HTTP ヘッダーによって提供されるリクエストのロケールを使用するだけです。

RequestContext.getLocale() を使用して、実際の解決戦略に関係なく、コントローラーまたはビューで現在のロケールを取得します。

メモ: Spring 4.0 の時点で、LocaleContextResolver と呼ばれる拡張戦略インターフェースがあり、関連するタイムゾーン情報を含む可能性のある LocaleContext オブジェクトの解決が可能です。Spring が提供するリゾルバーの実装は、必要に応じて拡張 LocaleContextResolver インターフェースを実装します。

導入:
27.02.2003
作成者:
Juergen Hoeller
関連事項:

  • 方法の概要

    修飾子と型
    メソッド
    説明
    LocaleSE
    resolveLocale(jakarta.servlet.http.HttpServletRequest request)
    指定されたリクエストを介して現在のロケールを解決します。
    void
    setLocale(jakarta.servlet.http.HttpServletRequest request, @Nullable jakarta.servlet.http.HttpServletResponse response, @Nullable LocaleSE locale)
    現在のロケールを指定されたロケールに設定します。

  • メソッドの詳細

    • resolveLocale

      LocaleSE resolveLocale(jakarta.servlet.http.HttpServletRequest request)
      指定されたリクエストを介して現在のロケールを解決します。

      いずれの場合も、デフォルトのロケールをフォールバックとして返すことができます。

      パラメーター:
      request - ロケールを解決するためのリクエスト
      戻り値:
      現在のロケール (非 null)

    • setLocale

      void setLocale(jakarta.servlet.http.HttpServletRequest request, @Nullable jakarta.servlet.http.HttpServletResponse response, @Nullable LocaleSE locale)
      現在のロケールを指定されたロケールに設定します。
      パラメーター:
      request - ロケール変更に使用されるリクエスト
      response - ロケール変更に使用されるレスポンス
      locale - 新しいロケール、またはロケールをクリアする null 
      例外:
      UnsupportedOperationExceptionSE - LocaleResolver 実装がロケールの動的変更をサポートしていない場合