UrlPathHelper (Spring Framework 5.0.6.RELEASE API)

java.lang.Object
- org.springframework.web.util.UrlPathHelper

```
public class UrlPathHelper
extends java.lang.Object
```
URL パスマッチング用のヘルパークラス。RequestDispatcher インクルードの URL パスのサポートと、一貫性のある URL デコードのサポートを提供します。
AbstractUrlHandlerMapping および RequestContext で、パスのマッチングや URI の決定に使用されます。
導入:
14.01.2004
作成者:
Juergen Hoeller, Rob Harrop, Rossen Stoyanchev

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

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

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`MultiValueMap<java.lang.String,java.lang.String>`	`decodeMatrixVariables(HttpServletRequestEE request, MultiValueMap<java.lang.String,java.lang.String> vars)` `setUrlDecode(boolean)` が `true` に設定されていない限り、指定されたマトリックス変数を `decodeRequestString(HttpServletRequest, String)` を介してデコードします。この場合、変数の抽出元の URL パスは `getLookupPathForRequest(HttpServletRequest)` の呼び出しによってすでにデコードされていると見なされます。
`java.util.Map<java.lang.String,java.lang.String>`	`decodePathVariables(HttpServletRequestEE request, java.util.Map<java.lang.String,java.lang.String> vars)` `setUrlDecode(boolean)` が `true` に設定されていない限り、指定された URI パス変数を `decodeRequestString(HttpServletRequest, String)` を介してデコードします。この場合、変数の抽出元の URL パスは `getLookupPathForRequest(HttpServletRequest)` の呼び出しによってすでにデコードされていると見なされます。
`java.lang.String`	`decodeRequestString(HttpServletRequestEE request, java.lang.String source)` 指定されたソース文字列を URLDecoder でデコードします。
`protected java.lang.String`	`determineEncoding(HttpServletRequestEE request)` 指定されたリクエストのエンコーディングを決定します。
`java.lang.String`	`getContextPath(HttpServletRequestEE request)` RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのコンテキストパスを返します。
`protected java.lang.String`	`getDefaultEncoding()` URL のデコードに使用するデフォルトの文字エンコーディングを返します。
`java.lang.String`	`getLookupPathForRequest(HttpServletRequestEE request)` 該当する場合は現在のサーブレットマッピング内、そうでない場合は Web アプリケーション内で、指定されたリクエストのマッピングルックアップパスを返します。
`java.lang.String`	`getOriginatingContextPath(HttpServletRequestEE request)` RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのコンテキストパスを返します。
`java.lang.String`	`getOriginatingQueryString(HttpServletRequestEE request)` 指定されたリクエストの URL のクエリ文字列部分を返します。
`java.lang.String`	`getOriginatingRequestUri(HttpServletRequestEE request)` 指定されたリクエストのリクエスト URI を返します。
`java.lang.String`	`getOriginatingServletPath(HttpServletRequestEE request)` RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのサーブレットパスを返します。
`java.lang.String`	`getPathWithinApplication(HttpServletRequestEE request)` 指定されたリクエストの Web アプリケーション内のパスを返します。
`java.lang.String`	`getPathWithinServletMapping(HttpServletRequestEE request)` 指定されたリクエストのサーブレットマッピング内のパスを返します。
`java.lang.String`	`getRequestUri(HttpServletRequestEE request)` 指定されたリクエストのリクエスト URI を返します。RequestDispatcher インクルード内で呼び出された場合、インクルードリクエスト URL を検出します。
`java.lang.String`	`getServletPath(HttpServletRequestEE request)` RequestDispatcher インクルード内で呼び出された場合、インクルードリクエスト URL に関して、指定されたリクエストのサーブレットパスを返します。
`boolean`	`isUrlDecode()` ルックアップパスを決定するときにリクエスト URI をデコードするかどうか。
`java.lang.String`	`removeSemicolonContent(java.lang.String requestUri)` removeSemicolonContent プロパティが "true" に設定されている場合、指定されたリクエスト URI から ";" (セミコロン) コンテンツを削除します。
`void`	`setAlwaysUseFullPath(boolean alwaysUseFullPath)` URL ルックアップで、現在のアプリケーションコンテキスト内で常にフルパスを使用する必要があるかどうか。
`void`	`setDefaultEncoding(java.lang.String defaultEncoding)` URL デコードに使用するデフォルトの文字エンコードを設定します。
`void`	`setRemoveSemicolonContent(boolean removeSemicolonContent)` ";" の場合に設定（セミコロン）コンテンツはリクエスト URI から削除する必要があります。
`void`	`setUrlDecode(boolean urlDecode)` コンテキストパスとリクエスト URI をデコードする必要があるかどうか。どちらも、サーブレットパスとは対照的に、サーブレット API によってデコードされずに返されます。
`boolean`	`shouldRemoveSemicolonContent()` ";" を削除するように設定されているかどうか（セミコロン）リクエスト URI のコンテンツ。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクターの詳細
  - UrlPathHelper
```
public UrlPathHelper()
```
- メソッドの詳細
  - setAlwaysUseFullPath
```
public void setAlwaysUseFullPath(boolean alwaysUseFullPath)
```
    URL ルックアップが常に現在のアプリケーションコンテキスト内、つまり ServletContext.getContextPath()EE 内でフルパスを使用するかどうか。
    false に設定すると、該当する場合は、代わりに現在のサーブレットマッピング内のパスが使用されます（つまり、"/myServlet/*" などのプレフィックスベースのサーブレットマッピングの場合）。
    デフォルトでは、これは "false" に設定されています。
  - setUrlDecode
```
public void setUrlDecode(boolean urlDecode)
```
    コンテキストパスとリクエスト URI をデコードする必要があるかどうか。どちらも、サーブレットパスとは対照的に、サーブレット API によってデコードされずに返されます。
    "true" に設定すると、リクエストエンコーディングまたはデフォルトのサーブレット仕様エンコーディング（ISO-8859-1）のいずれかが使用されます。
    デフォルトでは true に設定されています。
    注意 : エンコードされたパスと比較すると、サーブレットパスが一致しないことに注意してください。urlDecode=false の使用は、プレフィックスベースのサーブレットマッピングと互換性がなく、同様に alwaysUseFullPath=true の設定も意味します。
    関連事項:
    getServletPath(javax.servlet.http.HttpServletRequest), getContextPath(javax.servlet.http.HttpServletRequest), getRequestUri(javax.servlet.http.HttpServletRequest), WebUtils.DEFAULT_CHARACTER_ENCODING, ServletRequest.getCharacterEncoding()EE, URLDecoder.decode(String, String)
  - isUrlDecode
```
public boolean isUrlDecode()
```
    ルックアップパスを決定するときにリクエスト URI をデコードするかどうか。
    導入:
    4.3.13
  - setRemoveSemicolonContent
```
public void setRemoveSemicolonContent(boolean removeSemicolonContent)
```
    ";" の場合に設定（セミコロン）コンテンツはリクエスト URI から削除する必要があります。
    デフォルトは「true」。
  - shouldRemoveSemicolonContent
```
public boolean shouldRemoveSemicolonContent()
```
    ";" を削除するように設定されているかどうか（セミコロン）リクエスト URI のコンテンツ。
  - setDefaultEncoding
```
public void setDefaultEncoding(java.lang.String defaultEncoding)
```
    URL デコードに使用するデフォルトの文字エンコードを設定します。サーブレット仕様によると、デフォルトは ISO-8859-1 です。
    リクエスト自体が文字エンコーディングを指定している場合、リクエストのエンコーディングはこの設定をオーバーライドします。これにより、ServletRequest.setCharacterEncoding メソッドを呼び出すフィルターの文字エンコードを一般的にオーバーライドすることもできます。
    パラメーター:
    defaultEncoding - 使用する文字エンコーディング
    関連事項:
    determineEncoding(javax.servlet.http.HttpServletRequest), ServletRequest.getCharacterEncoding()EE, ServletRequest.setCharacterEncoding(String)EE, WebUtils.DEFAULT_CHARACTER_ENCODING
  - getDefaultEncoding
```
protected java.lang.String getDefaultEncoding()
```
    URL のデコードに使用するデフォルトの文字エンコーディングを返します。
  - getLookupPathForRequest
```
public java.lang.String getLookupPathForRequest(HttpServletRequestEE request)
```
    該当する場合は現在のサーブレットマッピング内、そうでない場合は Web アプリケーション内で、指定されたリクエストのマッピングルックアップパスを返します。
    RequestDispatcher include 内で呼び出された場合、include リクエスト URL を検出します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    ルックアップパス
    関連事項:
    getPathWithinApplication(javax.servlet.http.HttpServletRequest), getPathWithinServletMapping(javax.servlet.http.HttpServletRequest)
  - getPathWithinServletMapping
```
public java.lang.String getPathWithinServletMapping(HttpServletRequestEE request)
```
    指定されたリクエストのサーブレットマッピング内のパス、つまりサーブレットを呼び出した部分を超えるリクエストの URL の部分、または URL 全体がサーブレットの識別に使用されている場合は "" を返します。
    RequestDispatcher include 内で呼び出された場合、include リクエスト URL を検出します。
    E. 例: サーブレットマッピング = "/*"; リクエスト URI="/test/a"-> "/test/a"。
    E. 例: サーブレットマッピング = "/"; リクエスト URI="/test/a"-> "/test/a"。
    E. 例: サーブレットマッピング = "/test/*"; リクエスト URI="/test/a"-> "/ a"。
    E. 例: サーブレットマッピング = "/test"; リクエスト URI="/test"-> ""。
    E. 例: サーブレットマッピング = "/*.test"; リクエスト URI="/a.test"-> ""。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    サーブレットマッピング内のパス、または ""
  - getPathWithinApplication
```
public java.lang.String getPathWithinApplication(HttpServletRequestEE request)
```
    指定されたリクエストの Web アプリケーション内のパスを返します。
    RequestDispatcher include 内で呼び出された場合、include リクエスト URL を検出します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    Web アプリケーション内のパス
  - getRequestUri
```
public java.lang.String getRequestUri(HttpServletRequestEE request)
```
    指定されたリクエストのリクエスト URI を返します。RequestDispatcher インクルード内で呼び出された場合、インクルードリクエスト URL を検出します。
    request.getRequestURI() によって返される値はサーブレットコンテナーによってデコードされないため、このメソッドはそれをデコードします。
    Web コンテナーが解決する URI は正しいはずですが、JBoss/Jetty などの一部のコンテナーには ";" が誤って含まれています。URI の "; jsessionid" のような文字列。このメソッドは、このような誤った付録を切り捨てます。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    リクエスト URI
  - getContextPath
```
public java.lang.String getContextPath(HttpServletRequestEE request)
```
    RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのコンテキストパスを返します。
    request.getContextPath() によって返される値はサーブレットコンテナーによってデコードされないため、このメソッドはそれをデコードします。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    コンテキストパス
  - getServletPath
```
public java.lang.String getServletPath(HttpServletRequestEE request)
```
    RequestDispatcher インクルード内で呼び出された場合、インクルードリクエスト URL に関して、指定されたリクエストのサーブレットパスを返します。
    request.getServletPath() によって返された値はサーブレットコンテナーによってすでにデコードされているため、このメソッドはそれをデコードしようとしません。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    サーブレットのパス
  - getOriginatingRequestUri
```
public java.lang.String getOriginatingRequestUri(HttpServletRequestEE request)
```
    指定されたリクエストのリクエスト URI を返します。これが転送されたリクエストである場合、元のリクエストのリクエスト URI に正しく解決されます。
  - getOriginatingContextPath
```
public java.lang.String getOriginatingContextPath(HttpServletRequestEE request)
```
    RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのコンテキストパスを返します。
    request.getContextPath() によって返される値はサーブレットコンテナーによってデコードされないため、このメソッドはそれをデコードします。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    コンテキストパス
  - getOriginatingServletPath
```
public java.lang.String getOriginatingServletPath(HttpServletRequestEE request)
```
    RequestDispatcher インクルード内で呼び出された場合にインクルードリクエスト URL を検出して、指定されたリクエストのサーブレットパスを返します。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    サーブレットのパス
  - getOriginatingQueryString
```
public java.lang.String getOriginatingQueryString(HttpServletRequestEE request)
```
    指定されたリクエストの URL のクエリ文字列部分を返します。これが転送されたリクエストである場合、元のリクエストのクエリ文字列に正しく解決されます。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    クエリ文字列
  - decodeRequestString
```
public java.lang.String decodeRequestString(HttpServletRequestEE request,
                                            java.lang.String source)
```
    指定されたソース文字列を URLDecoder でデコードします。エンコーディングはリクエストから取得され、デフォルトの "ISO-8859-1" にフォールバックします。
    デフォルトの実装では URLDecoder.decode(input, enc) を使用します。
    パラメーター:
    request - 現在の HTTP リクエスト
    source - デコードする文字列
    戻り値:
    デコードされた文字列
    関連事項:
    WebUtils.DEFAULT_CHARACTER_ENCODING, ServletRequest.getCharacterEncoding()EE, URLDecoder.decode(String, String), URLDecoder.decode(String)
  - determineEncoding
```
protected java.lang.String determineEncoding(HttpServletRequestEE request)
```
    指定されたリクエストのエンコーディングを決定します。サブクラスでオーバーライドできます。
    デフォルトの実装では、リクエストのエンコーディングをチェックし、このリゾルバーに指定されているデフォルトのエンコーディングにフォールバックします。
    パラメーター:
    request - 現在の HTTP リクエスト
    戻り値:
    リクエストのエンコーディング (非 null)
    関連事項:
    ServletRequest.getCharacterEncoding()EE, setDefaultEncoding(java.lang.String)
  - removeSemicolonContent
```
public java.lang.String removeSemicolonContent(java.lang.String requestUri)
```
    removeSemicolonContent プロパティが "true" に設定されている場合、指定されたリクエスト URI から ";" (セミコロン) コンテンツを削除します。"jssessionid" は常に削除されることに注意してください。
    パラメーター:
    requestUri - 削除するリクエスト URI 文字列 ";" からのコンテンツ
    戻り値:
    更新された URI 文字列
  - decodePathVariables
```
public java.util.Map<java.lang.String,java.lang.String> decodePathVariables(HttpServletRequestEE request,
                                                                            java.util.Map<java.lang.String,java.lang.String> vars)
```
    setUrlDecode(boolean) が true に設定されていない限り、指定された URI パス変数を decodeRequestString(HttpServletRequest, String) を介してデコードします。この場合、変数の抽出元の URL パスは getLookupPathForRequest(HttpServletRequest) の呼び出しによってすでにデコードされていると見なされます。
    パラメーター:
    request - 現在の HTTP リクエスト
    vars - URL パスから抽出された URI 変数
    戻り値:
    同じ Map または新しい Map インスタンス
  - decodeMatrixVariables
```
public MultiValueMap<java.lang.String,java.lang.String> decodeMatrixVariables(HttpServletRequestEE request,
                                                                              MultiValueMap<java.lang.String,java.lang.String> vars)
```
    setUrlDecode(boolean) が true に設定されていない限り、指定されたマトリックス変数を decodeRequestString(HttpServletRequest, String) を介してデコードします。この場合、変数の抽出元の URL パスは getLookupPathForRequest(HttpServletRequest) の呼び出しによってすでにデコードされていると見なされます。
    パラメーター:
    request - 現在の HTTP リクエスト
    vars - URL パスから抽出された URI 変数
    戻り値:
    同じ Map または新しい Map インスタンス

クラス UrlPathHelper

コンストラクターの概要

メソッドのサマリー

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

コンストラクターの詳細

UrlPathHelper

メソッドの詳細

setAlwaysUseFullPath

setUrlDecode

isUrlDecode

setRemoveSemicolonContent

shouldRemoveSemicolonContent

setDefaultEncoding

getDefaultEncoding

getLookupPathForRequest

getPathWithinServletMapping

getPathWithinApplication

getRequestUri

getContextPath

getServletPath

getOriginatingRequestUri

getOriginatingContextPath

getOriginatingServletPath

getOriginatingQueryString

decodeRequestString

determineEncoding

removeSemicolonContent

decodePathVariables

decodeMatrixVariables