HTTP POST 请求 及 @RequestParam @RequestPart @RequestBody

1. 

通过HTML Form提交。

Content-Type： application/x-www-form-urlencoded ，multipart/form-data 和 text/plain

application/x-www-form-urlencoded： 

将提交的key-value数据编码成由'&'和'='进行分割的字符串。类似get请求中的参数，只是POST请求的数据位于HTTP Request body中，而get请求的参数位于URL中。

非字母或数字的字符会被 percent encoded ，不适于传输binary data。

POST /test HTTP/1.1
Host: foo.example
Content-Type: application/x-www-form-urlencoded
Content-Length: 27

field1=value1&field2=value2

multipart/form-data： 

每个key-value数据都被作为一个body part，由指定delimiter分割。

可以用来传输dinary data（比如file）

POST /test HTTP/1.1 
Host: foo.example
Content-Type: multipart/form-data;boundary="boundary" 

--boundary 
Content-Disposition: form-data; name="field1" 

value1 
--boundary 
Content-Disposition: form-data; name="field2"; filename="example.txt" 

value2
--boundary--

https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST

 

2. 使用js构造http multipart/form-data请求

请求中同时发送发送json object和file
json object需要转换成blob对象，再放入FormData 对象中
var blob = new Blob([JSON.stringify({"attr1":"value1"})], {type : 'application/json'});

3.  spring @RequestParam @RequestPart @RequestBody

@RequestParam 可以用于从query parameters, form data, 和parts in multipart requests中获取参数。

即GET请求和POST（application/x-www-form-urlencoded ，multipart/form-data）请求的参数都可以使用@RequestParam

@RequestPart 用在multipart/form-data表单提交请求的方法上，支持的请求方法的方式MultipartFile，属于Spring的MultipartResolver类。

当请求方法的请求参数类型不是String 或 MultipartFile / Part时，而是复杂的请求域时，@RequestParam 依赖Converter or PropertyEditor进行数据解析， RequestPart参考 'Content-Type' header，依赖HttpMessageConverters 进行数据解析

@RequestParam适用于name-valueString类型的请求域，@RequestPart适用于复杂的请求域（像JSON，XML，File）

@RequestBody 常用来处理content-type不是默认的application/x-www-form-urlcoded编码的内容，比如说：application/json或者是application/xml等,将请求体中的数据绑定到相应的bean上。

@RequestParam和@RequestBody可以结合使用，用来同时传输string和json类型数据。

https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/web/bind/annotation/RequestPart.html

https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/web/bind/annotation/RequestParam.html

https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/web/bind/annotation/RequestBody.html

https://stackoverflow.com/questions/38262055/how-to-post-a-json-payload-to-a-requestparam-in-spring-mvc

 

4. spring boot Multipart相关配置

spring boot 中用MultipartAutoConfiguration通过为multi-part uploads进行默认配置。

可以在application.properties中配置参数spring.servlet.multipart.enabled=true/false进行控制。

如果出现spring boot项目无法解析@RequestPart注解的参数，检查spring boot中是否enabled MultipartAutoConfiguration，spring boot中是否注册有MultipartResolver。

即使enabled MultipartAutoConfiguration，如果application中已存在StandardServletMultipartResolver bean，MultipartAutoConfiguration 不会再注册新的MultipartResolver。

https://docs.spring.io/spring-boot/docs/2.1.4.RELEASE/api/org/springframework/boot/autoconfigure/web/servlet/MultipartAutoConfiguration.html