クラス LocaleChangeInterceptor

java.lang.ObjectSE
org.springframework.web.servlet.i18n.LocaleChangeInterceptor
実装されたすべてのインターフェース:
HandlerInterceptor

public class LocaleChangeInterceptor extends ObjectSE implements HandlerInterceptor
構成可能なリクエストパラメーター(デフォルトのパラメーター名: "locale" )を介して、リクエストごとに現在のロケールを変更できるインターセプター。
導入:
20.06.2003
作成者:
Juergen Hoeller, Rossen Stoyanchev
関連事項:
  • フィールドの詳細

    • DEFAULT_PARAM_NAME

      public static final StringSE DEFAULT_PARAM_NAME
      ロケール指定パラメーターのデフォルト名: "locale"。
      関連事項:
    • logger

      protected final Log logger
  • コンストラクターの詳細

    • LocaleChangeInterceptor

      public LocaleChangeInterceptor()
  • メソッドの詳細

    • setParamName

      public void setParamName(StringSE paramName)
      ロケール変更リクエストでロケール仕様を含むパラメーターの名前を設定します。デフォルトは「ロケール」です。
    • getParamName

      public StringSE getParamName()
      ロケール変更リクエストでロケール仕様を含むパラメーターの名前を返します。
    • setHttpMethods

      public void setHttpMethods(@Nullable StringSE... httpMethods)
      ロケールを変更できる HTTP メソッドを構成します。
      パラメーター:
      httpMethods - メソッド
      導入:
      4.2
    • getHttpMethods

      @Nullable public StringSE[] getHttpMethods()
      構成された HTTP メソッドを返します。
      導入:
      4.2
    • setIgnoreInvalidLocale

      public void setIgnoreInvalidLocale(boolean ignoreInvalidLocale)
      ロケールパラメーターの無効な値を無視するかどうかを設定します。
      導入:
      4.2.2
    • isIgnoreInvalidLocale

      public boolean isIgnoreInvalidLocale()
      ロケールパラメーターの無効な値を無視するかどうかを返します。
      導入:
      4.2.2
    • preHandle

      public boolean preHandle(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler) throws ServletExceptionEE
      インターフェースからコピーされた説明: HandlerInterceptor
      ハンドラーの実行前のインターセプトポイント。HandlerMapping が適切なハンドラーオブジェクトを決定した後、HandlerAdapter がハンドラーを呼び出す前に呼び出されます。

      DispatcherServlet は、任意の数のインターセプターで構成される実行チェーンでハンドラーを処理し、ハンドラー自体を最後に処理します。このメソッドを使用すると、各インターセプターはチェーンの実行を中止することを決定でき、通常は HTTP エラーを送信するか、カスタムレスポンスを作成します。

      注意 : 非同期リクエスト処理には特別な考慮事項が適用されます。詳細については、AsyncHandlerInterceptor を参照してください。

      デフォルトの実装は true を返します。

      次で指定:
      インターフェース HandlerInterceptorpreHandle 
      パラメーター:
      request - 現在の HTTP リクエスト
      response - 現在の HTTP レスポンス
      handler - 型および / またはインスタンス評価のために、実行するために選択されたハンドラー
      戻り値:
      実行チェーンが次のインターセプターまたはハンドラー自体を続行する必要がある場合は、true。そうでない場合、DispatcherServlet は、このインターセプターがすでにレスポンス自体を処理していると想定します。
      例外:
      ServletExceptionEE
    • parseLocaleValue

      @Nullable protected LocaleSE parseLocaleValue(StringSE localeValue)
      指定されたロケール値をリクエストパラメーターから取得したものとして解析します。

      デフォルトの実装は StringUtils.parseLocale(String) を呼び出し、Locale.toString() 形式と BCP 47 言語タグを受け入れます。

      パラメーター:
      localeValue - 解析するロケール値
      戻り値:
      対応する Locale インスタンス
      導入:
      4.3