Spring/SpringBoot--路径匹配/AntPathMatcher--使用/实例/教程

Dear 丶 2022-09-15 05:47 568阅读 0赞

原文网址：[Spring/SpringBoot--路径匹配/AntPathMatcher--使用/实例/教程\_IT利刃出鞘的博客-CSDN博客][Spring_SpringBoot--_AntPathMatcher--_IT_-CSDN]

# **简介** #

整个Spring框架的路径解析都是按照Ant的风格来的，比如：Controller的请求路径、文件路径、包的路径。所以，掌握Ant的路径匹配很重要。

Spring中的具体实现： org.springframework.util.AntPathMatcher。其注释里边有解释，翻译成中文如下表：

<table> 
 <tbody> 
 <tr> 
 <td>符号</td> 
 <td>作用</td> 
 <td>示例</td> 
 </tr> 
 <tr> 
 <td>?</td> 
 <td> 匹配一个字符。 不能匹配目录：这个字符不能是代表路径分隔符的<code>/</code> </td> 
 <td> /dir/app? 匹配：/dir/app1、/dir/app2 不匹配：/dir/app、/dir/app12、index/ </td> 
 </tr> 
 <tr> 
 <td>*</td> 
 <td> 匹配0到多个字符。 </td> 
 <td> /dir/app* 匹配：/dir/app、/dir/app1、/dir/app12、/dir/appa/ 不匹配：/dir/app/a </td> 
 </tr> 
 <tr> 
 <td>**</td> 
 <td>匹配多级目录。</td> 
 <td> /dir/**/app* 匹配：/dir/xxx/app* /dir/xxx/yyy/app* </td> 
 </tr> 
 <tr> 
 <td>{spring:[a-z]+}</td> 
 <td>将正则表达式[a-z]+匹配到的值,赋值给名为 spring 的路径变量.(PS:必须是完全匹配才行,在SpringMVC中只有完全匹配才会进入controller层的方法)</td> 
 <td> @RequestMapping("/index/{username:[a-b]+}") @ResponseBody public String index(@PathVariable("username") String username){ &nbsp; &nbsp; System.out.println(username); &nbsp; &nbsp; return username; } 结果 index/ab&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;true &nbsp;输出 ab index/abbaaa &nbsp; &nbsp;true &nbsp;输出 abbaaa index/a&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;false 404错误 index/ac&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; false 404错误 </td> 
 </tr> 
 </tbody> 
</table>

# **大全（有实例）** #

摘录自Spring的官网测试，不得不说 Spring 的测试用例写的实在是太完善了。

其网址为：[https://github.com/spring-projects/spring-framework/blob/main/spring-core/src/test/java/org/springframework/util/AntPathMatcherTests.java][https_github.com_spring-projects_spring-framework_blob_main_spring-core_src_test_java_org_springframework_util_AntPathMatcherTests.java]

其测试太长了，本处将其分类。

下边这行是公共代码：

private final AntPathMatcher pathMatcher = new AntPathMatcher();

## match ##

// test exact matching
    assertThat(pathMatcher.match("test", "test")).isTrue();
    assertThat(pathMatcher.match("/test", "/test")).isTrue();
    // SPR-14141
    assertThat(pathMatcher.match("https://example.org", "https://example.org")).isTrue();
    assertThat(pathMatcher.match("/test.jpg", "test.jpg")).isFalse();
    assertThat(pathMatcher.match("test", "/test")).isFalse();
    assertThat(pathMatcher.match("/test", "test")).isFalse();
    
    // test matching with ?'s
    assertThat(pathMatcher.match("t?st", "test")).isTrue();
    assertThat(pathMatcher.match("??st", "test")).isTrue();
    assertThat(pathMatcher.match("tes?", "test")).isTrue();
    assertThat(pathMatcher.match("te??", "test")).isTrue();
    assertThat(pathMatcher.match("?es?", "test")).isTrue();
    assertThat(pathMatcher.match("tes?", "tes")).isFalse();
    assertThat(pathMatcher.match("tes?", "testt")).isFalse();
    assertThat(pathMatcher.match("tes?", "tsst")).isFalse();
    
    // test matching with *'s
    assertThat(pathMatcher.match("*", "test")).isTrue();
    assertThat(pathMatcher.match("test*", "test")).isTrue();
    assertThat(pathMatcher.match("test*", "testTest")).isTrue();
    assertThat(pathMatcher.match("test/*", "test/Test")).isTrue();
    assertThat(pathMatcher.match("test/*", "test/t")).isTrue();
    assertThat(pathMatcher.match("test/*", "test/")).isTrue();
    assertThat(pathMatcher.match("*test*", "AnothertestTest")).isTrue();
    assertThat(pathMatcher.match("*test", "Anothertest")).isTrue();
    assertThat(pathMatcher.match("*.*", "test.")).isTrue();
    assertThat(pathMatcher.match("*.*", "test.test")).isTrue();
    assertThat(pathMatcher.match("*.*", "test.test.test")).isTrue();
    assertThat(pathMatcher.match("test*aaa", "testblaaaa")).isTrue();
    assertThat(pathMatcher.match("test*", "tst")).isFalse();
    assertThat(pathMatcher.match("test*", "tsttest")).isFalse();
    assertThat(pathMatcher.match("test*", "test/")).isFalse();
    assertThat(pathMatcher.match("test*", "test/t")).isFalse();
    assertThat(pathMatcher.match("test/*", "test")).isFalse();
    assertThat(pathMatcher.match("*test*", "tsttst")).isFalse();
    assertThat(pathMatcher.match("*test", "tsttst")).isFalse();
    assertThat(pathMatcher.match("*.*", "tsttst")).isFalse();
    assertThat(pathMatcher.match("test*aaa", "test")).isFalse();
    assertThat(pathMatcher.match("test*aaa", "testblaaab")).isFalse();
    
    // test matching with ?'s and /'s
    assertThat(pathMatcher.match("/?", "/a")).isTrue();
    assertThat(pathMatcher.match("/?/a", "/a/a")).isTrue();
    assertThat(pathMatcher.match("/a/?", "/a/b")).isTrue();
    assertThat(pathMatcher.match("/??/a", "/aa/a")).isTrue();
    assertThat(pathMatcher.match("/a/??", "/a/bb")).isTrue();
    assertThat(pathMatcher.match("/?", "/a")).isTrue();
    
    // test matching with **'s
    assertThat(pathMatcher.match("/**", "/testing/testing")).isTrue();
    assertThat(pathMatcher.match("/*/**", "/testing/testing")).isTrue();
    assertThat(pathMatcher.match("/**/*", "/testing/testing")).isTrue();
    assertThat(pathMatcher.match("/bla/**/bla", "/bla/testing/testing/bla")).isTrue();
    assertThat(pathMatcher.match("/bla/**/bla", "/bla/testing/testing/bla/bla")).isTrue();
    assertThat(pathMatcher.match("/**/test", "/bla/bla/test")).isTrue();
    assertThat(pathMatcher.match("/bla/**/**/bla", "/bla/bla/bla/bla/bla/bla")).isTrue();
    assertThat(pathMatcher.match("/bla*bla/test", "/blaXXXbla/test")).isTrue();
    assertThat(pathMatcher.match("/*bla/test", "/XXXbla/test")).isTrue();
    assertThat(pathMatcher.match("/bla*bla/test", "/blaXXXbl/test")).isFalse();
    assertThat(pathMatcher.match("/*bla/test", "XXXblab/test")).isFalse();
    assertThat(pathMatcher.match("/*bla/test", "XXXbl/test")).isFalse();
    
    assertThat(pathMatcher.match("/????", "/bala/bla")).isFalse();
    assertThat(pathMatcher.match("/**/*bla", "/bla/bla/bla/bbb")).isFalse();
    
    assertThat(pathMatcher.match("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing/")).isTrue();
    assertThat(pathMatcher.match("/*bla*/**/bla/*", "/XXXblaXXXX/testing/testing/bla/testing")).isTrue();
    assertThat(pathMatcher.match("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing")).isTrue();
    assertThat(pathMatcher.match("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing.jpg")).isTrue();
    
    assertThat(pathMatcher.match("*bla*/**/bla/**", "XXXblaXXXX/testing/testing/bla/testing/testing/")).isTrue();
    assertThat(pathMatcher.match("*bla*/**/bla/*", "XXXblaXXXX/testing/testing/bla/testing")).isTrue();
    assertThat(pathMatcher.match("*bla*/**/bla/**", "XXXblaXXXX/testing/testing/bla/testing/testing")).isTrue();
    assertThat(pathMatcher.match("*bla*/**/bla/*", "XXXblaXXXX/testing/testing/bla/testing/testing")).isFalse();
    
    assertThat(pathMatcher.match("/x/x/**/bla", "/x/x/x/")).isFalse();
    
    assertThat(pathMatcher.match("/foo/bar/**", "/foo/bar")).isTrue();
    
    assertThat(pathMatcher.match("", "")).isTrue();
    
    assertThat(pathMatcher.match("/{bla}.*", "/testing.html")).isTrue();
    assertThat(pathMatcher.match("/{bla}", "//x\ny")).isTrue();

## matchWithNullPath ##

assertThat(pathMatcher.match("/test", null)).isFalse();
    assertThat(pathMatcher.match("/", null)).isFalse();
    assertThat(pathMatcher.match(null, null)).isFalse();

## matchWithTrimTokensEnabled ##

pathMatcher.setTrimTokens(true);
    
    assertThat(pathMatcher.match("/foo/bar", "/foo /bar")).isTrue();

## matchStart ##

// test exact matching
    assertThat(pathMatcher.matchStart("test", "test")).isTrue();
    assertThat(pathMatcher.matchStart("/test", "/test")).isTrue();
    assertThat(pathMatcher.matchStart("/test.jpg", "test.jpg")).isFalse();
    assertThat(pathMatcher.matchStart("test", "/test")).isFalse();
    assertThat(pathMatcher.matchStart("/test", "test")).isFalse();
    
    // test matching with ?'s
    assertThat(pathMatcher.matchStart("t?st", "test")).isTrue();
    assertThat(pathMatcher.matchStart("??st", "test")).isTrue();
    assertThat(pathMatcher.matchStart("tes?", "test")).isTrue();
    assertThat(pathMatcher.matchStart("te??", "test")).isTrue();
    assertThat(pathMatcher.matchStart("?es?", "test")).isTrue();
    assertThat(pathMatcher.matchStart("tes?", "tes")).isFalse();
    assertThat(pathMatcher.matchStart("tes?", "testt")).isFalse();
    assertThat(pathMatcher.matchStart("tes?", "tsst")).isFalse();
    
    // test matching with *'s
    assertThat(pathMatcher.matchStart("*", "test")).isTrue();
    assertThat(pathMatcher.matchStart("test*", "test")).isTrue();
    assertThat(pathMatcher.matchStart("test*", "testTest")).isTrue();
    assertThat(pathMatcher.matchStart("test/*", "test/Test")).isTrue();
    assertThat(pathMatcher.matchStart("test/*", "test/t")).isTrue();
    assertThat(pathMatcher.matchStart("test/*", "test/")).isTrue();
    assertThat(pathMatcher.matchStart("*test*", "AnothertestTest")).isTrue();
    assertThat(pathMatcher.matchStart("*test", "Anothertest")).isTrue();
    assertThat(pathMatcher.matchStart("*.*", "test.")).isTrue();
    assertThat(pathMatcher.matchStart("*.*", "test.test")).isTrue();
    assertThat(pathMatcher.matchStart("*.*", "test.test.test")).isTrue();
    assertThat(pathMatcher.matchStart("test*aaa", "testblaaaa")).isTrue();
    assertThat(pathMatcher.matchStart("test*", "tst")).isFalse();
    assertThat(pathMatcher.matchStart("test*", "test/")).isFalse();
    assertThat(pathMatcher.matchStart("test*", "tsttest")).isFalse();
    assertThat(pathMatcher.matchStart("test*", "test/")).isFalse();
    assertThat(pathMatcher.matchStart("test*", "test/t")).isFalse();
    assertThat(pathMatcher.matchStart("test/*", "test")).isTrue();
    assertThat(pathMatcher.matchStart("test/t*.txt", "test")).isTrue();
    assertThat(pathMatcher.matchStart("*test*", "tsttst")).isFalse();
    assertThat(pathMatcher.matchStart("*test", "tsttst")).isFalse();
    assertThat(pathMatcher.matchStart("*.*", "tsttst")).isFalse();
    assertThat(pathMatcher.matchStart("test*aaa", "test")).isFalse();
    assertThat(pathMatcher.matchStart("test*aaa", "testblaaab")).isFalse();
    
    // test matching with ?'s and /'s
    assertThat(pathMatcher.matchStart("/?", "/a")).isTrue();
    assertThat(pathMatcher.matchStart("/?/a", "/a/a")).isTrue();
    assertThat(pathMatcher.matchStart("/a/?", "/a/b")).isTrue();
    assertThat(pathMatcher.matchStart("/??/a", "/aa/a")).isTrue();
    assertThat(pathMatcher.matchStart("/a/??", "/a/bb")).isTrue();
    assertThat(pathMatcher.matchStart("/?", "/a")).isTrue();
    
    // test matching with **'s
    assertThat(pathMatcher.matchStart("/**", "/testing/testing")).isTrue();
    assertThat(pathMatcher.matchStart("/*/**", "/testing/testing")).isTrue();
    assertThat(pathMatcher.matchStart("/**/*", "/testing/testing")).isTrue();
    assertThat(pathMatcher.matchStart("test*/**", "test/")).isTrue();
    assertThat(pathMatcher.matchStart("test*/**", "test/t")).isTrue();
    assertThat(pathMatcher.matchStart("/bla/**/bla", "/bla/testing/testing/bla")).isTrue();
    assertThat(pathMatcher.matchStart("/bla/**/bla", "/bla/testing/testing/bla/bla")).isTrue();
    assertThat(pathMatcher.matchStart("/**/test", "/bla/bla/test")).isTrue();
    assertThat(pathMatcher.matchStart("/bla/**/**/bla", "/bla/bla/bla/bla/bla/bla")).isTrue();
    assertThat(pathMatcher.matchStart("/bla*bla/test", "/blaXXXbla/test")).isTrue();
    assertThat(pathMatcher.matchStart("/*bla/test", "/XXXbla/test")).isTrue();
    assertThat(pathMatcher.matchStart("/bla*bla/test", "/blaXXXbl/test")).isFalse();
    assertThat(pathMatcher.matchStart("/*bla/test", "XXXblab/test")).isFalse();
    assertThat(pathMatcher.matchStart("/*bla/test", "XXXbl/test")).isFalse();
    
    assertThat(pathMatcher.matchStart("/????", "/bala/bla")).isFalse();
    assertThat(pathMatcher.matchStart("/**/*bla", "/bla/bla/bla/bbb")).isTrue();
    
    assertThat(pathMatcher.matchStart("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing/")).isTrue();
    assertThat(pathMatcher.matchStart("/*bla*/**/bla/*", "/XXXblaXXXX/testing/testing/bla/testing")).isTrue();
    assertThat(pathMatcher.matchStart("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing")).isTrue();
    assertThat(pathMatcher.matchStart("/*bla*/**/bla/**", "/XXXblaXXXX/testing/testing/bla/testing/testing.jpg")).isTrue();
    
    assertThat(pathMatcher.matchStart("*bla*/**/bla/**", "XXXblaXXXX/testing/testing/bla/testing/testing/")).isTrue();
    assertThat(pathMatcher.matchStart("*bla*/**/bla/*", "XXXblaXXXX/testing/testing/bla/testing")).isTrue();
    assertThat(pathMatcher.matchStart("*bla*/**/bla/**", "XXXblaXXXX/testing/testing/bla/testing/testing")).isTrue();
    assertThat(pathMatcher.matchStart("*bla*/**/bla/*", "XXXblaXXXX/testing/testing/bla/testing/testing")).isTrue();
    
    assertThat(pathMatcher.matchStart("/x/x/**/bla", "/x/x/x/")).isTrue();
    
    assertThat(pathMatcher.matchStart("", "")).isTrue();

uniqueDeliminator

pathMatcher.setPathSeparator(".");
    
    // test exact matching
    assertThat(pathMatcher.match("test", "test")).isTrue();
    assertThat(pathMatcher.match(".test", ".test")).isTrue();
    assertThat(pathMatcher.match(".test/jpg", "test/jpg")).isFalse();
    assertThat(pathMatcher.match("test", ".test")).isFalse();
    assertThat(pathMatcher.match(".test", "test")).isFalse();
    
    // test matching with ?'s
    assertThat(pathMatcher.match("t?st", "test")).isTrue();
    assertThat(pathMatcher.match("??st", "test")).isTrue();
    assertThat(pathMatcher.match("tes?", "test")).isTrue();
    assertThat(pathMatcher.match("te??", "test")).isTrue();
    assertThat(pathMatcher.match("?es?", "test")).isTrue();
    assertThat(pathMatcher.match("tes?", "tes")).isFalse();
    assertThat(pathMatcher.match("tes?", "testt")).isFalse();
    assertThat(pathMatcher.match("tes?", "tsst")).isFalse();
    
    // test matching with *'s
    assertThat(pathMatcher.match("*", "test")).isTrue();
    assertThat(pathMatcher.match("test*", "test")).isTrue();
    assertThat(pathMatcher.match("test*", "testTest")).isTrue();
    assertThat(pathMatcher.match("*test*", "AnothertestTest")).isTrue();
    assertThat(pathMatcher.match("*test", "Anothertest")).isTrue();
    assertThat(pathMatcher.match("*/*", "test/")).isTrue();
    assertThat(pathMatcher.match("*/*", "test/test")).isTrue();
    assertThat(pathMatcher.match("*/*", "test/test/test")).isTrue();
    assertThat(pathMatcher.match("test*aaa", "testblaaaa")).isTrue();
    assertThat(pathMatcher.match("test*", "tst")).isFalse();
    assertThat(pathMatcher.match("test*", "tsttest")).isFalse();
    assertThat(pathMatcher.match("*test*", "tsttst")).isFalse();
    assertThat(pathMatcher.match("*test", "tsttst")).isFalse();
    assertThat(pathMatcher.match("*/*", "tsttst")).isFalse();
    assertThat(pathMatcher.match("test*aaa", "test")).isFalse();
    assertThat(pathMatcher.match("test*aaa", "testblaaab")).isFalse();
    
    // test matching with ?'s and .'s
    assertThat(pathMatcher.match(".?", ".a")).isTrue();
    assertThat(pathMatcher.match(".?.a", ".a.a")).isTrue();
    assertThat(pathMatcher.match(".a.?", ".a.b")).isTrue();
    assertThat(pathMatcher.match(".??.a", ".aa.a")).isTrue();
    assertThat(pathMatcher.match(".a.??", ".a.bb")).isTrue();
    assertThat(pathMatcher.match(".?", ".a")).isTrue();
    
    // test matching with **'s
    assertThat(pathMatcher.match(".**", ".testing.testing")).isTrue();
    assertThat(pathMatcher.match(".*.**", ".testing.testing")).isTrue();
    assertThat(pathMatcher.match(".**.*", ".testing.testing")).isTrue();
    assertThat(pathMatcher.match(".bla.**.bla", ".bla.testing.testing.bla")).isTrue();
    assertThat(pathMatcher.match(".bla.**.bla", ".bla.testing.testing.bla.bla")).isTrue();
    assertThat(pathMatcher.match(".**.test", ".bla.bla.test")).isTrue();
    assertThat(pathMatcher.match(".bla.**.**.bla", ".bla.bla.bla.bla.bla.bla")).isTrue();
    assertThat(pathMatcher.match(".bla*bla.test", ".blaXXXbla.test")).isTrue();
    assertThat(pathMatcher.match(".*bla.test", ".XXXbla.test")).isTrue();
    assertThat(pathMatcher.match(".bla*bla.test", ".blaXXXbl.test")).isFalse();
    assertThat(pathMatcher.match(".*bla.test", "XXXblab.test")).isFalse();
    assertThat(pathMatcher.match(".*bla.test", "XXXbl.test")).isFalse();
    }
    
    @Test
    void extractPathWithinPattern() throws Exception {
    assertThat(pathMatcher.extractPathWithinPattern("/docs/commit.html", "/docs/commit.html")).isEqualTo("");
    
    assertThat(pathMatcher.extractPathWithinPattern("/docs/*", "/docs/cvs/commit")).isEqualTo("cvs/commit");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/cvs/*.html", "/docs/cvs/commit.html")).isEqualTo("commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/**", "/docs/cvs/commit")).isEqualTo("cvs/commit");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/**/*.html", "/docs/cvs/commit.html")).isEqualTo("cvs/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/**/*.html", "/docs/commit.html")).isEqualTo("commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/*.html", "/commit.html")).isEqualTo("commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/*.html", "/docs/commit.html")).isEqualTo("docs/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("*.html", "/commit.html")).isEqualTo("/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("*.html", "/docs/commit.html")).isEqualTo("/docs/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("**/*.*", "/docs/commit.html")).isEqualTo("/docs/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("*", "/docs/commit.html")).isEqualTo("/docs/commit.html");
    // SPR-10515
    assertThat(pathMatcher.extractPathWithinPattern("**/commit.html", "/docs/cvs/other/commit.html")).isEqualTo("/docs/cvs/other/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/**/commit.html", "/docs/cvs/other/commit.html")).isEqualTo("cvs/other/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/**/**/**/**", "/docs/cvs/other/commit.html")).isEqualTo("cvs/other/commit.html");
    
    assertThat(pathMatcher.extractPathWithinPattern("/d?cs/*", "/docs/cvs/commit")).isEqualTo("docs/cvs/commit");
    assertThat(pathMatcher.extractPathWithinPattern("/docs/c?s/*.html", "/docs/cvs/commit.html")).isEqualTo("cvs/commit.html");
    assertThat(pathMatcher.extractPathWithinPattern("/d?cs/**", "/docs/cvs/commit")).isEqualTo("docs/cvs/commit");
    assertThat(pathMatcher.extractPathWithinPattern("/d?cs/**/*.html", "/docs/cvs/commit.html")).isEqualTo("docs/cvs/commit.html");

## extractUriTemplateVariables ##

Map<String, String> result = pathMatcher.extractUriTemplateVariables("/hotels/{hotel}", "/hotels/1");
 assertThat(result).isEqualTo(Collections.singletonMap("hotel", "1"));
 
 result = pathMatcher.extractUriTemplateVariables("/h?tels/{hotel}", "/hotels/1");
 assertThat(result).isEqualTo(Collections.singletonMap("hotel", "1"));
 
 result = pathMatcher.extractUriTemplateVariables("/hotels/{hotel}/bookings/{booking}", "/hotels/1/bookings/2");
 Map<String, String> expected = new LinkedHashMap<>();
 expected.put("hotel", "1");
 expected.put("booking", "2");
 assertThat(result).isEqualTo(expected);
 
 result = pathMatcher.extractUriTemplateVariables("/**/hotels/**/{hotel}", "/foo/hotels/bar/1");
 assertThat(result).isEqualTo(Collections.singletonMap("hotel", "1"));
 
 result = pathMatcher.extractUriTemplateVariables("/{page}.html", "/42.html");
 assertThat(result).isEqualTo(Collections.singletonMap("page", "42"));
 
 result = pathMatcher.extractUriTemplateVariables("/{page}.*", "/42.html");
 assertThat(result).isEqualTo(Collections.singletonMap("page", "42"));
 
 result = pathMatcher.extractUriTemplateVariables("/A-{B}-C", "/A-b-C");
 assertThat(result).isEqualTo(Collections.singletonMap("B", "b"));
 
 result = pathMatcher.extractUriTemplateVariables("/{name}.{extension}", "/test.html");
 expected = new LinkedHashMap<>();
 expected.put("name", "test");
 expected.put("extension", "html");
 assertThat(result).isEqualTo(expected);

## extractUriTemplateVariablesRegex ##

Map<String, String> result = pathMatcher
 .extractUriTemplateVariables("{symbolicName:[\\w\\.]+}-{version:[\\w\\.]+}.jar",
 "com.example-1.0.0.jar");
 assertThat(result.get("symbolicName")).isEqualTo("com.example");
 assertThat(result.get("version")).isEqualTo("1.0.0");
 
 result = pathMatcher.extractUriTemplateVariables("{symbolicName:[\\w\\.]+}-sources-{version:[\\w\\.]+}.jar",
 "com.example-sources-1.0.0.jar");
 assertThat(result.get("symbolicName")).isEqualTo("com.example");
 assertThat(result.get("version")).isEqualTo("1.0.0");

## extractUriTemplateVarsRegexQualifiers ##

Map<String, String> result = pathMatcher.extractUriTemplateVariables(
 "{symbolicName:[\\p{L}\\.]+}-sources-{version:[\\p{N}\\.]+}.jar",
 "com.example-sources-1.0.0.jar");
 assertThat(result.get("symbolicName")).isEqualTo("com.example");
 assertThat(result.get("version")).isEqualTo("1.0.0");
 
 result = pathMatcher.extractUriTemplateVariables(
 "{symbolicName:[\\w\\.]+}-sources-{version:[\\d\\.]+}-{year:\\d{4}}{month:\\d{2}}{day:\\d{2}}.jar",
 "com.example-sources-1.0.0-20100220.jar");
 assertThat(result.get("symbolicName")).isEqualTo("com.example");
 assertThat(result.get("version")).isEqualTo("1.0.0");
 assertThat(result.get("year")).isEqualTo("2010");
 assertThat(result.get("month")).isEqualTo("02");
 assertThat(result.get("day")).isEqualTo("20");
 
 result = pathMatcher.extractUriTemplateVariables(
 "{symbolicName:[\\p{L}\\.]+}-sources-{version:[\\p{N}\\.\\{\\}]+}.jar",
 "com.example-sources-1.0.0.{12}.jar");
 assertThat(result.get("symbolicName")).isEqualTo("com.example");
 assertThat(result.get("version")).isEqualTo("1.0.0.{12}");

## extractUriTemplateVarsRegexCapturingGroups ##

assertThatIllegalArgumentException().isThrownBy(() ->
            pathMatcher.extractUriTemplateVariables("/web/{id:foo(bar)?}", "/web/foobar"))
        .withMessageContaining("The number of capturing groups in the pattern");

## combine ##

assertThat(pathMatcher.combine(null, null)).isEqualTo("");
    assertThat(pathMatcher.combine("/hotels", null)).isEqualTo("/hotels");
    assertThat(pathMatcher.combine(null, "/hotels")).isEqualTo("/hotels");
    assertThat(pathMatcher.combine("/hotels/*", "booking")).isEqualTo("/hotels/booking");
    assertThat(pathMatcher.combine("/hotels/*", "/booking")).isEqualTo("/hotels/booking");
    assertThat(pathMatcher.combine("/hotels/**", "booking")).isEqualTo("/hotels/**/booking");
    assertThat(pathMatcher.combine("/hotels/**", "/booking")).isEqualTo("/hotels/**/booking");
    assertThat(pathMatcher.combine("/hotels", "/booking")).isEqualTo("/hotels/booking");
    assertThat(pathMatcher.combine("/hotels", "booking")).isEqualTo("/hotels/booking");
    assertThat(pathMatcher.combine("/hotels/", "booking")).isEqualTo("/hotels/booking");
    assertThat(pathMatcher.combine("/hotels/*", "{hotel}")).isEqualTo("/hotels/{hotel}");
    assertThat(pathMatcher.combine("/hotels/**", "{hotel}")).isEqualTo("/hotels/**/{hotel}");
    assertThat(pathMatcher.combine("/hotels", "{hotel}")).isEqualTo("/hotels/{hotel}");
    assertThat(pathMatcher.combine("/hotels", "{hotel}.*")).isEqualTo("/hotels/{hotel}.*");
    assertThat(pathMatcher.combine("/hotels/*/booking", "{booking}")).isEqualTo("/hotels/*/booking/{booking}");
    assertThat(pathMatcher.combine("/*.html", "/hotel.html")).isEqualTo("/hotel.html");
    assertThat(pathMatcher.combine("/*.html", "/hotel")).isEqualTo("/hotel.html");
    assertThat(pathMatcher.combine("/*.html", "/hotel.*")).isEqualTo("/hotel.html");
    assertThat(pathMatcher.combine("/**", "/*.html")).isEqualTo("/*.html");
    assertThat(pathMatcher.combine("/*", "/*.html")).isEqualTo("/*.html");
    assertThat(pathMatcher.combine("/*.*", "/*.html")).isEqualTo("/*.html");
    // SPR-8858
    assertThat(pathMatcher.combine("/{foo}", "/bar")).isEqualTo("/{foo}/bar");
    // SPR-7970
    assertThat(pathMatcher.combine("/user", "/user")).isEqualTo("/user/user");
    // SPR-10062
    assertThat(pathMatcher.combine("/{foo:.*[^0-9].*}", "/edit/")).isEqualTo("/{foo:.*[^0-9].*}/edit/");
    // SPR-10554
    assertThat(pathMatcher.combine("/1.0", "/foo/test")).isEqualTo("/1.0/foo/test");
    // SPR-12975
    assertThat(pathMatcher.combine("/", "/hotel")).isEqualTo("/hotel");
    // SPR-12975
    assertThat(pathMatcher.combine("/hotel/", "/booking")).isEqualTo("/hotel/booking");

combineWithTwoFileExtensionPatterns

assertThatIllegalArgumentException().isThrownBy(() ->
            pathMatcher.combine("/*.html", "/*.txt"));

## patternComparator ##

Comparator<String> comparator = pathMatcher.getPatternComparator("/hotels/new");
 
 assertThat(comparator.compare(null, null)).isEqualTo(0);
 assertThat(comparator.compare(null, "/hotels/new")).isEqualTo(1);
 assertThat(comparator.compare("/hotels/new", null)).isEqualTo(-1);
 
 assertThat(comparator.compare("/hotels/new", "/hotels/new")).isEqualTo(0);
 
 assertThat(comparator.compare("/hotels/new", "/hotels/*")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/*", "/hotels/new")).isEqualTo(1);
 assertThat(comparator.compare("/hotels/*", "/hotels/*")).isEqualTo(0);
 
 assertThat(comparator.compare("/hotels/new", "/hotels/{hotel}")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/{hotel}", "/hotels/new")).isEqualTo(1);
 assertThat(comparator.compare("/hotels/{hotel}", "/hotels/{hotel}")).isEqualTo(0);
 assertThat(comparator.compare("/hotels/{hotel}/booking", "/hotels/{hotel}/bookings/{booking}")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/{hotel}/bookings/{booking}", "/hotels/{hotel}/booking")).isEqualTo(1);
 
 // SPR-10550
 assertThat(comparator.compare("/hotels/{hotel}/bookings/{booking}/cutomers/{customer}", "/**")).isEqualTo(-1);
 assertThat(comparator.compare("/**", "/hotels/{hotel}/bookings/{booking}/cutomers/{customer}")).isEqualTo(1);
 assertThat(comparator.compare("/**", "/**")).isEqualTo(0);
 
 assertThat(comparator.compare("/hotels/{hotel}", "/hotels/*")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/*", "/hotels/{hotel}")).isEqualTo(1);
 
 assertThat(comparator.compare("/hotels/*", "/hotels/*/**")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/*/**", "/hotels/*")).isEqualTo(1);
 
 assertThat(comparator.compare("/hotels/new", "/hotels/new.*")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/{hotel}", "/hotels/{hotel}.*")).isEqualTo(2);
 
 // SPR-6741
 assertThat(comparator.compare("/hotels/{hotel}/bookings/{booking}/cutomers/{customer}", "/hotels/**")).isEqualTo(-1);
 assertThat(comparator.compare("/hotels/**", "/hotels/{hotel}/bookings/{booking}/cutomers/{customer}")).isEqualTo(1);
 assertThat(comparator.compare("/hotels/foo/bar/**", "/hotels/{hotel}")).isEqualTo(1);
 assertThat(comparator.compare("/hotels/{hotel}", "/hotels/foo/bar/**")).isEqualTo(-1);
 
 // gh-23125
 assertThat(comparator.compare("/hotels/*/bookings/**", "/hotels/**")).isEqualTo(-11);
 
 // SPR-8683
 assertThat(comparator.compare("/**", "/hotels/{hotel}")).isEqualTo(1);
 
 // longer is better
 assertThat(comparator.compare("/hotels", "/hotels2")).isEqualTo(1);
 
 // SPR-13139
 assertThat(comparator.compare("*", "*/**")).isEqualTo(-1);
 assertThat(comparator.compare("*/**", "*")).isEqualTo(1);

patternComparatorSort

Comparator<String> comparator = pathMatcher.getPatternComparator("/hotels/new");
 List<String> paths = new ArrayList<>(3);
 
 paths.add(null);
 paths.add("/hotels/new");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isNull();
 paths.clear();
 
 paths.add("/hotels/new");
 paths.add(null);
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isNull();
 paths.clear();
 
 paths.add("/hotels/*");
 paths.add("/hotels/new");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isEqualTo("/hotels/*");
 paths.clear();
 
 paths.add("/hotels/new");
 paths.add("/hotels/*");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isEqualTo("/hotels/*");
 paths.clear();
 
 paths.add("/hotels/**");
 paths.add("/hotels/*");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/*");
 assertThat(paths.get(1)).isEqualTo("/hotels/**");
 paths.clear();
 
 paths.add("/hotels/*");
 paths.add("/hotels/**");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/*");
 assertThat(paths.get(1)).isEqualTo("/hotels/**");
 paths.clear();
 
 paths.add("/hotels/{hotel}");
 paths.add("/hotels/new");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isEqualTo("/hotels/{hotel}");
 paths.clear();
 
 paths.add("/hotels/new");
 paths.add("/hotels/{hotel}");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isEqualTo("/hotels/{hotel}");
 paths.clear();
 
 paths.add("/hotels/*");
 paths.add("/hotels/{hotel}");
 paths.add("/hotels/new");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new");
 assertThat(paths.get(1)).isEqualTo("/hotels/{hotel}");
 assertThat(paths.get(2)).isEqualTo("/hotels/*");
 paths.clear();
 
 paths.add("/hotels/ne*");
 paths.add("/hotels/n*");
 Collections.shuffle(paths);
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/ne*");
 assertThat(paths.get(1)).isEqualTo("/hotels/n*");
 paths.clear();
 
 comparator = pathMatcher.getPatternComparator("/hotels/new.html");
 paths.add("/hotels/new.*");
 paths.add("/hotels/{hotel}");
 Collections.shuffle(paths);
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/hotels/new.*");
 assertThat(paths.get(1)).isEqualTo("/hotels/{hotel}");
 paths.clear();
 
 comparator = pathMatcher.getPatternComparator("/web/endUser/action/login.html");
 paths.add("/**/login.*");
 paths.add("/**/endUser/action/login.*");
 paths.sort(comparator);
 assertThat(paths.get(0)).isEqualTo("/**/endUser/action/login.*");
 assertThat(paths.get(1)).isEqualTo("/**/login.*");
 paths.clear();

## trimTokensOff ##

pathMatcher.setTrimTokens(false);
    
    assertThat(pathMatcher.match("/group/{groupName}/members", "/group/sales/members")).isTrue();
    assertThat(pathMatcher.match("/group/{groupName}/members", "/group/  sales/members")).isTrue();
    assertThat(pathMatcher.match("/group/{groupName}/members", "/Group/  Sales/Members")).isFalse();

## caseInsensitive ##

pathMatcher.setCaseSensitive(false);
    
    assertThat(pathMatcher.match("/group/{groupName}/members", "/group/sales/members")).isTrue();
    assertThat(pathMatcher.match("/group/{groupName}/members", "/Group/Sales/Members")).isTrue();
    assertThat(pathMatcher.match("/Group/{groupName}/Members", "/group/Sales/members")).isTrue();

## defaultCacheSetting ##

assertThat(pathMatcher.stringMatcherCache.size() > 20).isTrue();
 
 for (int i = 0; i < 65536; i++) {
 pathMatcher.match("test" + i, "test");
 }
 // Cache turned off because it went beyond the threshold
 assertThat(pathMatcher.stringMatcherCache.isEmpty()).isTrue();

cachePatternsSetToTrue

pathMatcher.setCachePatterns(true);
 match();
 assertThat(pathMatcher.stringMatcherCache.size() > 20).isTrue();
 
 for (int i = 0; i < 65536; i++) {
 pathMatcher.match("test" + i, "test" + i);
 }
 // Cache keeps being alive due to the explicit cache setting
 assertThat(pathMatcher.stringMatcherCache.size() > 65536).isTrue();

cachePatternsSetToFalse

pathMatcher.setCachePatterns(false);
    match();
    assertThat(pathMatcher.stringMatcherCache.isEmpty()).isTrue();

## CreatingStringMatchers ##

preventCreatingStringMatchersIfPathDoesNotStartsWithPatternPrefix

pathMatcher.setCachePatterns(true);
    assertThat(pathMatcher.stringMatcherCache.size()).isEqualTo(0);
    
    pathMatcher.match("test?", "test");
    assertThat(pathMatcher.stringMatcherCache.size()).isEqualTo(1);
    
    pathMatcher.match("test?", "best");
    pathMatcher.match("test/*", "view/test.jpg");
    pathMatcher.match("test/**/test.jpg", "view/test.jpg");
    pathMatcher.match("test/{name}.jpg", "view/test.jpg");
    assertThat(pathMatcher.stringMatcherCache.size()).isEqualTo(1);

creatingStringMatchersIfPatternPrefixCannotDetermineIfPathMatch

pathMatcher.setCachePatterns(true);
    assertThat(pathMatcher.stringMatcherCache.size()).isEqualTo(0);
    
    pathMatcher.match("test", "testian");
    pathMatcher.match("test?", "testFf");
    pathMatcher.match("test/*", "test/dir/name.jpg");
    pathMatcher.match("test/{name}.jpg", "test/lorem.jpg");
    pathMatcher.match("bla/**/test.jpg", "bla/test.jpg");
    pathMatcher.match("**/{name}.jpg", "test/lorem.jpg");
    pathMatcher.match("/**/{name}.jpg", "/test/lorem.jpg");
    pathMatcher.match("/*/dir/{name}.jpg", "/*/dir/lorem.jpg");
    
    assertThat(pathMatcher.stringMatcherCache.size()).isEqualTo(7);

## extensionMappingWithDotPathSeparator ##

pathMatcher.setPathSeparator(".");
    assertThat(pathMatcher.combine("/*.html", "hotel.*")).as("Extension mapping should be disabled with \".\" as path separator").isEqualTo("/*.html.hotel.*");

## isPattern ##

assertThat(pathMatcher.isPattern("/test/*")).isTrue();
    assertThat(pathMatcher.isPattern("/test/**/name")).isTrue();
    assertThat(pathMatcher.isPattern("/test?")).isTrue();
    assertThat(pathMatcher.isPattern("/test/{name}")).isTrue();
    
    assertThat(pathMatcher.isPattern("/test/name")).isFalse();
    assertThat(pathMatcher.isPattern("/test/foo{bar")).isFalse();

isPatternWithNullPath

assertThat(pathMatcher.isPattern(null)).isFalse();

# **其他网址** #

[SpringMVC路径匹配规则AntPathMatcher\_一头磕在键盘上-CSDN博客][SpringMVC_AntPathMatcher_-CSDN]

[Spring_SpringBoot--_AntPathMatcher--_IT_-CSDN]: https://knife.blog.csdn.net/article/details/120678900
[https_github.com_spring-projects_spring-framework_blob_main_spring-core_src_test_java_org_springframework_util_AntPathMatcherTests.java]: https://github.com/spring-projects/spring-framework/blob/main/spring-core/src/test/java/org/springframework/util/AntPathMatcherTests.java
[SpringMVC_AntPathMatcher_-CSDN]: https://blog.csdn.net/qq_21251983/article/details/53034425