Skip to content

前言

最近在与前端联调时候,出现前端传输参数无法解析的问题,最后发现问题出在Content-type上。作为一个1年多经验的开发人员,实在不应该。所有写这篇文章,对涉及前后端参数传递的内容做一个梳理。

一、GET/POST/DELETE/PUT

1、语义上的区别

  • Get:获取数据,幂等的。
  • Post:发送数据,会创建新的内容(数据库Insert)
  • Put:发送数据,修改数据内容(数据库的Update)
  • DELETE:删除数据

2、细节上的区别

W3SCHOOL上的Get与Post的区别:

操作GETPOST
后退按钮/刷新无害数据会被重新提交(浏览器应该告知用户数据会被重新提交)。
书签可收藏为书签不可收藏为书签
缓存能被缓存不能缓存
编码类型application/x-www-form-urlencodedapplication/x-www-form-urlencoded 或 multipart/form-data。为二进制数据使用多重编码。
历史参数保留在浏览器历史中。参数不会保存在浏览器历史中。
对数据长度的限制是的。当发送数据时,GET 方法向 URL 添加数据;URL 的长度是受限制的(URL 的最大长度是 2048 个字符)。无限制。
对数据类型的限制只允许 ASCII 字符。没有限制。也允许二进制数据。
安全性与 POST 相比,GET 的安全性较差,因为所发送的数据是 URL 的一部分。在发送密码或其他敏感信息时绝不要使用 GET !POST 比 GET 更安全,因为参数不会被保存在浏览器历史或 web 服务器日志中。
可见性数据在 URL 中对所有人都是可见的。数据不会显示在 URL 中。

3、content-type

** http协议采用请求/响应模型,HTTP消息由一个起始行,一个或者多个头域,一个只是头域结束的空行和可选的消息体组成。 HTTP的头域包括通用头,请求头,响应头和实体头四个部分。content-type属于实体头部分。 get请求是将参数拼接在url上,没有content-type字段;post/put/delete 请求有content-type字段

content-type代表发送端发送的实体数据的数据类型,表示后面的文档属于什么MIME类型。

常见的content-type有:

  1. ``application/x-www-form-urlencoded` 这种就是一般的文本表单用 post 传递数据。浏览器的原生 form 表单,如果不设置 enctype 属性,那么最终就会以 application/x-www-form-urlencoded 方式提交数据。
  2. multipart/form-data ,用于文件上传,此时 form表单 的 enctype 属性必须指定为 multipart/form-data;
  3. application/json,将数据以json对象的格式传递;
  4. text/xml,XML 作为编码方式。

二、spring mvc接收参数相关注解

1、@RequestParam

@RequestParam注解用于接收url中参数,主要用于get请求。

注: 如果Post请求中将参数拼接在Url上,也可以用@RequestParam注解接收。

INFO

**对于请求:**http://example.com/api?param1=value1&param2=value2: 使用@RequestParam("param1") String param1,这将获取名为param1的请求参数的值,并将其存储在param1变量中。

2、@RequestBody

@RequestBody注解用于接收请求体的参数,通常用于content-type为application/jsonXML,主要用于Post/put/delete。 当使用@RequestBody时,Spring会尝试将请求体中的数据转换为指定的Java对象类型,以便你可以在方法中直接使用该对象。

INFO

例子: public ResponseEntity<User> createUser(@RequestBody User user),这里的User是一个自定义的Java类,用于表示请求体中的数据。

3、不加注解

不加注解的情形主要用于content-type为application/x-www-form-urlencodedmultipart/form-data 的情形,主要用于Post/put/delete。

@ContentTypex-www-form-urlencodedform-dataapplication/json
不加@RequestBody注解能接收能接收不能接收
加上@RequestBody注解不能接收不能接收能接收

💡**注意:**关于上述不加@RequestBody注解,可以接受form-data请求: 这里有一个注意事项,当springboot项目中yml不配置multipart,上述说法是可行的,但配置了multipart后,就无法解析form-data中除文本以外的属性。 暂不清楚为什么会这样

4、@PathVariable

@PathVariable 主要用于将 URL 中占位符参数绑定到控制器处理方法的入参中。

java

   /**
     * 例:
	 * localhost:8080/pathVariable/1
	 * 这些URL 都会 执行此方法 并且将 1 作为参数传递到id字段
	 * @param id
	 * @return
	 */
	@RequestMapping("/pathVariable/{id}")
	public String pathVariable(@PathVariable("id") String id){
		return id;
    }

总结

  • get/post/delete/put本质上都是基于http协议,区别主要在与报文格式上。
  • content-type代表发送端发送的实体数据的数据类型,常见的有multipart/form-dataapplication/x-www-form-urlencoded、``application/jsontext/xml`
  • @RequestParam、@RequestBody等注解接收参数主要是根据url和content-type,和请求方法无关。例如:@RequestParam也可以用于POST请求。

参考都 2019 年了,还问 GET 和 POST 的区别灵活运用的@RequestParam和@RequestBody前后端联调之Form Data与Request Payload,你真的了解吗?Spring中的@RequestBody注解与常规的HTTP方法的传值方式