クラス SessionLocaleResolver

メソッドの詳細

• setLocaleAttributeName

  public void setLocaleAttributeName(StringSE localeAttributeName)

  HttpSession の対応する属性の名前を指定し、現在の LocaleSE 値を保持します。

  デフォルトは内部 LOCALE_SESSION_ATTRIBUTE_NAME です。

  導入:

  4.3.8

• setTimeZoneAttributeName

  public void setTimeZoneAttributeName(StringSE timeZoneAttributeName)

  HttpSession の対応する属性の名前を指定し、現在の TimeZoneSE 値を保持します。

  デフォルトは内部 TIME_ZONE_SESSION_ATTRIBUTE_NAME です。

  導入:

  4.3.8

• setDefaultLocaleFunction

  public void setDefaultLocaleFunction(FunctionSE<HttpServletRequestEE,LocaleSE> defaultLocaleFunction)

  LocaleSE セッション属性が見つからない場合に呼び出される、指定されたリクエストのデフォルトロケールを決定するために使用される関数を設定します。

  デフォルトの実装は、構成されたデフォルトのロケールを返します（存在する場合）。それ以外の場合は、リクエストの Accept-Language ヘッダーロケールまたはサーバーのデフォルトのロケールにフォールバックします。

  パラメーター:

  defaultLocaleFunction - デフォルトのロケールを決定するために使用される関数

  導入:

  6.0

  関連事項:

  • AbstractLocaleResolver.setDefaultLocale(java.util.Locale)
  • ServletRequest.getLocale()EE

• setDefaultTimeZoneFunction

  public void setDefaultTimeZoneFunction(FunctionSE<HttpServletRequestEE,TimeZoneSE> defaultTimeZoneFunction)

  TimeZoneSE セッション属性が見つからない場合に呼び出される、指定されたリクエストのデフォルトのタイムゾーンを決定するために使用される関数を設定します。

  デフォルトの実装は、構成されたデフォルトのタイムゾーン（存在する場合）を返し、そうでない場合は null を返します。

  パラメーター:

  defaultTimeZoneFunction - デフォルトのタイムゾーンを決定するために使用される関数

  導入:

  6.0

  関連事項:

  • AbstractLocaleContextResolver.setDefaultTimeZone(java.util.TimeZone)

• resolveLocale

  public LocaleSE resolveLocale(HttpServletRequestEE request)

  インターフェースからコピーされた説明: LocaleContextResolver

  LocaleContextResolver.resolveLocaleContext(HttpServletRequest) に委譲し、必要に応じて ServletRequest.getLocale()EE にフォールバックする LocaleResolver.resolveLocale(HttpServletRequest) のデフォルト実装。

  パラメーター:

  request - ロケールを解決するためのリクエスト

  戻り値:

  現在のロケール (非 null)

• resolveLocaleContext

  public LocaleContext resolveLocaleContext(HttpServletRequestEE request)

  インターフェースからコピーされた説明: LocaleContextResolver

  指定されたリクエストを介して現在のロケールコンテキストを解決します。

  これは主にフレームワークレベルの処理を目的としています。現在のロケールやタイムゾーンへのアプリケーションレベルのアクセスには、RequestContextUtils または RequestContext の使用を検討してください。

  返されるコンテキストは、タイムゾーン情報が関連付けられたロケールを含む TimeZoneAwareLocaleContext である場合があります。instanceof チェックを適用し、それに応じてダウンキャストするだけです。

  カスタムリゾルバーの実装は、返されたコンテキストで追加の設定を返すこともありますが、これもダウンキャストを通じてアクセスできます。

  パラメーター:

  request - ロケールコンテキストを解決するためのリクエスト

  戻り値:

  現在のロケールコンテキスト（非 null

  関連事項:

  • LocaleContextResolver.resolveLocale(HttpServletRequest)
  • RequestContextUtils.getLocale(jakarta.servlet.http.HttpServletRequest)
  • RequestContextUtils.getTimeZone(jakarta.servlet.http.HttpServletRequest)

• setLocaleContext

  public void setLocaleContext(HttpServletRequestEE request, @Nullable HttpServletResponseEE response, @Nullable LocaleContext localeContext)

  インターフェースからコピーされた説明: LocaleContextResolver

  現在のロケールコンテキストを指定されたものに設定します。潜在的に関連するタイムゾーン情報を持つロケールを含みます。

  パラメーター:

  request - ロケール変更に使用されるリクエスト

  response - ロケール変更に使用されるレスポンス

  localeContext - 新しいロケールコンテキスト、またはロケールをクリアする null 

  関連事項:

  • LocaleContextResolver.setLocale(HttpServletRequest, HttpServletResponse, Locale)
  • SimpleLocaleContext
  • SimpleTimeZoneAwareLocaleContext

• determineDefaultLocale

  @DeprecatedSE(since="6.0") protected LocaleSE determineDefaultLocale(HttpServletRequestEE request)

  使用すべきではありません。

  6.0 現在、setDefaultLocaleFunction(Function) を推奨

  LocaleSE セッション属性が見つからなかった場合に呼び出される、指定されたリクエストのデフォルトのロケールを決定します。

  デフォルトの実装は、構成されたデフォルトのロケールを返します（存在する場合）。それ以外の場合は、リクエストの Accept-Language ヘッダーロケールまたはサーバーのデフォルトのロケールにフォールバックします。

  パラメーター:

  request - ロケールを解決するためのリクエスト

  戻り値:

  デフォルトのロケール (非 null)

  関連事項:

  • AbstractLocaleResolver.setDefaultLocale(java.util.Locale)
  • ServletRequest.getLocale()EE

• determineDefaultTimeZone

  @DeprecatedSE(since="6.0") @Nullable protected TimeZoneSE determineDefaultTimeZone(HttpServletRequestEE request)

  使用すべきではありません。

  6.0 現在、setDefaultTimeZoneFunction(Function) を推奨

  TimeZoneSE セッション属性が見つからなかった場合に呼び出される、指定されたリクエストのデフォルトのタイムゾーンを決定します。

  デフォルトの実装は、構成されたデフォルトのタイムゾーン（存在する場合）を返し、そうでない場合は null を返します。

  パラメーター:

  request - タイムゾーンを解決するためのリクエスト

  戻り値:

  デフォルトのタイムゾーン (または定義されていない場合は null )

  関連事項:

  • AbstractLocaleContextResolver.setDefaultTimeZone(java.util.TimeZone)