クラス RequestContextUtils

java.lang.ObjectSE
org.springframework.web.servlet.support.RequestContextUtils
public abstract class RequestContextUtils extends ObjectSE
DispatcherServlet によって設定されたリクエスト固有の状態に簡単にアクセスするためのユーティリティクラス。

現在の WebApplicationContext、LocaleResolver、ロケール、MultipartResolver の検索をサポートします。

導入:
03.03.2003
作成者:
Juergen Hoeller, Rossen Stoyanchev
関連事項:

  • フィールド概要

    フィールド
    修飾子と型
    フィールド
    説明
    static final StringSE
    REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME
    RequestDataValueProcessor の実装が構成されているかどうかを判別するために使用する Bean の名前。

  • コンストラクター概要

    コンストラクター
    コンストラクター
    説明
    RequestContextUtils()

  • 方法の概要

    修飾子と型
    メソッド
    説明
    static @Nullable WebApplicationContext
    findWebApplicationContext(jakarta.servlet.http.HttpServletRequest request)
    リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。
    static @Nullable WebApplicationContext
    findWebApplicationContext(jakarta.servlet.http.HttpServletRequest request, @Nullable jakarta.servlet.ServletContext servletContext)
    リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。
    static @Nullable FlashMapManager
    getFlashMapManager(jakarta.servlet.http.HttpServletRequest request)
    FlashMapManager インスタンスを返して、フラッシュ属性を保存します。
    static @Nullable MapSE<StringSE,?>
    getInputFlashMap(jakarta.servlet.http.HttpServletRequest request)
    リダイレクトの前に、リクエストから読み取り専用の「入力」フラッシュ属性を返します。
    static LocaleSE
    getLocale(jakarta.servlet.http.HttpServletRequest request)
    DispatcherServlet（使用可能な場合）によってリクエストにバインドされた LocaleResolver を使用して、指定されたリクエストから現在のロケールを取得し、Accept-Language ヘッダーまたはサーバーのデフォルトロケールに基づいてリクエストのロケールにフォールバックします。
    static @Nullable LocaleResolver
    getLocaleResolver(jakarta.servlet.http.HttpServletRequest request)
    DispatcherServlet によってリクエストにバインドされた LocaleResolver を返します。
    static FlashMap
    getOutputFlashMap(jakarta.servlet.http.HttpServletRequest request)
    リダイレクト後にリクエストの属性を保存するには、「出力」FlashMap を返します。
    static @Nullable TimeZoneSE
    getTimeZone(jakarta.servlet.http.HttpServletRequest request)
    DispatcherServlet（使用可能な場合）によってリクエストにバインドされた LocaleResolver の TimeZoneAwareLocaleContext を使用して、指定されたリクエストから現在のタイムゾーンを取得します。
    static void
    saveOutputFlashMap(StringSE location, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
    "output" FlashMap を取得し、ターゲット URL のパスおよびクエリパラメーターで更新してから、FlashMapManager を使用して保存する簡易メソッド。

    クラス ObjectSE から継承されたメソッド

    clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

  • フィールドの詳細

  • コンストラクターの詳細

    • RequestContextUtils

      public RequestContextUtils()

  • 方法の詳細

    • findWebApplicationContext

      public static @Nullable WebApplicationContext findWebApplicationContext(jakarta.servlet.http.HttpServletRequest request, @Nullable jakarta.servlet.ServletContext servletContext)
      リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。グローバルコンテキストは、ServletContext または ContextLoader の現在のコンテキストを介して検出されます。

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

      パラメーター:
      request - 現在の HTTP リクエスト
      servletContext - 現在のサーブレットコンテキスト
      戻り値:
      リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからなかった場合はグローバル、ない場合は null 
      導入:
      4.2.1
      関連事項:

    • findWebApplicationContext

      public static @Nullable WebApplicationContext findWebApplicationContext(jakarta.servlet.http.HttpServletRequest request)
      リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。グローバルコンテキストは、ServletContext または ContextLoader の現在のコンテキストを介して検出されます。
      パラメーター:
      request - 現在の HTTP リクエスト
      戻り値:
      リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからなかった場合はグローバル、ない場合は null 
      導入:
      4.2.1
      関連事項:

    • getLocaleResolver

      public static @Nullable LocaleResolver getLocaleResolver(jakarta.servlet.http.HttpServletRequest request)
      DispatcherServlet によってリクエストにバインドされた LocaleResolver を返します。
      パラメーター:
      request - 現在の HTTP リクエスト
      戻り値:
      現在の LocaleResolver、または見つからない場合は null 

    • getLocale

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

      このメソッドは、標準の Servlet ServletRequest.getLocale() メソッドの直接的な代替として機能し、より具体的なロケールが見つからない場合には後者にフォールバックします。

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

      パラメーター:
      request - 現在の HTTP リクエスト
      戻り値:
      LocaleResolver またはプレーンリクエスト自体からの、指定されたリクエストの現在のロケール
      関連事項:

    • getTimeZone

      public static @Nullable TimeZoneSE getTimeZone(jakarta.servlet.http.HttpServletRequest request)
      DispatcherServlet（使用可能な場合）によってリクエストにバインドされた LocaleResolver の TimeZoneAwareLocaleContext を使用して、指定されたリクエストから現在のタイムゾーンを取得します。

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

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

      パラメーター:
      request - 現在の HTTP リクエスト
      戻り値:
      TimeZoneAwareLocaleContext または null （関連付けられていない場合）のいずれかからの、指定されたリクエストの現在のタイムゾーン
      関連事項:

    • getInputFlashMap

      public static @Nullable MapSE<StringSE,?> getInputFlashMap(jakarta.servlet.http.HttpServletRequest request)
      リダイレクトの前に、リクエストから読み取り専用の「入力」フラッシュ属性を返します。
      パラメーター:
      request - 現在のリクエスト
      戻り値:
      読み取り専用マップ、または見つからない場合は null 
      関連事項:

    • getOutputFlashMap

      public static FlashMap getOutputFlashMap(jakarta.servlet.http.HttpServletRequest request)
      リダイレクト後にリクエストの属性を保存するには、「出力」FlashMap を返します。
      パラメーター:
      request - 現在のリクエスト
      戻り値:
      FlashMap インスタンス、DispatcherServlet -handled リクエスト内では null を使用しない

    • getFlashMapManager

      public static @Nullable FlashMapManager getFlashMapManager(jakarta.servlet.http.HttpServletRequest request)
      FlashMapManager インスタンスを返して、フラッシュ属性を保存します。

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

      パラメーター:
      request - 現在のリクエスト
      戻り値:
      FlashMapManager インスタンス、DispatcherServlet -handled リクエスト内では null を使用しない

    • saveOutputFlashMap

      public static void saveOutputFlashMap(StringSE location, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
      "output" FlashMap を取得し、ターゲット URL のパスおよびクエリパラメーターで更新してから、FlashMapManager を使用して保存する簡易メソッド。
      パラメーター:
      location - リダイレクトのターゲット URL
      request - 現在のリクエスト
      response - 現在のレスポンス
      導入:
      5.0