http报文的content-type参数和spring mvc传参问题

news2025/4/8 18:25:56

很早之前博主聊过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&param2=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);
    }
}

可匹取值的范围