クラス PatternsRequestCondition
java.lang.ObjectSE
org.springframework.web.servlet.mvc.condition.AbstractRequestCondition<PatternsRequestCondition>
org.springframework.web.servlet.mvc.condition.PatternsRequestCondition
- 実装されたすべてのインターフェース:
RequestCondition<PatternsRequestCondition>
一連の URL パスパターンに対するリクエストと一致する論理和('| |')リクエスト条件。
解析された PathPattern
を使用する PathPatternsRequestCondition
とは対照的に、この条件は AntPathMatcher
を介して文字列パターンマッチングを実行します。
- 導入:
- 3.1
- 作成者:
- Rossen Stoyanchev
コンストラクターのサマリー
コンストラクターコンストラクター説明PatternsRequestCondition
(StringSE... patterns) 必要に応じて "/" が前に付いた URL パターンを持つコンストラクター。PatternsRequestCondition
(StringSE[] patterns, boolean useTrailingSlashMatch, PathMatcher pathMatcher) PathMatcher
と末尾のスラッシュを一致させるためのフラグを持つPatternsRequestCondition(String...)
のバリアント。PatternsRequestCondition
(StringSE[] patterns, UrlPathHelper urlPathHelper, PathMatcher pathMatcher, boolean useTrailingSlashMatch) 使用すべきではありません。PatternsRequestCondition
(StringSE[] patterns, UrlPathHelper urlPathHelper, PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch) 使用すべきではありません。5.2.4 現在。PatternsRequestCondition
(StringSE[] patterns, UrlPathHelper urlPathHelper, PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch, ListSE<StringSE> fileExtensions) 使用すべきではありません。5.2.4 現在。メソッドのサマリー
修飾子と型メソッド説明combine
(PatternsRequestCondition other) 次のように、現在のインスタンス("this" )と「その他」のインスタンスからの URL パターンを含む新しいインスタンスを返します。両方のインスタンスにパターンがある場合は、"this" のパターンをPathMatcher.combine(String, String)
を使用して「その他」のパターンと組み合わせます。int
compareTo
(PatternsRequestCondition other, HttpServletRequestEE request) 含まれている URL パターンに基づいて 2 つの条件を比較します。protected CollectionSE<StringSE>
リクエスト条件を構成する個別のアイテムを返します。パターンではないマッピングパスを返します。getMatchingCondition
(HttpServletRequestEE request) パターンのいずれかが指定されたリクエストと一致するかどうかを確認し、PathMatcher.getPatternComparator(String)
でソートされた、一致するパターンを含むことが保証されているインスタンスを返します。getMatchingPatterns
(StringSE lookupPath) 指定されたルックアップパスに一致するパターンを検索します。protected StringSE
コンテンツの個別のアイテムを出力するときに使用する表記。boolean
条件が ""(空のパス)マッピングであるかどうか。クラス org.springframework.web.servlet.mvc.condition.AbstractRequestCondition から継承されたメソッド
equals, hashCode, isEmpty, toString
コンストラクターの詳細
PatternsRequestCondition
必要に応じて "/" が前に付いた URL パターンを持つコンストラクター。- パラメーター:
patterns
- 0 個以上の URL パターン。パターンがない場合、すべてのリクエストに一致する空のパス""
マッピングが生成されます。
PatternsRequestCondition
public PatternsRequestCondition(StringSE[] patterns, boolean useTrailingSlashMatch, @Nullable PathMatcher pathMatcher) PathMatcher
と末尾のスラッシュを一致させるためのフラグを持つPatternsRequestCondition(String...)
のバリアント。- 導入:
- 5.3
PatternsRequestCondition
@DeprecatedSE public PatternsRequestCondition(StringSE[] patterns, @Nullable UrlPathHelper urlPathHelper, @Nullable PathMatcher pathMatcher, boolean useTrailingSlashMatch) 使用すべきではありません。PatternsRequestCondition(String...)
とUrlPathHelper
およびPathMatcher
のバリアント、および末尾のスラッシュと一致するかどうか。5.3 では、パスは静的メソッド
UrlPathHelper.getResolvedLookupPath(jakarta.servlet.ServletRequest)
を介して取得され、UrlPathHelper
を渡す必要はありません。- 導入:
- 5.2.4
PatternsRequestCondition
@DeprecatedSE public PatternsRequestCondition(StringSE[] patterns, @Nullable UrlPathHelper urlPathHelper, @Nullable PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch) 使用すべきではありません。5.2.4 現在。パス拡張設定オプションの非推奨については、RequestMappingHandlerMapping
のクラスレベルの注意を参照してください。UrlPathHelper
およびPathMatcher
を含むPatternsRequestCondition(String...)
のバリアント、および接尾辞と末尾のスラッシュと一致するフラグ。5.3 では、パスは静的メソッド
UrlPathHelper.getResolvedLookupPath(jakarta.servlet.ServletRequest)
を介して取得され、UrlPathHelper
を渡す必要はありません。PatternsRequestCondition
@DeprecatedSE public PatternsRequestCondition(StringSE[] patterns, @Nullable UrlPathHelper urlPathHelper, @Nullable PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch, @Nullable ListSE<StringSE> fileExtensions) 使用すべきではありません。5.2.4 現在。パス拡張設定オプションの非推奨については、RequestMappingHandlerMapping
のクラスレベルの注意を参照してください。UrlPathHelper
およびPathMatcher
を含むPatternsRequestCondition(String...)
のバリアント、および特定の拡張子とともに、接尾辞および末尾のスラッシュと照合するためのフラグ。5.3 では、パスは静的メソッド
UrlPathHelper.getResolvedLookupPath(jakarta.servlet.ServletRequest)
を介して取得され、UrlPathHelper
を渡す必要はありません。
メソッドの詳細
getPatterns
getContent
クラスからコピーされた説明:AbstractRequestCondition
リクエスト条件を構成する個別のアイテムを返します。たとえば、URL パターン、HTTP リクエストメソッド、パラメーター式など。
- 次で指定:
- クラス
AbstractRequestCondition<PatternsRequestCondition>
のgetContent
- 戻り値:
- オブジェクトのコレクション (非
null
)
getToStringInfix
クラスからコピーされた説明:AbstractRequestCondition
コンテンツの個別のアイテムを出力するときに使用する表記。たとえば、URL パターンの
" || "
または param 式の" && "
。isEmptyPathMapping
public boolean isEmptyPathMapping()条件が ""(空のパス)マッピングであるかどうか。getDirectPaths
パターンではないマッピングパスを返します。- 導入:
- 5.3
combine
次のように、現在のインスタンス("this" )と「その他」のインスタンスからの URL パターンを持つ新しいインスタンスを返します。- 両方のインスタンスにパターンがある場合は、"this" のパターンを
PathMatcher.combine(String, String)
を使用して「その他」のパターンと組み合わせます。 - 1 つのインスタンスのみにパターンがある場合は、使用します。
- どちらのインスタンスにもパターンがない場合は、空の文字列("" など)を使用します。
- パラメーター:
other
- 組み合わせる条件。- 戻り値:
- 2 つの条件インスタンスを組み合わせた結果であるリクエスト条件インスタンス。
- 両方のインスタンスにパターンがある場合は、"this" のパターンを
getMatchingCondition
パターンのいずれかが指定されたリクエストと一致するかどうかを確認し、PathMatcher.getPatternComparator(String)
でソートされた、一致するパターンを含むことが保証されているインスタンスを返します。一致するパターンは、次の順序でチェックを行うことによって取得されます。
- 直接一致
- パターンにまだ "." が含まれていない場合は、".*" を追加したパターンマッチ。
- パターンマッチ
- パターンが "/" で終わっていない場合、"/" を追加したパターンマッチ
- パラメーター:
request
- 現在のリクエスト- 戻り値:
- 条件にパターンが含まれていない場合も同じインスタンス。または、ソートされた一致パターンを持つ新しい条件。一致するパターンがない場合は
null
。
getMatchingPatterns
指定されたルックアップパスに一致するパターンを検索します。このメソッドを呼び出すと、getMatchingCondition(jakarta.servlet.http.HttpServletRequest)
を呼び出した場合と同等の結果が得られます。このメソッドは、リクエストが利用できない場合に使用される代替手段として提供されます(イントロスペクション、ツールなど)。- パラメーター:
lookupPath
- 既存のパターンに一致するルックアップパス- 戻り値:
- 最上位に最も近い一致でソートされた一致するパターンのコレクション
compareTo
含まれている URL パターンに基づいて 2 つの条件を比較します。パターンはPathMatcher.getPatternComparator(String)
を介して上から下に一度に 1 つずつ比較されます。比較されたすべてのパターンが同等に一致するが、1 つのインスタンスにさらに多くのパターンがある場合、より近い一致と見なされます。両方のインスタンスが
getMatchingCondition(HttpServletRequest)
を介して取得され、リクエストに一致するパターンのみが含まれ、最も一致するものが上にソートされることを前提としています。
PatternsRequestCondition(String[], boolean, PathMatcher)
を推奨