Http中post/get请求参数接收

news2025/8/2 20:45:14

1、 Http请求报文

Http请求报文示例图如下：

①是请求方法，GET和POST是最常见的HTTP方法，除此以外还包括DELETE、HEAD、OPTIONS、PUT、TRACE。不过，当前的大多数浏览器只支持GET和POST，Spring 3.0提供了一个HiddenHttpMethodFilter，允许通过_method的表单参数指定这些特殊的HTTP方法（实际上还是通过POST提交表单）。服务端配置了HiddenHttpMethodFilter后，Spring会根据_method参数指定的值模拟出相应的HTTP方法，这样，就可以使用这些HTTP方法对处理方法进行映射了。
②为请求对应的URL地址，它和报文头的Host属性组成完整的请求URL
③是协议名称及版本号
④是HTTP的报文头，报文头包含若干个属性，格式为属性名:属性值，服务端据此获取客户端的信息

⑤是报文体，它将一个页面表单中的组件值通过param1=value1&param2=value2的键值对形式编码成一个格式化串，它承载多个请求参数的数据。不但报文体可以传递请求参数，请求URL也可以通过类似于/chapter15/user.html? param1=value1&param2=value2”的方式传递请求参数。

对照上面的请求报文，把它进一步分解，可以看到一幅更详细的结构图：

2、post/get请求

2.1、post请求

Http Header里的Content-Type一般有这三种：

multipart/form-data(一般用来上传文件)：数据被编码为一条消息，页面上的每个控件对应消息中的一个部分；

application/x-www-form-urlencoded：数据被编码为名称/值对。这是标准的编码格式。默认行为。会将表单内的数据转换拼接成key-value对（非 ASCII 码进行编码）；

text/plain：数据以纯文本形式(text/json/xml/html)进行编码，其中不含任何控件或格式字符。postman软件里标的是RAW；

2.2、get请求

GET请求不存在请求实体部分，键值对参数放置在 URL 尾部，浏览器把form数据转换成一个字串name1=value1&name2=value2...，然后把这个字串追加到url后面，用?分割，加载这个新的url。因此请求头不需要设置 Content-Type 字段，就算设置了没什么用，还是用默认的content-type来进行的: application/x-www-form-urlencoded；

非 ASCII 码会自动进行编码转换，例如发送请求：www.bilibili.com?hehe=你的我的
GET 参数的编码方式是无法人为干涉的，这导致了不同浏览器有不同的编码方式，因此最稳妥的方案是人工预编码，人工解码，从而禁止浏览器编码的干涉

2.3 post VS get

Get和Post都是Http协议的组件，所以底层都是使用tcp链接。Get的请求方式是将http的header和data一并发往服务端，也就是一条tcp数据包发送，这就会有两个问题：
数据量有限，依赖于Tcp负载能力，所以携带的数据量很大的情况下，容易造成重发。
所有的携带的数据只能接受转化成ASCII字符。

但是Post不一样，post使用两步走，先发送http的header，然后再传输data。数据类型也不受限制。而且数据隐秘性比较好。

3、后端获取请求参数

3.1、post请求

使用HttpServletRequest

@PostMapping("/uploadNetPointExcelFile")
public Result uploadNetPointExcelFile(HttpServletRequest request) {
            String userId= request.getParameter("userId");
}

使用@RequestBody 可接受的参数 Map，JSONObject，或者对应的JavaBean

//post 请求的是json字符串,@RequestBody 将字符串转为Map<>类型 
//post : {"key":"value"}
@RequestMapping(value = "/test")
public String getStart1(@RequestBody Map<String,String> map) {
    return map.toString();
}

使用@RequestParam

//这种方式只用在Content-Type=application/x-www-form-urlencoded这种情况下才能使用，sevlet将Body中的key-value转成Param。
 
@RequestMapping(value = "/getUserInfo")
public User getUserInfo(@RequestParam(value = "id",required = false) Integer id){
}

总结：post可以传递参数可以大致分成两种，
一种是表单：在sevlet实现中mutipart/form-data和application/x-www-form-urlencoded会被特殊处理，请求参数将被放置于request.paramter，解析成map，参数必须要用@RequestParam解析；

第二种是application/json，参数是存放在json中的，参数必须要用@RequestBody才能解析出来。
@RequestBody是将post请求中内容转为一个整体对象。
@RequestBody的解析有两个条件：
1.POST请求中content的值必须为json格式（存储形式可以是字符串，也可以是byte数组）；
2.@RequestBody注解的参数类型必须是完全可以接收参数值的类型，比如：Map，JSONObject，或者对应的JavaBean；

3.2、get请求

get请求方式参数是拼接在url后，所以限制了可以发送的长度。Get不支持使用http Body获取参数，他只支持params，也就是URL拼接参数

使用HttpServletRequest

@GetMapping("/downloadJoinRecord")
public void downloadJoinRecord(HttpServletRequest request, HttpServletResponse response) {
        String activityName = request.getParameter("activityName");
        String productType = request.getParameter("productType");
}

这个方法是获取整个URL的信息，然后手动获取和分离参数，和类型转化。这个里面带的内容很多，不仅Param还有Header，Cookies等。

默认方式，什么也不加，直接在方法中获取参数值

//参数多时，用对象接收
@GetMapping("/exportAnalysisNew")
public void exportAnalysisNew(GoldFingerClueReportDTO paramMap, HttpServletResponse response, HttpServletRequest request){
}

//参数少时，直接接收
@RequestMapping(value = "/getUserInfo")
public User getUserInfo(Integer id){
}
//默认情况下会从Param（就是URL后面的拼接参数）获取名字是id的项，自动转化成Integer类型，其他的类型也是类似。

利用@RequestParam

 @GetMapping("getUserName")
    public Result getTest(@RequestParam("userName") String userName){
        return userName;
    }

4、@RequestBody VS @RequestParam

4.1、@RequestBody

@RequestBody用来处理请求头Content-Type: 为 application/json编码的内容，明确的告诉服务器发送的内容是json。
因为需要读取body中内容，所以只能接受post请求。

就application/json类型的数据而言，使用注解@RequestBody可以将body里面所有的json数据传到后端，后端再进行解析。

GET请求中，因为没有HttpEntity，所以@RequestBody并不适用。

POST请求中，通过HttpEntity传递的参数，必须要在请求头中声明数据的类型Content-Type，SpringMVC通过使用HandlerAdapter 配置的HttpMessageConverters来解析HttpEntity中的数据，然后绑定到相应的bean上。

4.2 @RequestParam

@RequestParam用来处理请求头Content-Type: 为 application/x-www-form-urlencoded编码的内容。（Http协议中，如果不指定Content-Type，则默认传递的参数就是application/x-www-form-urlencoded类型）

get 方式中queryString的值，和post方式中 body data的值都会被Servlet接受到并转化到Request.getParameter()参数集中，所以@RequestParam可以获取的到。

RequestParam可以接受简单类型的属性，也可以接受对象类型。
实质是将Request.getParameter() 中的Key-Value参数Map利用Spring的转化机制ConversionService配置，转化成参数接收对象或字段。

@RequestParam有三个配置参数：

required 表示是否必须，默认为 true，必须。
defaultValue 可设置请求参数的默认值。
value 为接收url的参数名（相当于key值）。

@RequestParam也可用于其它类型的请求，例如：POST、DELETE等请求。

5、总结

form-data、x-www-form-urlencoded：不可以用@RequestBody；可以用@RequestParam
application/json：json字符串部分可以用@RequestBody；url中的?后面参数可以用@RequestParam

在GET请求中，不能使用@RequestBody。在POST请求，可以使用@RequestBody和@RequestParam；
可以使用多个@RequestParam获取数据，@RequestBody不可以；
参数在url中时，使用@PathVariable
接口规范为resultful风格时，举个例子：如果要获取某个id下此条问题答案的查询次数的话，则后台就需要动态获取参数，其注解为@PathVariable，并且requestMapping中的value应为value="/{id}/queryNum"，截图如下：