RequestContextUtils (Spring Framework 4.3.23.RELEASE API)

java.lang.ObjectSE
- org.springframework.web.servlet.support.RequestContextUtils

```
public abstract class RequestContextUtils
extends ObjectSE
```
DispatcherServlet によって設定されたリクエスト固有の状態に簡単にアクセスするためのユーティリティクラス。
現在の WebApplicationContext、LocaleResolver、ロケール、ThemeResolver、テーマ、MultipartResolver のルックアップをサポートします。
導入:
03.03.2003
作成者:
Juergen Hoeller, Rossen Stoyanchev
関連事項:
RequestContext, DispatcherServlet

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME` `RequestDataValueProcessor` の実装で検索するために使用する Bean の名前が構成されました。

コンストラクターの概要
コンストラクター
コンストラクターと説明
RequestContextUtils()

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

メソッドのサマリー

すべてのメソッド静的メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`static WebApplicationContext`	`findWebApplicationContext(HttpServletRequestEE request)` リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。
`static WebApplicationContext`	`findWebApplicationContext(HttpServletRequestEE request, ServletContextEE servletContext)` リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。
`static FlashMapManager`	`getFlashMapManager(HttpServletRequestEE request)` リダイレクト前にフラッシュ属性を保存するための FlashMapManager インスタンスを返します。
`static MapSE<StringSE,?>`	`getInputFlashMap(HttpServletRequestEE request)` 前回のリクエストで保存された「入力」フラッシュ属性を持つ読み取り専用の `Map`SE を返します。
`static LocaleSE`	`getLocale(HttpServletRequestEE request)` DispatcherServlet（利用可能な場合）によってリクエストにバインドされた LocaleResolver を使用して、指定されたリクエストから現在のロケールを取得し、リクエストの accept-header ロケールにフォールバックします。
`static LocaleResolver`	`getLocaleResolver(HttpServletRequestEE request)` DispatcherServlet によってリクエストにバインドされた LocaleResolver を返します。
`static FlashMap`	`getOutputFlashMap(HttpServletRequestEE request)` 後続のリクエスト用に保存する属性を含む「出力」FlashMap を返します。
`static Theme`	`getTheme(HttpServletRequestEE request)` DispatcherServlet によってリクエストにバインドされた ThemeResolver および ThemeSource を使用して、指定されたリクエストから現在のテーマを取得します。
`static ThemeResolver`	`getThemeResolver(HttpServletRequestEE request)` DispatcherServlet によってリクエストにバインドされた ThemeResolver を返します。
`static ThemeSource`	`getThemeSource(HttpServletRequestEE request)` DispatcherServlet によってリクエストにバインドされた ThemeSource を返します。
`static TimeZoneSE`	`getTimeZone(HttpServletRequestEE request)` DispatcherServlet（使用可能な場合）によってリクエストにバインドされた TimeZoneAwareLocaleResolver を使用して、指定されたリクエストから現在のタイムゾーンを取得し、システムのデフォルトのタイムゾーンにフォールバックします。
`static WebApplicationContext`	`getWebApplicationContext(ServletRequestEE request)` 使用すべきではありません。 Spring 4.2.1 現在、`findWebApplicationContext(HttpServletRequest)` を推奨
`static WebApplicationContext`	`getWebApplicationContext(ServletRequestEE request, ServletContextEE servletContext)` 使用すべきではありません。 Spring 4.2.1 現在、`findWebApplicationContext(HttpServletRequest, ServletContext)` を推奨

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME
```
public static final StringSE REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME
```
    RequestDataValueProcessor の実装で検索するために使用する Bean の名前が構成されました。
    導入:
    4.2.1
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - RequestContextUtils
```
public RequestContextUtils()
```
- メソッドの詳細
  - getWebApplicationContext
```
@DeprecatedSE
public static WebApplicationContext getWebApplicationContext(ServletRequestEE request)
                                                                  throws IllegalStateExceptionSE
```
    Spring 4.2.1 以降は非推奨。findWebApplicationContext(HttpServletRequest) に置き換えられました。
    リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    リクエスト固有の Web アプリケーションコンテキスト
    例外:
    IllegalStateExceptionSE - サーブレット固有のコンテキストが見つからない場合
    関連事項:
    getWebApplicationContext(ServletRequest, ServletContext)
  - getWebApplicationContext
```
@DeprecatedSE
public static WebApplicationContext getWebApplicationContext(ServletRequestEE request,
                                                                         ServletContextEE servletContext)
                                                                  throws IllegalStateExceptionSE
```
    Spring 4.2.1 以降は非推奨。findWebApplicationContext(HttpServletRequest, ServletContext) に置き換えられました。
    リクエスト処理を開始した DispatcherServlet に関連付けられた WebApplicationContext を検索し、現在のリクエストに関連付けられたものが見つからない場合はグローバルコンテキストを検索します。このメソッドは、JSP タグハンドラーなどのフレームワーク外部のコンポーネントが、利用可能な最も具体的なアプリケーションコンテキストにアクセスできるようにできます。
    パラメーター:
    request - 現在の HTTP リクエスト
    servletContext - 現在のサーブレットコンテキスト
    戻り値:
    リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからない場合はグローバル WebApplicationContext
    例外:
    IllegalStateExceptionSE - サーブレット固有のコンテキストもグローバルコンテキストも見つからない場合
    関連事項:
    DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE, WebApplicationContextUtils.getRequiredWebApplicationContext(ServletContext)
  - findWebApplicationContext
```
public static WebApplicationContext findWebApplicationContext(HttpServletRequestEE request,
                                                              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
```
public static WebApplicationContext findWebApplicationContext(HttpServletRequestEE request)
```
    リクエスト処理を開始した DispatcherServlet に関連付けられている WebApplicationContext を探し、現在のリクエストに関連付けられているものが見つからなかった場合はグローバルコンテキストを探します。グローバルコンテキストは、ServletContext または ContextLoader の現在のコンテキストを介して検出されます。
    NOTE: このバリアントには Servlet 3.0+ が必要であり、一般に、将来を見据えたカスタムユーザーコードに推奨されます。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    リクエスト固有の WebApplicationContext、またはリクエスト固有のコンテキストが見つからなかった場合はグローバル、ない場合は null
    導入:
    4.2.1
    関連事項:
    findWebApplicationContext(HttpServletRequest, ServletContext), ServletRequest.getServletContext()EE, ContextLoader.getCurrentWebApplicationContext()
  - getLocaleResolver
```
public static LocaleResolver getLocaleResolver(HttpServletRequestEE request)
```
    DispatcherServlet によってリクエストにバインドされた LocaleResolver を返します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    現在の LocaleResolver、または見つからない場合は null
  - getLocale
```
public static LocaleSE getLocale(HttpServletRequestEE request)
```
    DispatcherServlet（利用可能な場合）によってリクエストにバインドされた LocaleResolver を使用して、指定されたリクエストから現在のロケールを取得し、リクエストの accept-header ロケールにフォールバックします。
    このメソッドは、標準のサーブレット ServletRequest.getLocale()EE メソッドの単純な代替手段として機能し、特定のロケールが見つからない場合は後者にフォールバックします。
    通常は同じロケールで設定される LocaleContextHolder.getLocale() の使用を検討してください。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    LocaleResolver またはプレーンリクエスト自体からの、指定されたリクエストの現在のロケール
    関連事項:
    getLocaleResolver(javax.servlet.http.HttpServletRequest), LocaleContextHolder.getLocale()
  - getTimeZone
```
public static TimeZoneSE getTimeZone(HttpServletRequestEE request)
```
    DispatcherServlet（使用可能な場合）によってリクエストにバインドされた TimeZoneAwareLocaleResolver を使用して、指定されたリクエストから現在のタイムゾーンを取得し、システムのデフォルトのタイムゾーンにフォールバックします。
    メモ: このメソッドは、指定されたリクエストに対して特定のタイムゾーンを解決できない場合、null を返します。これは、フォールバックするリクエストの accept-header ロケールが常に存在する getLocale(javax.servlet.http.HttpServletRequest) とは対照的です。
    通常は同じ TimeZone が設定される LocaleContextHolder.getTimeZone() の使用を検討してください: LocaleResolver が（このメソッドの null の代わりに）特定のタイムゾーンを提供していない場合、そのメソッドはシステムタイムゾーンへのフォールバックに関してのみ異なります。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    指定されたリクエストの現在のタイムゾーン、TimeZoneAwareLocaleResolver または null のいずれか、関連付けられていない場合
    関連事項:
    getLocaleResolver(javax.servlet.http.HttpServletRequest), LocaleContextHolder.getTimeZone()
  - getThemeResolver
```
public static ThemeResolver getThemeResolver(HttpServletRequestEE request)
```
    DispatcherServlet によってリクエストにバインドされた ThemeResolver を返します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    現在の ThemeResolver、または見つからない場合は null
  - getThemeSource
```
public static ThemeSource getThemeSource(HttpServletRequestEE request)
```
    DispatcherServlet によってリクエストにバインドされた ThemeSource を返します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    現在の ThemeSource
  - getTheme
```
public static Theme getTheme(HttpServletRequestEE request)
```
    DispatcherServlet によってリクエストにバインドされた ThemeResolver および ThemeSource を使用して、指定されたリクエストから現在のテーマを取得します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    現在のテーマ、または見つからない場合は null
    関連事項:
    getThemeResolver(javax.servlet.http.HttpServletRequest)
  - getInputFlashMap
```
public static MapSE<StringSE,?> getInputFlashMap(HttpServletRequestEE request)
```
    前回のリクエストで保存された「入力」フラッシュ属性を持つ読み取り専用の MapSE を返します。
    パラメーター:
    request - 現在のリクエスト
    戻り値:
    読み取り専用マップ、または見つからない場合は null
    関連事項:
    FlashMap
  - getOutputFlashMap
```
public static FlashMap getOutputFlashMap(HttpServletRequestEE request)
```
    後続のリクエスト用に保存する属性を含む「出力」FlashMap を返します。
    パラメーター:
    request - 現在のリクエスト
    戻り値:
    FlashMap インスタンス (DispatcherServlet リクエスト内では null は使用しない)
    関連事項:
    FlashMap
  - getFlashMapManager
```
public static FlashMapManager getFlashMapManager(HttpServletRequestEE request)
```
    リダイレクト前にフラッシュ属性を保存するための FlashMapManager インスタンスを返します。
    パラメーター:
    request - 現在のリクエスト
    戻り値:
    FlashMapManager インスタンス (DispatcherServlet リクエスト内では null は使用しない)

クラス RequestContextUtils

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

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

フィールドの詳細

REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME

コンストラクターの詳細

RequestContextUtils

メソッドの詳細

getWebApplicationContext

getWebApplicationContext

findWebApplicationContext

findWebApplicationContext

getLocaleResolver

getLocale

getTimeZone

getThemeResolver

getThemeSource

getTheme

getInputFlashMap

getOutputFlashMap

getFlashMapManager