类 PathPatternParser


  • public class PathPatternParser
    extends Object
    Parser for URI path patterns producing PathPattern instances that can then be matched to requests.

    The PathPatternParser and PathPattern are specifically designed for use with HTTP URL paths in web applications where a large number of URI path patterns, continuously matched against incoming requests, motivates the need for efficient matching.

    For details of the path pattern syntax see PathPattern.

    从以下版本开始:
    5.0
    作者:
    Andy Clement
    • 字段详细资料

      • defaultInstance

        public static final PathPatternParser defaultInstance
        Shared, read-only instance of PathPatternParser. Uses default settings:
        • matchOptionalTrailingSeparator=true
        • caseSensitivetrue
        • pathOptions=PathContainer.Options.HTTP_PATH
    • 方法详细资料

      • setMatchOptionalTrailingSeparator

        public void setMatchOptionalTrailingSeparator​(boolean matchOptionalTrailingSeparator)
        Whether a PathPattern produced by this parser should automatically match request paths with a trailing slash.

        If set to true a PathPattern without a trailing slash will also match request paths with a trailing slash. If set to false a PathPattern will only match request paths with a trailing slash.

        The default is true.

      • setCaseSensitive

        public void setCaseSensitive​(boolean caseSensitive)
        Whether path pattern matching should be case-sensitive.

        The default is true.

      • isCaseSensitive

        public boolean isCaseSensitive()
        Whether case-sensitive pattern matching is enabled.
      • parse

        public PathPattern parse​(String pathPattern)
                          throws PatternParseException
        Process the path pattern content, a character at a time, breaking it into path elements around separator boundaries and verifying the structure at each stage. Produces a PathPattern object that can be used for fast matching against paths. Each invocation of this method delegates to a new instance of the InternalPathPatternParser because that class is not thread-safe.
        参数:
        pathPattern - the input path pattern, e.g. /project/{name}
        返回:
        a PathPattern for quickly matching paths against request paths
        抛出:
        PatternParseException - in case of parse errors