Springboot 使用@MatrixVariable注解

在Spring3.2 后，一个@MatrixVariable出现了，这个注解的出现拓展了URL请求地址的功能。 
如果要开启Matrix Variable功能的话，必须设置 RequestMappingHandlerMapping 中的 removeSemicolonContent 为false. 
一般情况不用你手动去设置这个属性，因为这个属性默认就是false ，如果你碰见Matrix Variable功能未开启的时候就可以看看是不是误设置这个属性为true了。 

---

Springboot 默认是无法使用矩阵变量绑定参数的。需要覆盖WebMvcConfigurer中的configurePathMatch方法。

@Configuration
public class WebConfig extends WebMvcConfigurerAdapter {

    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        UrlPathHelper urlPathHelper=new UrlPathHelper();
        urlPathHelper.setRemoveSemicolonContent(false);
        configurer.setUrlPathHelper(urlPathHelper);
    }
}

---

Demo

// http://127.0.0.1:9082/sys/v1/count/test/id35;price=100;type=1,3/msg/msg44
// http://127.0.0.1:9082/sys/v1/count/test/id35;price=100;type=1,3/msg/msg44;vol=100,45
@GetMapping("test/{id}/msg/{tip}")
//public String testMatrix(@MatrixVariable(pathVar = "id") Map<String, List<String>> map, @PathVariable("tip") String tip){
//public String testMatrix(@MatrixVariable Map<String, List<String>> map, @PathVariable("tip") String tip){
public String testMatrix(@MatrixVariable(pathVar = "id") Map<String, List<String>> map, @MatrixVariable(value = "vol", pathVar = "tip") List<String> list,  @PathVariable("id") String id, @PathVariable("tip") String tip){
    System.out.println("id:" + id);
    System.out.println("tip:" + tip);
    System.out.println("map:" + map);
    System.out.println("list:" + list);
    return "";
}

 

//http://127.0.0.1:9082/sys/v1/count/tablet;low=100;hight=1000?manufacturer=google
@RequestMapping("/{category}")
public String filterProducts(
        @PathVariable("category") String category,
        @MatrixVariable Map<String, List<String>> filterParams,
        @RequestParam("manufacturer") String manufacturer, Model model) {
    return "";
}

//http://127.0.0.1:9082/sys/v1/count/tablet/low=100;hight=1000?manufacturer=google

 

Matrix Variable中，多个变量可以使用“;”（分号）分隔，例如： 
按照类别，价格区间，生产者查询，其实最后一个查询条件使用@RequestParam，类别使用@PathVariable，真正使用到matrixVariable的是 价格区间。
http://127.0.0.1:9082/sys/v1/count/tablet/low=100;hight=1000?manufacturer=google
@RequestMapping("/{category}/{ByCriteria}")
public String filterProducts(
            @PathVariable("category") String category,
            @MatrixVariable(pathVar="ByCriteria") Map<String, List<String>> filterParams,
            @RequestParam("manufacturer") String manufacturer, Model model) {}

			
// GET /owners/42;q=11/pets/21;q=22  
@RequestMapping(value = "/owners/{ownerId}/pets/{petId}", method = RequestMethod.GET)  
public voidfindPet(  
@MatrixVariable(value="q", pathVar="ownerId") intq1,  
@MatrixVariable(value="q", pathVar="petId") intq2) {  
// q1 == 11  
// q2 == 22  //spring3.2.3
}  
针对每一个Parh Variable绑定一个Matrix Variable，然后使用 value 和 pathVar属性就能找到该值。 
		
另外，正对Matrix Variable也是可以指定自身的的属性，例如，是否必须，默认值。 
下面这个例子说明： 
Java代码  收藏代码
// GET /pets/42  
@RequestMapping(value = "/pets/{petId}", method = RequestMethod.GET)  
public voidfindPet(@MatrixVariable(required=true, defaultValue="1") intq) {  
// q == 1  
}  
		

根据 品牌，类别查询代码如下
http://xxx/xxxpr/filter/ByCriteria;brand=dell,google;category=tablet,laptop
@RequestMapping("/filter/{ByCriteria}")
public String getProductsByFilter(@MatrixVariable(pathVar="ByCriteria")  Map<String, List<String>> filterParams, Model model) {}

如果是一个变量的多个值那么可以使用“,”（逗号）分隔 
Java代码  收藏代码
color=red,green,blue  
或者可以使用重复的变量名： 
Java代码  收藏代码
color=red;color=green;color=blue