PatternsRequestCondition (Spring Framework API)

java.lang.ObjectSE
- org.springframework.web.servlet.mvc.condition.AbstractRequestCondition<PatternsRequestCondition>
- - org.springframework.web.servlet.mvc.condition.PatternsRequestCondition

実装されたすべてのインターフェース:
RequestCondition<PatternsRequestCondition>
```
public class PatternsRequestCondition
extends AbstractRequestCondition<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)` 使用すべきではありません。 5.3 現在、`PatternsRequestCondition(String[], boolean, PathMatcher)` を推奨
`PatternsRequestCondition(StringSE[] patterns, UrlPathHelper urlPathHelper, PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch)` 使用すべきではありません。 5.2.4 現在。パス拡張設定オプションの非推奨については、`RequestMappingHandlerMapping` のクラスレベルの注意を参照してください。
`PatternsRequestCondition(StringSE[] patterns, UrlPathHelper urlPathHelper, PathMatcher pathMatcher, boolean useSuffixPatternMatch, boolean useTrailingSlashMatch, ListSE<StringSE> fileExtensions)` 使用すべきではありません。 5.2.4 現在。パス拡張設定オプションの非推奨については、`RequestMappingHandlerMapping` のクラスレベルの注意を参照してください。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`PatternsRequestCondition`	`combine(PatternsRequestCondition other)` 次のように、現在のインスタンス（"this" ）と「その他」のインスタンスからの URL パターンを含む新しいインスタンスを返します。両方のインスタンスにパターンがある場合は、"this" のパターンを `PathMatcher.combine(String, String)` を使用して「その他」のパターンと組み合わせます。
`int`	`compareTo(PatternsRequestCondition other, HttpServletRequestEE request)` 含まれている URL パターンに基づいて 2 つの条件を比較します。
`protected CollectionSE<StringSE>`	`getContent()` リクエスト条件を構成する個別のアイテムを返します。
`SetSE<StringSE>`	`getDirectPaths()` パターンではないマッピングパスを返します。
`PatternsRequestCondition`	`getMatchingCondition(HttpServletRequestEE request)` パターンのいずれかが指定されたリクエストと一致するかどうかを確認し、`PathMatcher.getPatternComparator(String)` でソートされた、一致するパターンを含むことが保証されているインスタンスを返します。
`ListSE<StringSE>`	`getMatchingPatterns(StringSE lookupPath)` 指定されたルックアップパスに一致するパターンを検索します。
`SetSE<StringSE>`	`getPatterns()`
`protected StringSE`	`getToStringInfix()` コンテンツの個別のアイテムを出力するときに使用する表記。
`boolean`	`isEmptyPathMapping()` 条件が ""（空のパス）マッピングであるかどうか。

クラス org.springframework.web.servlet.mvc.condition.AbstractRequestCondition から継承されたメソッド
equals, hashCode, isEmpty, toString

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

- コンストラクターの詳細
  - PatternsRequestCondition
```
public PatternsRequestCondition(StringSE... patterns)
```
    必要に応じて "/" が前に付いた 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)
```
    非推奨。5.3 の時点で PatternsRequestCondition(String[], boolean, PathMatcher) が優先されます。
    PatternsRequestCondition(String...) と UrlPathHelper および PathMatcher のバリアント、および末尾のスラッシュと一致するかどうか。
    5.3 では、パスは静的メソッド UrlPathHelper.getResolvedLookupPath(javax.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(javax.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(javax.servlet.ServletRequest) を介して取得され、UrlPathHelper を渡す必要はありません。
- メソッドの詳細
  - getPatterns
```
public SetSE<StringSE> getPatterns()
```
  - getContent
```
protected CollectionSE<StringSE> getContent()
```
    クラスからコピーされた説明: AbstractRequestCondition
    リクエスト条件を構成する個別のアイテムを返します。
    たとえば、URL パターン、HTTP リクエストメソッド、パラメーター式など。
    次で指定:
    クラス AbstractRequestCondition<PatternsRequestCondition> の getContent
    戻り値:
    オブジェクトのコレクション (非 null)
  - getToStringInfix
```
protected StringSE getToStringInfix()
```
    クラスからコピーされた説明: AbstractRequestCondition
    コンテンツの個別のアイテムを出力するときに使用する表記。
    たとえば、URL パターンの " || " または param 式の " && "。
    次で指定:
    クラス AbstractRequestCondition<PatternsRequestCondition> の getToStringInfix
  - isEmptyPathMapping
```
public boolean isEmptyPathMapping()
```
    条件が ""（空のパス）マッピングであるかどうか。
  - getDirectPaths
```
public SetSE<StringSE> getDirectPaths()
```
    パターンではないマッピングパスを返します。
    導入:
    5.3
  - combine
```
public PatternsRequestCondition combine(PatternsRequestCondition other)
```
    次のように、現在のインスタンス（"this" ）と「その他」のインスタンスからの URL パターンを持つ新しいインスタンスを返します。
    - 両方のインスタンスにパターンがある場合は、"this" のパターンを PathMatcher.combine(String, String) を使用して「その他」のパターンと組み合わせます。
    - 1 つのインスタンスのみにパターンがある場合は、使用します。
    - どちらのインスタンスにもパターンがない場合は、空の文字列（"" など）を使用します。
    パラメーター:
    other - 組み合わせる条件。
    戻り値:
    2 つの条件インスタンスを組み合わせた結果であるリクエスト条件インスタンス。
  - getMatchingCondition
```
@Nullable
public PatternsRequestCondition getMatchingCondition(HttpServletRequestEE request)
```
    パターンのいずれかが指定されたリクエストと一致するかどうかを確認し、PathMatcher.getPatternComparator(String) でソートされた、一致するパターンを含むことが保証されているインスタンスを返します。
    一致するパターンは、次の順序でチェックを行うことによって取得されます。
    - 直接一致
    - パターンにまだ "." が含まれていない場合は、".*" を追加したパターンマッチ。
    - パターンマッチ
    - パターンが "/" で終わっていない場合、"/" を追加したパターンマッチ
    パラメーター:
    request - 現在のリクエスト
    戻り値:
    条件にパターンが含まれていない場合も同じインスタンス。または、ソートされた一致パターンを持つ新しい条件。一致するパターンがない場合は null。
  - getMatchingPatterns
```
public ListSE<StringSE> getMatchingPatterns(StringSE lookupPath)
```
    指定されたルックアップパスに一致するパターンを検索します。このメソッドを呼び出すと、getMatchingCondition(javax.servlet.http.HttpServletRequest) を呼び出した場合と同等の結果が得られます。このメソッドは、リクエストが利用できない場合に使用される代替手段として提供されます（イントロスペクション、ツールなど）。
    パラメーター:
    lookupPath - 既存のパターンに一致するルックアップパス
    戻り値:
    最上位に最も近い一致でソートされた一致するパターンのコレクション
  - compareTo
```
public int compareTo(PatternsRequestCondition other,
                     HttpServletRequestEE request)
```
    含まれている URL パターンに基づいて 2 つの条件を比較します。パターンは PathMatcher.getPatternComparator(String) を介して上から下に一度に 1 つずつ比較されます。比較されたすべてのパターンが同等に一致するが、1 つのインスタンスにさらに多くのパターンがある場合、より近い一致と見なされます。
    両方のインスタンスが getMatchingCondition(HttpServletRequest) を介して取得され、リクエストに一致するパターンのみが含まれ、最も一致するものが上にソートされることを前提としています。

クラス PatternsRequestCondition

コンストラクターのサマリー

メソッドのサマリー

クラス org.springframework.web.servlet.mvc.condition.AbstractRequestCondition から継承されたメソッド

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

コンストラクターの詳細

PatternsRequestCondition

PatternsRequestCondition

PatternsRequestCondition

PatternsRequestCondition

PatternsRequestCondition

メソッドの詳細

getPatterns

getContent

getToStringInfix

isEmptyPathMapping

getDirectPaths

combine

getMatchingCondition

getMatchingPatterns

compareTo