在使用 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 中是否设置了正确的参数。