很早之前博主聊过HTTP的报文结构以及其中和传参相关的重要参数content-type还有spring mvc,以前的三篇文章:
HTTP与HTTPS协议详解:基础与安全机制-CSDN博客
详解Http的Content-Type_content-type application-CSDN博客
如何在Spring Boot中使用Spring MVC_springboot引入springmvc-CSDN博客
今天把这几部分内容合起来,从根源上聊清楚http的参数以及spring mvc的传参问题。
目录
1.content-type
2.Spring MVC传参
2.1.设计思想
2.1.零散参数
2.2.封装成实体
2.3.json
1.content-type
要聊SpringMVC的传参,就要先搞清楚HTTP报文是如何传参的。最熟悉的陌生人HTTP报文结构:
HTTP天天都在用,报文结构估计很多人其实记忆都不是很清晰。HTTP报文分为三部分:
-
请求行,记录method、URL、http协议版本。
-
请求头,以kv键值对记录一些附加消息,如cookie。
-
请求数据,也叫请求体,专门拿来装数据的的。
整个HTTP协议里约定了HTTP报文中可以用来传请求参数的地方:
-
URL
-
请求体
URL中的参数是以固定的格式表述的,比如:
http://example.com/api/data?param1=value1¶m2=value2
由于URL中的参数格式是固定的,所以请求的参数是很容易被解析出来的,无非就是以&和=这两个符号做一下分割就把参数的名称和值解析出来了。但是请求体中的参数格式是不固定的,有可能是json、有可能是xml、也有可能是二进制等等。所以要在请求头中加一个附加消息用来阐述请求体中的参数格式,这个附加信息就是——content-type。
常见的content-type类型:
-
application/json,用来声明请求体中参数是json格式。
-
application/xml 或 text/xml,用来声明请求体中参数是xml格式。
-
application/x-www-form-urlencoded,用来声明请求体中参数是URL参数格式,html表单用的就是这种格式来传参。
这里展开聊聊content-type=application/x-www-form-urlencoded,也就是html表单是如何来组织参数传递的?
<form action="/submit" method="POST" enctype="application/x-www-form-urlencoded"><label for="name">Name:</label><input type="text" id="name" name="name"><br><br><label for="email">Email:</label><input type="email" id="email" name="email"><br><br><label for="age">Age:</label><input type="number" id="age" name="age"><br><br><label for="bio">Bio:</label><textarea id="bio" name="bio"></textarea><br><br><input type="submit" value="Submit">
</form>
编码规则:
-
表单字段编码:
每个表单字段的名称和值会被编码为键值对。键和值之间用 = 连接。不同的键值对之间用 & 分隔。
-
特殊字符编码:
特殊字符(如空格、&、= 等)会被 URL 编码。例如,空格会被编码为 %20 或 +,& 会被编码为 %26,= 会被编码为 %3D。
-
请求体: 编码后的键值对会被放在 HTTP 请求体中。请求头中会包含 Content-Type: application/x-www-form-urlencoded 和 Content-Length 字段。
假设用户输入以下数据:
Name: John Doe Email: john.doe@example.com Age: 30 Bio: This is a sample bio.Name: John Doe Email: john.doe@example.com Age: 30 Bio: This is a sample bio.
在HTTP报文中数据会被组织成如下样子:
POST /submit HTTP/1.1 Host: example.com Content-Type: application/x-www-form-urlencoded Content-Length: 83 name=John+Doe&email=john.doe%40example.com&age=30&bio=This+is+a+sample+bio.
总结一下:
HTTP协议中规定了HTTP报文中只有两个地方可以传参:URL、Body。URL中的传参格式由于是固定的所不用声明解析规则,但是body中的传参格式是不固定的,所以要通过content-type去声明参数的格式。要注意的是,这和method无关,POST请求也能通过body去传参。
2.Spring MVC传参
2.1.设计思想
任何框架出现都是为了解决实际的场景问题的,Spring MVC最核心的职责是:
-
映射请求,即将请求映射到对应的处理器(controller)
-
映射参数,即将前端传过来的参数映射到处理器具体方法的参数列表中
映射参数可能会遇到哪些场景?我们其实想一想就能理出来:
-
参数是零散的,一个个的传过来的。
-
参数是个封装好的实体对象,整个实体被传过来。
无非传参就这两种情况,然后就是携带参数的位置不同,要么URL要么Body。
所以要实现的能力无非就是:
-
参数是单个的,要去URL或者Body里面去取单个参数
-
参数是实体,去URL或者Body里面取参数映射成实体
2.1.零散参数
如果后端接口参数是零散的Spring MVC会通过参数名称自动进行匹配映射,或者通过@RequestParam注解来自定义映射:
@RestController
public class TestController {@PostMapping("/testRequestParam")public void testRequestParam(String param1,@RequestParam("param2")String param2){System.out.println("param1:"+param1+"\t"+"param2:"+param2);}
}
可匹取值的范围
-
表单(body)
-
URL
表单:
URL:
结果:
也就是说@RequestParam能取到键值对类型的传参。json除外,因为json在spring mvc中是单独处理的。
2.2.封装成实体
如果后端接口参数是实体,Spring MVC会通过参数名称自动进行实体字段和前端传参的匹配映射,可匹配映射的范围
-
表单(body)
-
URL
表单:
URL:
也就是说能映射键值对类型的传参。json除外,因为json在spring mvc中是单独处理的。
2.3.json
要注意的点是,如果json是键值对里面的value,通过参数名或者@RequestParam来取值,比如这种:
但是如果直接就是个JSON,那么必须通过@RequestBody,Json只能通过这个注解来声明,后端才能接收到: