在使用 Sprint Boot 提交 x-www-form-urlencoded 的时候，我们首先需要知道 x-www-form-urlencoded 这个是什么东西。
application/x-www-form-urlencoded
这应该是最常见的 POST 提交数据的方式了。浏览器的原生 表单，如果不设置 enctype 属性，那么最终就会以 application/x-www-form-urlencoded 方式提交数据。
就是浏览器将会将表单中的内容转换为 URL 的方式提交到后台进行处理。转换的方式其实就是使用 K=V 对的方式。
不同的 K=V 之间是用 & 进行分隔。
例如下面的示例：
POST /test HTTP/1.1
Host: foo.example
Content-Type: application/x-www-form-urlencoded
Content-Length: 27
field1=value1&field2=value2
你可以在你的 API 后面直接加上上面的字符串，然后 POST 请求过去，在上面的字符串和 URL 之间需要添加一个 ？ 号。
转换流程是：
假设你有一个表单，在表单中获取的值为：
field1=value1
field2=value2
你需要提交的 URL 为 api.example.com/re/request 这样的话。
如果你使用了 application/x-www-form-urlencoded 提交的话，浏览器首先将表单中的数据转换为：field1=value1&field2=value2，请注意中间是使用 & 分隔的。
然后提交到地址：api.example.com/re/request?field1=value1&field2=value2，上面显示的是完整的 URL。
这种提交方式是表单的默认提交方式，同时提交的字符将会进行编码，如果你提交中文字符的话，你可能会看到 %UER，这样的表达，这是因为对中文字符进行了编码而已。
POSTMAN 设置
在使用这种提交之前，你可以在 POSTMAN 设置。
需要在 POSTMAN 中选择提交方式，并且在下面的参数部分设置需要的参数然后单击发送提交即可。
Spring Boot Controller
在 Spring Boot Controller 中需要设置使用 MultiValueMap。
在查看源代码后，你会知道 MultiValueMap 是扩展 Map 的接口，然后用于存储多值的。
一个 Controller 的代码如下：
@PostMapping("/soldm")
public ResponseEntity<?> searchUsers(@RequestBody MultiValueMap< String, String > values) {
logger.debug("K=V Map - {}" , values);
REListing reListing= listingService.getREListingById();
return new ResponseEntity<REListing>(reListing, HttpStatus.OK);
}
在 RequestBody 设置 MultiValueMap 后，你就可以获得 POST 提交的数据了。
测试运行
测试运行后查看日志：
2021-01-27 10:52:38.782 DEBUG 25176 --- [nio-8080-exec-4] c.o.e.s.controller.RealEstateController : K=V Map - {field1=[value1], field2=[value1]}
从这里，你可以 debug 上传的数据和 MAP 中是否设置了正确的参数。
https://www.ossez.com/t/spring-boot-api-x-www-form-urlencoded/13225