🍃【Spring 专题】「技术原理」为大家介绍一下 Spring 中的 Ant 路径匹配工具组件 AntPathMatcher

/** * {@link PathMatcher} implementation for Ant-style path patterns. * * <p>Part of this mapping code has been kindly borrowed from <a href="http://ant.apache.org">Apache Ant</a>. * * <p>The mapping matches URLs using the following rules:<br> * <ul> * <li>{@code ?} matches one character</li> * <li>{@code *} matches zero or more characters</li> * <li>{@code **} matches zero or more <em>directories</em> in a path</li> * <li>{@code {spring:[a-z]+}} matches the regexp {@code [a-z]+} as a path variable named "spring"</li> * </ul> * * <h3>Examples</h3> * <ul> * <li>{@code com/t?st.jsp} &mdash; matches {@code com/test.jsp} but also * {@code com/tast.jsp} or {@code com/txst.jsp}</li> * <li>{@code com/*.jsp} &mdash; matches all {@code .jsp} files in the * {@code com} directory</li> * <li><code>com/&#42;&#42;/test.jsp</code> &mdash; matches all {@code test.jsp} * files underneath the {@code com} path</li> * <li><code>org/springframework/&#42;&#42;/*.jsp</code> &mdash; matches all * {@code .jsp} files underneath the {@code org/springframework} path</li> * <li><code>org/&#42;&#42;/servlet/bla.jsp</code> &mdash; matches * {@code org/springframework/servlet/bla.jsp} but also * {@code org/springframework/testing/servlet/bla.jsp} and {@code org/servlet/bla.jsp}</li> * <li>{@code com/{filename:\\w+}.jsp} will match {@code com/test.jsp} and assign the value {@code test} * to the {@code filename} variable</li> * </ul> * * <p><strong>Note:</strong> a pattern and a path must both be absolute or must * both be relative in order for the two to match. Therefore it is recommended * that users of this implementation to sanitize patterns in order to prefix * them with "/" as it makes sense in the context in which they're used. * /

@RequestMapping("/index?")@ResponseBodypublic String index(){    return "index.html"; }

index           false 404错误(必须要有一个字符)index/          false 404错误(不能为"/")indexab         false 404错误(不能是多个字符)indexa          true  输出页面index.html

@RequestMapping("/index*")@ResponseBodypublic String index(){    return "index.html";}

index           true  输出index.html(可以为0字符)index/          true  输出 index.html(可以为"/")indexa          true  输出 index.html(可以为1个字符)indexabc        true  输出 index.html(可以为多个字符)index/a         false 404错误("/a"是一个路径)

@RequestMapping("/index/**/a")@ResponseBodypublic String index(){    return "index.html";}

index/a         true  输出 index.html(可以为0个目录)index/x/a       true  输出 index.html(可以为一个目录)index/x/z/c/a   true  输出 index.html(可以为多个目录)

@RequestMapping("/index/{username:[a-b]+}")@ResponseBodypublic String index(@PathVariable("username") String username){      System.out.println(username);return username;}

AntPathMatcher matcher = new AntPathMatcher(File.separator)；AntPathMatcher matcher = new AntPathMatcher(System.getProperty("file.separator"))；

import org.springframework.util.AntPathMatcher;String content = "/admin/acuff";String pattern = "/admin/**";System.out.println(antPathMatcher.match(pattern, content));

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