クラス RequestContextUtils

メソッドの詳細

• findWebApplicationContext

  @Nullable public static WebApplicationContext findWebApplicationContext(HttpServletRequestEE request, @Nullable ServletContextEE servletContext)

  リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。グローバルコンテキストは、ServletContext または ContextLoader の現在のコンテキストを介して検出されます。

  NOTE: このバリアントは、Servlet 2.5 との互換性を維持し、リクエストから導出するのではなく、特定の ServletContext を明示的にチェックします。

  パラメーター:

  request - 現在の HTTP リクエスト

  servletContext - 現在のサーブレットコンテキスト

  戻り値:

  リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからなかった場合はグローバル、ない場合は null 

  導入:

  4.2.1

  関連事項:

  • DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE
  • WebApplicationContextUtils.getWebApplicationContext(ServletContext)
  • ContextLoader.getCurrentWebApplicationContext()

• findWebApplicationContext

  @Nullable public static WebApplicationContext findWebApplicationContext(HttpServletRequestEE request)

  リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。グローバルコンテキストは、ServletContext または ContextLoader の現在のコンテキストを介して検出されます。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからなかった場合はグローバル、ない場合は null 

  導入:

  4.2.1

  関連事項:

  • findWebApplicationContext(HttpServletRequest, ServletContext)
  • ServletRequest.getServletContext()EE
  • ContextLoader.getCurrentWebApplicationContext()

• getLocaleResolver

  @Nullable public static LocaleResolver getLocaleResolver(HttpServletRequestEE request)

  DispatcherServlet によってリクエストにバインドされた LocaleResolver を返します。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  現在の LocaleResolver、または見つからない場合は null 

• getLocale

  public static LocaleSE getLocale(HttpServletRequestEE request)

  DispatcherServlet（使用可能な場合）によってリクエストにバインドされた LocaleResolver を使用して、指定されたリクエストから現在のロケールを取得し、Accept-Language ヘッダーまたはサーバーのデフォルトロケールに基づいてリクエストのロケールにフォールバックします。

  このメソッドは、標準のサーブレット ServletRequest.getLocale()EE メソッドの単純な代替手段として機能し、特定のロケールが見つからない場合は後者にフォールバックします。

  通常は同じロケールで設定される LocaleContextHolder.getLocale() の使用を検討してください。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  LocaleResolver またはプレーンリクエスト自体からの、指定されたリクエストの現在のロケール

  関連事項:

  • getLocaleResolver(jakarta.servlet.http.HttpServletRequest)
  • LocaleContextHolder.getLocale()

• getTimeZone

  @Nullable public static TimeZoneSE getTimeZone(HttpServletRequestEE request)

  DispatcherServlet（使用可能な場合）によってリクエストにバインドされた LocaleResolver の TimeZoneAwareLocaleContext を使用して、指定されたリクエストから現在のタイムゾーンを取得します。

  メモ: 指定されたリクエストに対して特定のタイムゾーンを解決できない場合、このメソッドは null を返します。これは、Accept-Language ヘッダーまたはサーバーのデフォルトロケールに基づいてリクエストのロケールにいつでもフォールバックできる getLocale(jakarta.servlet.http.HttpServletRequest) とは対照的です。

  通常は同じ TimeZone が設定される LocaleContextHolder.getTimeZone() の使用を検討してください。このメソッドは、LocaleResolver が特定のタイムゾーンを提供していない場合（このメソッドの null ではなく）、システムタイムゾーンへのフォールバックの点でのみ異なります。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  TimeZoneAwareLocaleContext または null （関連付けられていない場合）のいずれかからの、指定されたリクエストの現在のタイムゾーン

  関連事項:

  • getLocaleResolver(jakarta.servlet.http.HttpServletRequest)
  • LocaleContextHolder.getTimeZone()

• getThemeResolver

  @Nullable @DeprecatedSE(since="6.0") public static ThemeResolver getThemeResolver(HttpServletRequestEE request)

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

  6.0 の時点で、直接の代替はありません

  DispatcherServlet によってリクエストにバインドされた ThemeResolver を返します。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  現在の ThemeResolver、または見つからない場合は null 

• getThemeSource

  @Nullable @DeprecatedSE(since="6.0") public static ThemeSource getThemeSource(HttpServletRequestEE request)

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

  6.0 の時点で、直接の代替はありません

  DispatcherServlet によってリクエストにバインドされた ThemeSource を返します。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  現在の ThemeSource

• getTheme

  @Nullable @DeprecatedSE(since="6.0") public static Theme getTheme(HttpServletRequestEE request)

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

  6.0 の時点で、直接の代替はありません

  DispatcherServlet によってリクエストにバインドされた ThemeResolver および ThemeSource を使用して、指定されたリクエストから現在のテーマを取得します。

  パラメーター:

  request - 現在の HTTP リクエスト

  戻り値:

  現在のテーマ、または見つからない場合は null 

  関連事項:

  • getThemeResolver(jakarta.servlet.http.HttpServletRequest)

• getInputFlashMap

  @Nullable public static MapSE<StringSE,?> getInputFlashMap(HttpServletRequestEE request)

  リダイレクトの前に、リクエストから読み取り専用の「入力」フラッシュ属性を返します。

  パラメーター:

  request - 現在のリクエスト

  戻り値:

  読み取り専用マップ、または見つからない場合は null 

  関連事項:

  • FlashMap

• getOutputFlashMap

  public static FlashMap getOutputFlashMap(HttpServletRequestEE request)

  リダイレクト後にリクエストの属性を保存するには、「出力」FlashMap を返します。

  パラメーター:

  request - 現在のリクエスト

  戻り値:

  FlashMap インスタンス、DispatcherServlet -handled リクエスト内では null を使用しない

• getFlashMapManager

  @Nullable public static FlashMapManager getFlashMapManager(HttpServletRequestEE request)

  FlashMapManager インスタンスを返して、フラッシュ属性を保存します。

  5.0 では、便利なメソッド saveOutputFlashMap(java.lang.String, jakarta.servlet.http.HttpServletRequest, jakarta.servlet.http.HttpServletResponse) を使用して「出力」FlashMap を保存できます。

  パラメーター:

  request - 現在のリクエスト

  戻り値:

  FlashMapManager インスタンス、DispatcherServlet -handled リクエスト内では null を使用しない

• saveOutputFlashMap

  public static void saveOutputFlashMap(StringSE location, HttpServletRequestEE request, HttpServletResponseEE response)

  "output" FlashMap を取得し、ターゲット URL のパスおよびクエリパラメーターで更新してから、FlashMapManager を使用して保存する簡易メソッド。

  パラメーター:

  location - リダイレクトのターゲット URL

  request - 現在のリクエスト

  response - 現在のレスポンス

  導入:

  5.0