public abstract class WebUtils extends ObjectSE
| コンストラクターと説明 |
|---|
WebUtils() |
| 修飾子と型 | メソッドと説明 |
|---|---|
static void | clearErrorRequestAttributes(HttpServletRequestEE request) サーブレット仕様のエラー属性を、Servlet 2.3 仕様で定義されているキー javax.servlet.error.status_code、javax.servlet.error.exception_type、javax.servlet.error.message、javax.servlet.error.exception、javax.servlet.error.request_uri、javax.servlet.error.servlet_name の HttpServletRequestEE 属性としてクリアします。 |
static void | exposeErrorRequestAttributes(HttpServletRequestEE request, ThrowableSE ex, StringSE servletName) サーブレットコンテナーのエラーページの解決方法 javax.servlet.error.status_code、javax.servlet.error.exception_type、javax.servlet.error.message、javax.servlet.error.exception、javax.servlet.error.request_uri、javax.servlet.error.servlet_name ではなく直接レンダリングされるエラーページについて、Servlet 2.3 仕様で定義されたキーにある HttpServletRequestEE 属性としてサーブレット仕様のエラー属性を公開します。 |
static void | exposeRequestAttributes(ServletRequestEE request, MapSE<StringSE,?> attributes) 使用すべきではありません。 Spring 4.3.2 では、そのような目的のためにカスタムコードが推奨されている |
static StringSE | extractFilenameFromUrlPath(StringSE urlPath) 使用すべきではありません。 Spring 4.3.2 では、そのような目的のためにカスタムコードが推奨されている |
static StringSE | extractFullFilenameFromUrlPath(StringSE urlPath) 使用すべきではありません。 Spring 4.3.2 では、そのような目的のためにカスタムコードが推奨されている (またはファイル拡張子の使用例の場合は UriUtils.extractFileExtension(java.lang.String)) |
static StringSE | findParameterValue(MapSE<StringSE,?> parameters, StringSE name) 指定されたリクエストパラメーターから名前付きパラメーターを取得します。 |
static StringSE | findParameterValue(ServletRequestEE request, StringSE name) 指定されたリクエストパラメーターから名前付きパラメーターを取得します。 |
static CookieEE | getCookie(HttpServletRequestEE request, StringSE name) 指定された名前の最初の Cookie を取得します。 |
static BooleanSE | getDefaultHtmlEscape(ServletContextEE servletContext) デフォルトの HTML エスケープが Web アプリケーションで有効かどうかを返します。 |
static <T> T | getNativeRequest(ServletRequestEE request, ClassSE<T> requiredType) 指定された型の適切なリクエストオブジェクトを返します(可能な場合)。必要に応じて、指定されたリクエストをアンラップします。 |
static <T> T | getNativeResponse(ServletResponseEE response, ClassSE<T> requiredType) 指定された型の適切なレスポンスオブジェクトを返します(可能な場合)。必要に応じて、指定されたレスポンスをラップします。 |
static ObjectSE | getOrCreateSessionAttribute(HttpSessionEE session, StringSE name, ClassSE<?> clazz) 使用すべきではありません。 Spring 4.3.2 では、そのような目的のためにカスタムコードが推奨されている |
static MapSE<StringSE, ObjectSE> | getParametersStartingWith(ServletRequestEE request, StringSE prefix) 指定されたプレフィックスを持つすべてのパラメーターを含むマップを返します。 |
static StringSE | getRealPath(ServletContextEE servletContext, StringSE path) サーブレットコンテナーによって提供される、Web アプリケーション内の指定されたパスの実際のパスを返します。 |
static ObjectSE | getRequiredSessionAttribute(HttpServletRequestEE request, StringSE name) 指定された名前のセッション属性について、指定されたリクエストを確認してください。 |
static BooleanSE | getResponseEncodedHtmlEscape(ServletContextEE servletContext)HTML が文字をエスケープするときにレスポンスエンコーディングを使用する必要があるかどうかを返します。つまり、UTF- * エンコーディングで XML マークアップの重要な文字のみをエスケープします。 |
static ObjectSE | getSessionAttribute(HttpServletRequestEE request, StringSE name) 指定された名前のセッション属性について、指定されたリクエストを確認してください。 |
static StringSE | getSessionId(HttpServletRequestEE request) 指定されたリクエストのセッション ID を確認します(ある場合)。 |
static ObjectSE | getSessionMutex(HttpSessionEE session) 指定されたセッションで利用可能な最良のミューテックスを返します。つまり、指定されたセッションで同期するオブジェクトです。 |
static int | getTargetPage(ServletRequestEE request, StringSE paramPrefix, int currentPage) 使用すべきではありません。 Spring 4.3.2 では、そのような目的のためにカスタムコードが推奨されている |
static FileSE | getTempDir(ServletContextEE servletContext) サーブレットコンテナーによって提供される、現在の Web アプリケーションの一時ディレクトリを返します。 |
static boolean | hasSubmitParameter(ServletRequestEE request, StringSE name) 特定の入力 type="submit" パラメーターがリクエストで送信されたかどうかを、ボタン(直接名前で)またはイメージ(名前 + ".x" または名前 + ".y" )で送信したかどうかを確認します。 |
static boolean | isDefaultHtmlEscape(ServletContextEE servletContext) 使用すべきではありません。 Spring 4.1 現在、 getDefaultHtmlEscape(javax.servlet.ServletContext) を推奨 |
static boolean | isIncludeRequest(ServletRequestEE request) 指定されたリクエストがインクルードリクエストであるかどうか、つまり外部から入ってくるトップレベルの HTTP リクエストではないかどうかを判断します。 |
static boolean | isSameOrigin(HttpRequest request) リクエストが Origin、Host、Forwarded、X-Forwarded-Proto、X-Forwarded-Host に基づいて同じ生成のものであるかどうかを確認 |
static boolean | isValidOrigin(HttpRequest request, CollectionSE<StringSE> allowedOrigins) 指定されたリクエストの起点を、許可された起点のリストと照合します。 |
static MultiValueMap<StringSE, StringSE> | parseMatrixVariables(StringSE matrixVariables) 与えられた文字列をマトリックス変数で解析します。 |
static void | removeWebAppRootSystemProperty(ServletContextEE servletContext)Web アプリのルートディレクトリを指すシステムプロパティを削除します。 |
static void | setSessionAttribute(HttpServletRequestEE request, StringSE name, ObjectSE value) 指定された名前のセッション属性を指定された値に設定します。 |
static void | setWebAppRootSystemProperty(ServletContextEE servletContext) システムプロパティを Web アプリケーションのルートディレクトリに設定します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic static final StringSE INCLUDE_REQUEST_URI_ATTRIBUTE
RequestDispatcher を介して含まれている場合、現在のリソースには元のリクエストが表示されます。独自の URI とパスがリクエスト属性として公開されます。
public static final StringSE INCLUDE_CONTEXT_PATH_ATTRIBUTE
public static final StringSE INCLUDE_SERVLET_PATH_ATTRIBUTE
public static final StringSE INCLUDE_QUERY_STRING_ATTRIBUTE
public static final StringSE FORWARD_REQUEST_URI_ATTRIBUTE
RequestDispatcher 経由でに転送された場合、現在のリソースには独自の URI とパスが表示されます。元の URI とパスは、リクエスト属性として公開されます。
public static final StringSE FORWARD_CONTEXT_PATH_ATTRIBUTE
public static final StringSE FORWARD_SERVLET_PATH_ATTRIBUTE
public static final StringSE FORWARD_QUERY_STRING_ATTRIBUTE
public static final StringSE ERROR_STATUS_CODE_ATTRIBUTE
エラーページとしてマークされている JSP に公開されるため、サーブレットコンテナーのエラーページ解決メカニズムを介してではなく、JSP に直接転送します。
public static final StringSE ERROR_EXCEPTION_TYPE_ATTRIBUTE
public static final StringSE ERROR_SERVLET_NAME_ATTRIBUTE
public static final StringSE CONTENT_TYPE_CHARSET_PREFIX
public static final StringSE DEFAULT_CHARACTER_ENCODING
request.getCharacterEncoding が null を返すときに使用するデフォルトの文字エンコーディング。public static final StringSE TEMP_DIR_CONTEXT_ATTRIBUTE
java.io.File の、現在の Web アプリケーションの一時ディレクトリを指定する標準サーブレット仕様コンテキスト属性。public static final StringSE HTML_ESCAPE_CONTEXT_PARAM
web.xml のコンテキストパラメーター): "defaultHtmlEscape"。public static final StringSE RESPONSE_ENCODED_HTML_ESCAPE_CONTEXT_PARAM
web.xml のコンテキストパラメーター) に対するレスポンスエンコーディングの使用: "responseEncodedHtmlEscape"。public static final StringSE WEB_APP_ROOT_KEY_PARAM
web.xml のコンテキストパラメーター): "webAppRootKey"。public static final StringSE DEFAULT_WEB_APP_ROOT_KEY
public static final StringSE[] SUBMIT_IMAGE_SUFFIXES
public static final StringSE SESSION_MUTEX_ATTRIBUTE
public static void setWebAppRootSystemProperty(ServletContextEE servletContext) throws IllegalStateExceptionSE
web.xml の "webAppRootKey" コンテキストパラメーターで定義できます。デフォルトは "webapp.root" です。 ログファイルの場所内の log4j の "${key}" 構文など、System.getProperty 値での置換をサポートするツールに使用できます。
servletContext - Web アプリケーションのサーブレットコンテキスト IllegalStateExceptionSE - システムプロパティがすでに設定されている場合、または WAR ファイルが展開されていない場合 WEB_APP_ROOT_KEY_PARAM, DEFAULT_WEB_APP_ROOT_KEY, WebAppRootListener, Log4jWebConfigurerpublic static void removeWebAppRootSystemProperty(ServletContextEE servletContext)
servletContext - Web アプリケーションのサーブレットコンテキスト setWebAppRootSystemProperty(javax.servlet.ServletContext)@DeprecatedSE public static boolean isDefaultHtmlEscape(ServletContextEE servletContext)
getDefaultHtmlEscape(javax.servlet.ServletContext) に置き換えられました。web.xml の "defaultHtmlEscape" コンテキストパラメーターの値 (存在する場合) を返します。明示的なデフォルトが指定されていない場合は、false にフォールバックします。servletContext - Web アプリケーションのサーブレットコンテキスト false です)public static BooleanSE getDefaultHtmlEscape(ServletContextEE servletContext)
web.xml の "defaultHtmlEscape" コンテキストパラメーターの値 (存在する場合) を返します。このメソッドは、パラメーターがまったく指定されていないことと指定された実際のブール値を区別し、グローバルレベルで設定がない場合にコンテキスト固有のデフォルトを設定できるようにします。
servletContext - Web アプリケーションのサーブレットコンテキスト null = 明示的なデフォルトなし)public static BooleanSE getResponseEncodedHtmlEscape(ServletContextEE servletContext)
web.xml の "responseEncodedHtmlEscape" コンテキストパラメーターの値 (存在する場合) を持つ Web アプリケーションで有効になります。このメソッドは、パラメーターがまったく指定されていないことと指定された実際のブール値を区別し、グローバルレベルで設定がない場合にコンテキスト固有のデフォルトを設定できるようにします。
servletContext - Web アプリケーションのサーブレットコンテキスト null = 明示的なデフォルトなし)public static FileSE getTempDir(ServletContextEE servletContext)
servletContext - Web アプリケーションのサーブレットコンテキスト public static StringSE getRealPath(ServletContextEE servletContext, StringSE path) throws FileNotFoundExceptionSE
パスがスラッシュで始まっていない場合はスラッシュを付加し、パスをリソースに解決できない場合は FileNotFoundException をスローします(ServletContext の getRealPath は null を返します)。
servletContext - Web アプリケーションのサーブレットコンテキスト path - Web アプリケーション内のパス FileNotFoundExceptionSE - パスをリソースに解決できない場合 ServletContext.getRealPath(java.lang.String)EEpublic static StringSE getSessionId(HttpServletRequestEE request)
request - 現在の HTTP リクエスト null public static ObjectSE getSessionAttribute(HttpServletRequestEE request, StringSE name)
request - 現在の HTTP リクエスト name - セッション属性の名前 null public static ObjectSE getRequiredSessionAttribute(HttpServletRequestEE request, StringSE name) throws IllegalStateExceptionSE
request - 現在の HTTP リクエスト name - セッション属性の名前 null IllegalStateExceptionSE - セッション属性が見つからなかった場合 public static void setSessionAttribute(HttpServletRequestEE request, StringSE name, ObjectSE value)
request - 現在の HTTP リクエスト name - セッション属性の名前 value - セッション属性の値 @DeprecatedSE public static ObjectSE getOrCreateSessionAttribute(HttpSessionEE session, StringSE name, ClassSE<?> clazz) throws IllegalArgumentExceptionSE
session - 現在の HTTP セッション name - セッション属性の名前 clazz - 新しい属性をインスタンス化するクラス IllegalArgumentExceptionSE - セッション属性をインスタンス化できなかった場合 public static ObjectSE getSessionMutex(HttpSessionEE session)
利用可能な場合はセッションミューテックス属性を返します。通常、これは HttpSessionMutexListener を web.xml で定義する必要があることを意味します。mutex 属性が見つからない場合は、HttpSession 自体にフォールバックします。
セッションミューテックスは、セッションのライフタイム全体を通じて同じオブジェクトであることが保証されており、SESSION_MUTEX_ATTRIBUTE 定数で定義されたキーで使用できます。これは、現在のセッションのロックを同期するための安全な参照として機能します。
多くの場合、HttpSession 参照自体も、同じアクティブな論理セッションに対する常に同じオブジェクト参照になるため、安全なミューテックスです。ただし、これは異なるサーブレットコンテナー間では保証されません。唯一の 100% 安全な方法は、セッションミューテックスです。
session - ミューテックスを見つける HttpSessionnull)SESSION_MUTEX_ATTRIBUTE, HttpSessionMutexListenerpublic static <T> T getNativeRequest(ServletRequestEE request, ClassSE<T> requiredType)
request - イントロスペクトするサーブレットリクエスト requiredType - 目的の型のリクエストオブジェクト null public static <T> T getNativeResponse(ServletResponseEE response, ClassSE<T> requiredType)
response - イントロスペクトに対するサーブレットのレスポンス requiredType - 希望する型のレスポンスオブジェクト null public static boolean isIncludeRequest(ServletRequestEE request)
"javax.servlet.include.request_uri" リクエスト属性の存在を確認します。インクルードリクエストにのみ存在するリクエスト属性をチェックできます。
request - 現在のサーブレットリクエスト public static void exposeErrorRequestAttributes(HttpServletRequestEE request, ThrowableSE ex, StringSE servletName)
javax.servlet.error.status_code、javax.servlet.error.exception_type、javax.servlet.error.message、javax.servlet.error.exception、javax.servlet.error.request_uri、javax.servlet.error.servlet_name ではなく直接レンダリングされるエラーページについて、Servlet 2.3 仕様で定義されたキーにある HttpServletRequestEE 属性としてサーブレット仕様のエラー属性を公開します。以前に明示的に公開された属性値を考慮するために、すでに存在する場合は値をオーバーライドしません。
デフォルトでステータスコード 200 を公開します。異なるステータスコードを公開するために、"javax.servlet.error.status_code" 属性を明示的に(前または後に)設定します。
request - 現在のサーブレットリクエスト ex - 発生した例外 servletName - 問題のあるサーブレットの名前 public static void clearErrorRequestAttributes(HttpServletRequestEE request)
javax.servlet.error.status_code、javax.servlet.error.exception_type、javax.servlet.error.message、javax.servlet.error.exception、javax.servlet.error.request_uri、javax.servlet.error.servlet_name の HttpServletRequestEE 属性としてクリアします。request - 現在のサーブレットリクエスト @DeprecatedSE public static void exposeRequestAttributes(ServletRequestEE request, MapSE<StringSE,?> attributes)
request - 現在の HTTP リクエスト attributes - 属性マップ public static CookieEE getCookie(HttpServletRequestEE request, StringSE name)
request - 現在のサーブレットリクエスト name - クッキー名 null public static boolean hasSubmitParameter(ServletRequestEE request, StringSE name)
request - 現在の HTTP リクエスト name - パラメーターの名前 SUBMIT_IMAGE_SUFFIXESpublic static StringSE findParameterValue(ServletRequestEE request, StringSE name)
ルックアップアルゴリズムの説明については、findParameterValue(java.util.Map, String) を参照してください。
request - 現在の HTTP リクエスト name - リクエストパラメーターの論理名 null public static StringSE findParameterValue(MapSE<StringSE,?> parameters, StringSE name)
このメソッドは、次のアルゴリズムを使用してパラメーター値を取得しようとします。
parameters - 利用可能なパラメーターマップ name - リクエストパラメーターの論理名 null public static MapSE<StringSE,ObjectSE> getParametersStartingWith(ServletRequestEE request, StringSE prefix)
例: "spring _"、"spring_param1"、"spring_param2" の接頭辞を使用すると、"param1" と "param2" をキーとするマップが作成されます。
request - パラメーターを探す HTTP リクエスト prefix - パラメーター名の始まり (これが null または空の文字列の場合、すべてのパラメーターが一致します)ServletRequest.getParameterNames()EE, ServletRequest.getParameterValues(java.lang.String)EE, ServletRequest.getParameterMap()EE@DeprecatedSE public static int getTargetPage(ServletRequestEE request, StringSE paramPrefix, int currentPage)
request - 現在のサーブレットリクエスト paramPrefix - チェックするパラメータープレフィックス (たとえば、"_target1" や "_target2" のようなパラメーターの場合は "_target" )currentPage - 現在のページ。ターゲットページが指定されていない場合はフォールバックとして返されます @DeprecatedSE public static StringSE extractFilenameFromUrlPath(StringSE urlPath)
urlPath - リクエスト URL パス (たとえば "/index.html")@DeprecatedSE public static StringSE extractFullFilenameFromUrlPath(StringSE urlPath)
UriUtils.extractFileExtension(java.lang.String)) が推奨されます。urlPath - リクエスト URL パス (たとえば "/products/index.html")public static MultiValueMap<StringSE,StringSE> parseMatrixVariables(StringSE matrixVariables)
"q1=a;q1=b;q2=a,b,c" のようになります。結果のマップには、キー "q1" および "q2" が含まれ、それぞれ値 ["a","b"] および ["a","b","c"] が含まれます。matrixVariables - 解析されていないマトリックス変数文字列 null)public static boolean isValidOrigin(HttpRequest request, CollectionSE<StringSE> allowedOrigins)
注意 : このメソッドは、"Forwarded" (RFC 7239)、"X-Forwarded-Host"、"X-Forwarded-Port"、"X-Forwarded-Proto" ヘッダーからの値を使用する場合があります(存在する場合)。住所。ForwardedHeaderFilter を使用して、主要な場所から抽出して使用するか、そのようなヘッダーを破棄するかを選択することを検討してください。このフィルターの詳細については、Spring Framework リファレンスを参照してください。
true、それ以外の場合は false public static boolean isSameOrigin(HttpRequest request)
Origin、Host、Forwarded、X-Forwarded-Proto、X-Forwarded-Host に基づいて同じ生成のものであるかどうかを確認 true、クロスオリジンリクエストの場合は false