Spring Boot实战之定制URL匹配规则

本文首发于个人网站：Spring Boot实战之定制URL匹配规则

构建web应用程序时，并不是所有的URL请求都遵循默认的规则。有时，我们希望RESTful URL匹配的时候包含定界符“.”，这种情况在Spring中可以称之为“定界符定义的格式”；有时，我们希望识别斜杠的存在。Spring提供了接口供开发人员按照需求定制。

在之前的几篇文章中，可以通过WebConfiguration类来定制程序中的过滤器、格式化工具等等，同样得，也可以在这个类中用类似的办法配置“路径匹配规则”。

假设ISBN格式允许通过定界符“.”分割图书编号和修订号，形如**[isbn-number].[revision]**

实战

• 在WebConfiguration类中添加对应的配置，代码如下：

@Override
public void configurePathMatch(PathMatchConfigurer configurer) {
    configurer.setUseSuffixPatternMatch(false).setUseTrailingSlashMatch(true);
}

• 通过mvn spring-boot:run启动应用程序
• 访问http://localhost:8080/books/9781-1234-1111.1

• 访问http://localhost:8080/books/9781-1234-1111

分析

*configurePathMatch(PathMatchConfigurer configurer)*函数让开发人员可以根据需求定制URL路径的匹配规则。

• configurer.setUseSuffixPatternMatch(false)表示设计人员希望系统对外暴露的URL不会识别和匹配.后缀。在这个例子中，就意味着Spring会将9781-1234-1111.1当做一个isbn*参数传给BookController。
• configurer.setUseTrailingSlashMatch(true)表示系统不区分URL的最后一个字符是否是斜杠/。在这个例子中，就意味着http://localhost:8080/books/9781-1234-1111和http://localhost:8080/books/9781-1234-1111/含义相同。

如果需要定制path匹配发生的过程，可以提供自己定制的PathMatcher和UrlPathHelper，但是这种需求并不常见。

Spring Boot 1.x系列

1. Spring Boot的自动配置、Command-line-Runner
2. 了解Spring Boot的自动配置
3. Spring Boot的@PropertySource注解在整合Redis中的使用
4. Spring Boot项目中如何定制HTTP消息转换器
5. Spring Boot整合Mongodb提供Restful接口
6. Spring中bean的scope
7. Spring Boot项目中使用事件派发器模式
8. Spring Boot提供RESTful接口时的错误处理实践
9. Spring Boot实战之定制自己的starter
10. Spring Boot项目如何同时支持HTTP和HTTPS协议
11. 自定义的Spring Boot starter如何设置自动配置注解
12. Spring Boot项目中使用Mockito
13. 在Spring Boot项目中使用Spock测试框架
14. Spring Boot项目中如何定制拦截器
15. Spring Boot项目中如何定制PropertyEditors
16. Spring Boot构建的Web项目如何在服务端校验表单输入
17. Spring Boot应用的健康监控
18. Spring Boot项目中如何定制servlet-filters

---