クラス PathPatternParser

java.lang.ObjectSE
org.springframework.web.util.pattern.PathPatternParser

public class PathPatternParser extends ObjectSE
リクエストと照合できる PathPattern インスタンスを生成する URI パスパターンのパーサー。

PathPatternParser および PathPattern は、受信リクエストに対して継続的に照合される多数の URI パスパターンが効率的な照合の必要性を刺激する Web アプリケーションの HTTP URL パスで使用するように特別に設計されています。

パスパターン構文の詳細については、PathPattern を参照してください。

導入:
5.0
作成者:
Andy Clement
  • フィールドの詳細

    • defaultInstance

      public static final PathPatternParser defaultInstance
      PathPatternParser の共有の読み取り専用インスタンス。

      デフォルト設定を使用します。

      • matchOptionalTrailingSeparator = false
      • caseSensitive = true
      • pathOptions = PathContainer.Options.HTTP_PATH
  • コンストラクターの詳細

    • PathPatternParser

      public PathPatternParser()
  • メソッドの詳細

    • setMatchOptionalTrailingSeparator

      @DeprecatedSE(since="6.0") public void setMatchOptionalTrailingSeparator(boolean matchOptionalTrailingSeparator)
      使用すべきではありません。
      末尾のスラッシュの透過的なサポートは、プロキシ、サーブレット /Web フィルター、またはコントローラーを介して明示的なリダイレクトを構成することを推奨して、6.0 の時点で非推奨です。
      このパーサーによって生成された PathPattern が末尾のスラッシュを持つリクエストパスと自動的に一致するかどうかを構成します。

      true に設定すると、末尾にスラッシュがない PathPattern も、末尾にスラッシュがあるリクエストパスに一致します。false に設定した場合、PathPattern は、末尾のスラッシュを含むリクエストパスのみに一致します。

      プロパティの非推奨をサポートするために、6.0 でデフォルトが true から false に変更されました。

    • isMatchOptionalTrailingSeparator

      @DeprecatedSE(since="6.0") public boolean isMatchOptionalTrailingSeparator()
      使用すべきではありません。
      オプションの末尾スラッシュ一致を有効にするかどうか。
    • setCaseSensitive

      public void setCaseSensitive(boolean caseSensitive)
      パスパターンマッチングで大文字と小文字を区別するかどうかを構成します。

      デフォルトは true です。

    • isCaseSensitive

      public boolean isCaseSensitive()
      大文字と小文字を区別するパターンマッチングを有効にするかどうか。
    • setPathOptions

      public void setPathOptions(PathContainer.Options pathOptions)
      パターンを解析するためのオプションを設定します。これらは、入力パスの解析に使用されるオプションと同じである必要があります。

      PathContainer.Options.HTTP_PATH がデフォルトで使用されます。

      導入:
      5.2
    • getPathOptions

      public PathContainer.Options getPathOptions()
      configured パターン解析オプションを取得します。
      導入:
      5.2
    • initFullPathPattern

      public StringSE initFullPathPattern(StringSE pattern)
      完全な URL パスとの照合に使用するために、指定されたパターンを準備します。

      デフォルトでは、空ではないパターンの場合、必要に応じて先頭にスラッシュが追加されます。

      パラメーター:
      pattern - 初期化するパターン
      戻り値:
      更新されたパターン
      導入:
      5.2.25
    • parse

      public PathPattern parse(StringSE pathPattern) throws PatternParseException
      パスパターンのコンテンツを一度に 1 文字ずつ処理し、それを区切りの境界の周囲のパス要素に分割し、各段階で構造を確認します。パスとの高速マッチングに使用できる PathPattern オブジェクトを生成します。このクラスはスレッドセーフではないため、このメソッドを呼び出すたびに InternalPathPatternParser の新しいインスタンスに委譲されます。
      パラメーター:
      pathPattern - 入力パスパターン(例:/project/{name}
      戻り値:
      リクエストパスに対してパスをすばやく照合するための PathPattern
      例外:
      PatternParseException - 解析エラーの場合