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