前言
RFC3986定义URI的门路(Path)中可蕴含name-value片段，裁减了以往仅能通过查问字符串(Query String)设置可选参数的囧境。
如果当初须要设计一个用于“搜寻某部门某些员工可选信息中的局部信息”的API，咱们别离应用查问字符串和门路name-value形式来设计比照，看看具体成果：
- 查问字符串形式：
/api/v1/users/optional-info?dept=321&name=joh*&fields=hometown,birth
问题：其中的dept和name理当属于users门路，而fields则属于optional-info门路，但当初全副都要挤在查问字符串中。 - 门路name-value形式：
/api/v1/users/depts=321;name=joh*/optional-fields/fields=hometown,birth
能够看出门路name-value的形式逻辑上更在理些。
@MatrixVariable注解属性阐明
在正式开始前咱们先死记硬背一下注解的属性吧。
value和属性pathVar的别名;pathVar用于指定name-value参数所在的门路片段名称name用于指定name-value参数的参数名required是否为必填值，默认为falsedefaultValue设置默认值
其中pathVar和name到底是什么呢？请持续看前面的示例吧，准能秒懂！
启用@MatrixVariable
尽管从Spring 3.2就曾经反对@MatrixVariable个性，但直至当初其仍然为默认禁用的状态。咱们须要手工配置开启能力应用。
@Configuration public class SpringBootConfig implements WebMvcConfigurer { @Override public void configurePathMatch(PathMatchConfigurer configurer) { UrlPathHelper urlPathHelper = new UrlPathHelper(); urlPathHelper.setRemoveSemicolonContent(false); configurer.setUrlPathHelper(urlPathHelper); } } 参数仅有一个值的玩法
留神：多个name-value间以分号分隔，如name=joh*;dept=321。
/* 1. 获取单个门路片段中的参数 申请URI为 /Demo2/66;color=red;year=2020 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@PathVariable String id, @MatrixVariable String color, @MatrixVariable String year){} /* 2. 获取单个门路片段中的参数 申请URI为 /Demo2/color=red;year=2020 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test2(@MatrixVariable String color, @MatrixVariable String year){} /* 3. 获取不同门路片段中的参数 申请URI为 /Demo2/66;color=red;year=2020/pets/77;color=blue;year=2019 */ @RequestMapping(path="/Demo2/{id1}/pets/{id2}", method=RequestMethod.GET) public String test3(@PathVariable String id1, @PathVariable String id2, @MatrixVariable(name="color", pathVar="id1") String color1, @MatrixVariable(name="year", pathVar="id1") String year1, @MatrixVariable(name="color", pathVar="id2") String color2, @MatrixVariable(name="year", pathVar="id2") String year2){} /* 4. 获取不同门路片段中的参数 申请URI为 /Demo2/color=red;year=2020/pets/77;color=blue;year=2019 */ @RequestMapping(path="/Demo2/{id1}/pets/{id2}", method=RequestMethod.GET) public String test4(@PathVariable String id2, @MatrixVariable(name="color", pathVar="id1") String color1, @MatrixVariable(name="year", pathVar="id1") String year1, @MatrixVariable(name="color", pathVar="id2") String color2, @MatrixVariable(name="year", pathVar="id2") String year2){} /* 5. 通过Map获取所有或指定门路下的所有参数 */ @RequestMapping(path="/Demo3/{id1}/pets/{id2}", method=RequestMethod.GET) public String test5(@MatrixVariable Map<String, Object> all, @MatrixVariable(pathVar="id1") Map<String, Object> mapId1) {} 参数有多个值的玩法
若参数值不是单个，那么能够通过两种形式传递：
- 值之间通过逗号分隔，如
dept=321,123 - 重名name-value对，如
dept=321;dept=123
/* 申请为/Demo1/color=123,321 那么color值为123,321 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable Integer[] color){} /* 申请为/Demo1/color=123;color=321 那么color值为123,321 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable Integer[] color){} 那些要留神的坑
在参数多值的状况下还有如下3个坑，请各位多加留神：
String参数类型能够承受通过逗号和通过重名name-value传递的所有值，而其它类型只能获取第一个值。
/* 申请为/Demo1/color=123,321 那么color值为123,321 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable String color){} /* 申请为/Demo1/color=123;color=321 那么color值为123,321 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable String color){} /* 申请为/Demo1/color=123;color=321 那么color值为123 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable Integer color){} Map<String, Object[]>只能获取参数中的第一个值而已。
/* 申请为/Demo1/color=123,321 那么color值为123 */ @RequestMapping(path="/Demo1/{id}", method=RequestMethod.GET) public String test1(@MatrixVariable Map<String, Integer[]> color){} - 不同门路片段中呈现名称雷同的参数，那么必须通过pathVar标识所有雷同参数所属门路，否则URI匹配失败。
// 以下handler仅标识第二个参数的pathVar，而没有标识第一个，那么也是会匹配失败的。 @RequestMapping(path="/Demo2/{id1}/pets/{id2}", method=RequestMethod.GET) public String test2(@MatrixVariable String color, @MatrixVariable(name="color", pathVar="id2") String color2){} 总结
明天就写到这里吧，后续会有更多Spring Boot的分享，请大家多关注我哦！
转载请注明来自： https://www.cnblogs.com/fsjoh... —— 肥仔John