Spring Boot 请求路径可以定义成 // 这种格式吗？

2023-02-28

接口 path 路径

前两天松哥和大家分享了SpringSecurity中如何实现权限通配符的功能，里边用到了一个“邪门歪道”AntPathMatcher，有小伙伴对这个感到陌生，问松哥能不能单独介绍一下这个玩意，好，安排！不过AntPathMatcher其实在逐渐过时，它的替代品是PathPattern，我就把这两个放

前两天松哥和大家分享了 Spring Security 中如何实现权限通配符的功能，里边用到了一个“邪门歪道” AntPathMatcher，有小伙伴对这个感到陌生，问松哥能不能单独介绍一下这个玩意，好，安排！

不过 AntPathMatcher 其实在逐渐过时，它的替代品是 PathPattern，我就把这两个放在一起和大家分享下。

Spring5 也已经出来好久了，里边有一些新玩法也需要我们去慢慢揭开面纱，其中，系统分析当前请求路径的方法位于这里：org.springframework.web.servlet.handler.AbstractHandlerMapping#initLookupPath：

protected String initLookupPath(HttpServletRequest request) {
 if (usesPathPatterns()) {
  request.removeAttribute(UrlPathHelper.PATH_ATTRIBUTE);
  RequestPath requestPath = ServletRequestPathUtils.getParsedRequestPath(request);
  String lookupPath = requestPath.pathWithinApplication().value();
  return UrlPathHelper.defaultInstance.removeSemicolonContent(lookupPath);
 }
 else {
  return getUrlPathHelper().resolveAndCacheLookupPath(request);
 }
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

这个方法就是 Spring5 里边出来的，以前是没有这个方法的。在旧的 SpringMVC 中，当我们需要获取当前请求地址的时候，直接通过如下方式获取：

String lookupPath = this.getUrlPathHelper().getLookupPathForRequest(request);1.

但是现在变了，现在获取当前请求 URL 地址时，方式如下：

String lookupPath = initLookupPath(request);1.

两种方式相比，主要是 initLookupPath 方法中多了 usesPathPatterns 选项，这是 Spring5 中的新玩意，所以今天松哥就通过一篇简单的文章来和大家分享一下 usesPathPatterns 到底是什么，该怎么玩！

这可不是一个小变化哦！特别是如果你在项目中使用了 WebFlux，那么这个东西就显得尤为重要了！

1. AntPathMatcher

当我们使用 @RequestMapping 注解去标记请求接口的时候（或者使用它的类似方法如 @GetMapping、@PostMapping、@PutMapping、@DeleteMapping、@PatchMapping），我们可以使用一些通配符去匹配 URL 地址，举个简单例子，假设我有下面五个接口：

@GetMapping("/hello/**/hello")
public String hello() {
    return "/hello/**/hello";
}
@GetMapping("/h?llo")
public String hello2() {
    return "/h?llo";
}
@GetMapping("/**/*.html")
public String hello3() {
    return "/**/*.html";
}
@GetMapping("/hello/{p1}/{p2}")
public String hello4(@PathVariable String p1, @PathVariable String p2) {
    System.out.println("p1 = " + p1);
    System.out.println("p2 = " + p2);
    return "/hello/{p1}/{p2}";
}
@GetMapping("/{name:[a-z-]+}-{version:\\d\\.\\d\\.\\d}{ext:\\.[a-z]+}")
public void handle(@PathVariable String name, @PathVariable String version, @PathVariable String ext) {
    System.out.println("name = " + name);
    System.out.println("version = " + version);
    System.out.println("ext = " + ext);
}1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.

在解释接口的含义之前，先来说说这几个通配符的含义：

通配符	含义
`**`	匹配0个或者多个目录
`*`	匹配0个或者多个字符
`?`	匹配任意单个字符

了解了通配符的含义，我们再来说说各个接口都能接收哪些请求：

第一个接口，可以接收诸如/hello/123/123/hello、/hello/a/hello 以及/hello/hello 这样的请求，因为中间的** 代表 0 个或者多个目录。

第二个接口，可以接收诸如/hallo、/hello、/hMllo 之类的请求，注意它不能接收/haallo 或者/hllo，因为? 表示一个字符。

第三个接口可以接收任意以.html 为后缀的请求，例如/aaa/bb/cc.html、/aa.html 或者/aa/aa.html。

第四个接口估计大家都比较熟悉，在 RESTful 风格的接口设计中估计大家都用过，它接收的请求格式类似于/hello/aa/bb，其中参数 p1 就对应 aa，参数 p2 对应 bb。

第五个接口则用到了正则，name、version 以及 ext 三个参数格式用正则表达出来，它可以接收诸如/spring-web-3.0.5.jar 格式的请求，最终的参数 name 就是spring-web，version 就是3.0.5，ext 则是.jar。

这是 SpringMVC 中之前就存在的功能，不管你用没用过，反正它一致存在。

那么是谁支撑了这个功能呢？那就是 AntPathMatcher。

AntPathMatcher 是一个实现了 Ant 风格的路径匹配器，Ant 风格的路径规则实际上就是我们前面给大家介绍的那三种路径匹配符，很 Easy。这种路径匹配规则源自 Apache Ant 项目（https://ant.apache.org），Apache Ant 我们现在其实已经很少会用到了，它的替代品就是大家所熟知的 Maven，如果你有幸维护一些 2010 年之前的老项目的话，有可能会接触到 Ant。

AntPathMatcher 实际上在 SpringMVC 中有非常广泛的应用，不仅仅是在 @RequestMapping 中定义接口用到，在其他一些涉及到地址匹配的地方也会用到，例如我们在 SpringMVC 的配置文件中配置静态资源过滤时，也是 Ant 风格路径匹配：

<mvc:resources mapping="/**" location="/"/>1.

另外像拦截器里的拦截路径注册、跨域处理时的路径匹配等等，都会用到 Ant 风格的路径匹配符。

整体上来说，AntPathMatcher 是 Spring 中一种比较原始的路径匹配解决方案，虽然比较简单，但是它的效率很低，并且在处理 URL 编码的时候也很不方便。

因此，才有了 Spring5 中的 PathPattern。

2. PathPattern

PathPattern 专为 Web 应用设计，它与之前的 AntPathMatcher 功能大部分比较类似，当然也有一些细微差异，这个松哥后面会说。

如果是 Servlet 应用，目前官方推荐的 URL 匹配解决方案就是 PathPattern（当然你也可以选择较早的 AntPathMatcher），虽然官方推荐的是 PathPattern，但实际上默认使用的依然是 AntPathMatcher；如果你用的是 WebFlux，PathPattern 就是唯一解决方案了。

注意，PathPattern 是一个非常新鲜的玩艺，目前 Spring 最新版是 5.3.4，在 Spring5.3 之前，我们在 Servlet 应用中，也只能选择 AntPathMatcher，从 Spring5.3 之后，我们才可以使用 PathPattern 了。

PathPattern 会将 URL 规则预解析为 PathContainer，它对 URL 地址匹配的处理更加快速，PathPattern 与 AntPathMatcher 的差异主要体现在两个方面：

第一，PathPattern 只支持结尾部分使用 **，如果在路径的中间使用 ** 就会报错，上文中第一个和第三个接口，在 PathPattern 模式下会报错，如下：

因为在中间或者开始使用 ** 极易造成混乱，因此 PathPattern 只支持在结尾使用 **。

第二，PathPattern 支持使用诸如 {*path} 的方式进行路径匹配，这种写法也可以匹配到多层路径，并且将匹配到的值赋值给 path 变量，例如如下一个接口：

@GetMapping("/javaboy/{*path}")
public void hello6(@PathVariable String path) {
    System.out.println("path = " + path);
}1.
2.
3.
4.

如果请求路径是 http://localhost:8080/javaboy/aa，那么参数 path 的值就是 /aa；

如果请求路径是 http://localhost:8080/javaboy/aa/bb/cc/dd，那么参数 path 的值就是 /aa/bb/cc/dd；

这个写法也比较新颖，因为之前的 AntPathMatcher 里边没有这个。

3. 如何使用

默认情况下，SpringMVC 中使用的还是 AntPathMatcher，那么如何开启 PathPattern 呢？很简单，在 SpringBoot 项目中只需要添加如下配置即可：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        configurer.setPatternParser(new PathPatternParser());
    }
}1.
2.
3.
4.
5.
6.
7.