本章节,我会给大家讲解Spring Boot中定制URL匹配规则的方法。
在Spring Boot1.5的版本中,假如我们定义了一个’/show‘接口,默认情况下,我们可以按照/show来访问页面,也可以按照/show.do这样带有“.do”后缀的接口来访问资源。
但是到了Spring Boot2.x之后,我们发现再使用.do的扩展名就无法访问资源了。
也就是说,现在的Spring Boot在默认情况下,禁用了后缀匹配模式!
但是我们在开发Web应用程序时,并不总是使用一些默认的配置。有时,我们要创建包含字符 “.” 的RESTful风格的URL;有时候我们也希望识别斜杠的存在。这些需求,Spring都为我们提供了接口供开发人员按照需求定制。
“.” 字符在Spring中作为分隔符定义格式,例如/projects/spring-boot.json中的 “点” ,另外我们也可能想识别路径尾部的斜杠,如“/home/”中的 “/” 等。
我们在SpringBoot1.x版本中,可以创建如下控制器接口:
@RestController
@RequestMapping("/")
public class HelloController {
@RequestMapping("hello")
public String showHello() {
return "Hello,一一哥Sun!";
}
}
在Spring Boot1.x版本的控制器中,我们可以使用下面的规则来进行访问:
/hello
/hello.*
但是如果我们将工程升级到SpringBoot2.x后,默认情况下我们只能使用/hello访问,那么怎样才能使用1.x的访问规则呢?
接下来我就带大家在SpringBoot 2.x版本中实现一下,进行自定义的URL路径匹配。
在这种实现方式里,我们又可以有两种常用的方式实现:
上述两种方式的核心都是:
configurePathMatch(PathMatchConfigurer configurer)函数,
让开发人员可以根据需求定制URL路径的匹配规则。
setUseSuffixPatternMatch(boolean useSuffixPatternMatch)
设置是否是后缀模式匹配,true即匹配。
(1).启动类 extends WebMvcConfigurationSupport;
(2).重写configurePathMatch方法。
package com.yyg.boot.config;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.web.servlet.config.annotation.PathMatchConfigurer;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
/**
* @Description Description
* @Author 一一哥Sun
* @Date Created in 2020/3/21
*/
@Configuration
public class DefaultMvcConfig extends WebMvcConfigurationSupport {
@Override
protected void configurePathMatch(PathMatchConfigurer configurer) {
//setUseSuffixPatternMatch:设置是否遵循后缀匹配模式,如“/user”是否匹配/user.*,为true时就匹配;
configurer.setUseSuffixPatternMatch(true)
//setUseTrailingSlashMatch,设置是否自动后缀留级匹配模式,如“/user”是否匹配“/user/”,为true是即匹配
.setUseTrailingSlashMatch(true);
}
}
package com.yyg.boot.web;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
/**
* @Description URL路径访问规则+内容协商管理
* @Author 一一哥Sun
* @Date Created in 2020/3/21
*/
@Controller
public class WelcomeController {
/**
* produces="application/json;charset=UTF-8":解决继承WebMvcConfigurationSupport类时中文乱码的问题.
*/
@ResponseBody
@GetMapping(value="/show",produces="application/json;charset=UTF-8")
public String showMsg() {
return "听一一哥讲解URL路径访问规则...";
}
}
在浏览器中输入地址:
http://localhost:8080/show.do
可以看到,此时即使我们带有".do"后缀,也可以访问页面,在此之前是不可以的。
在浏览器中输入地址:
http://localhost:8080/show/
可以看到,此时即使我们带有"/show/"后缀,也可以访问页面。
抽象类WebMvcConfigurerAdapter与WebMvcConfigurationSupport都可以配置MVC, WebMvcConfigurerAdapter有的功能,WebMvcConfigurationSupport都有,因此建议使用WebMvcConfigurationSupport。
以上代码配置类的实现方式,其实是有点复杂的,我们也可以把该实现方式,在properties或yml配置文件中实现,这种方式特别的简单。
我们可以先把前面案例中的配置类中的@Configuration先注释掉,使得之前的配置代码失效,我们接下来创建一个application.properties配置文件。
#设置是否遵循后缀匹配模式,如“/user”是否匹配/user.*,为true时就匹配;
spring.mvc.pathmatch.use-suffix-pattern=true
#设置是否自动后缀留级匹配模式,如“/user”是否匹配“/user/”,为true是即匹配
spring.mvc.pathmatch.use-registered-suffix-pattern=false
在浏览器中输入地址:
http://localhost:8080/show.dooo
可以看到,此时即使我们带有".dooo"后缀,也可以访问页面。
在浏览器中输入地址:
http://localhost:8080/show/
可以看到,此时即使我们带有"/show/"后缀,也可以访问页面。